Impact Main Page API Reference Change Logs
Installation
Impact Tags Impact Tag Library Using Impact Tags
Impact Manager Material Mapping
Impact Materials Impact Material Interaction Sets
Impact Interactions Audio Interactions Particle Interactions Decal Interactions Decal Management
Impact Objects Impact Object Single Material Impact Object Rigidbody Rigidbodies With Multiple Materials Impact Object Rigidbody (Cheap) Impact Terrain
Impact Triggers Physics Triggers Impact Collision Trigger Impact Velocity Collision Trigger Impact Slide and Roll Trigger Impact Simple Collision Trigger Impact Speculative Collision Trigger Impact Particle Collision Trigger Impact On Trigger Enter Impact On Trigger Stay Other Triggers Impact Raycast Trigger
Extending Impact Custom Impact Triggers Interaction Data Custom Impact Interactions Impact Interactions Interaction Results IInteractionResult IContinuousInteractionResult Custom Impact Objects Custom Impact Materials Custom Impact Tag Libraries
FMOD Integration Setup FMOD Audio Interaction FMOD Parameters Notes
Wwise Integration Setup Wwise Audio Interaction Wwise RTPCs Notes
Master Audio Integration Setup Master Audio Interaction Notes

Change Logs

1.9.6

(13/03/2023)

Features

  • Added Contact Point Mode to OnTriggerEnter and OnTriggerStay triggers, allowing you to specify which object's position should be used as the contact point.

1.9.5

(16/08/2022)

Changes

  • ImpactTriggerBase now implements the IImpactTrigger interface. This allows you to get all Impact Trigger components attached to an object, which was previously not possible due to ImpactTriggerBase being a generic class.

1.9.4

(29/07/2022)

Changes

  • Reworked Terrain Data null-checking. Errors are no longer thrown on Awake if no Terrain Data is present.
  • Improved null checks when getting Impact Materials from Impact Objects.

1.9.3

(13/05/2022)

Changes

  • Impact components now allow for getting data in the editor using non-cached data.
  • ImpactAOTWorkaround class for projects using IL2CPP is now included by default.
  • Rigidbody wrapper now assigns Unknown physics type if no rigidbody is found.

1.9.2

(17/03/2022)

Changes

  • Improved undo/redo capabilities of Impact Material editor.

Bug Fixes

  • Fixed drag-and-drop for collision audio clips not marking the asset as dirty, and so not saving changes properly.

1.9.1

(20/01/2022)

Bug Fixes

  • Fixed potential ambiguity between Impact.Utility.Range and System.Range.

1.9.0

(10/01/2022)

Features

  • Added Impact Decal Manager component to improve manageability of decals attached to objects.
  • Added static function ReturnAllDecalsToPools to ImpactDecalPool that will release all decals from the objects they are attached to and return them to the pool.
  • Added static events to all interaction results that are invoked when the interaction result is processed.

Changes

  • Decal pools now scan themselves for missing objects on scene load and will re-instantiate missing objects. This is needed because decals that have been parented to objects cannot be returned to the pool when those objects are destroyed when the scene unloads.

1.8.0

(10/12/2021)

Features

  • Added ImpactOnTriggerEnter and ImpactOnTriggerStay triggers that will trigger interactions from OnTriggerEnter and OnTriggerStay messages respectively.
  • Simple triggers now use their Impact Object's velocity, rather than having no velocity data.

Changes

  • Minimum Unity version is now 2019.4 as per Asset Store guidelines.
  • Improved performance of PhysicsUtilities.CalculateTangentialVelocity.
  • Deprecated the "Simple" Interaction Type.

Bug Fixes

  • Fixed incorrect labels on Particle Interaction assets.
  • Fixed possible index out of range errors when getting Impact Materials at the edge of a terrain.

Notes

  • The FMOD, WWise, and MasterAudio integration packages have been updated to remove the obsolete "Simple" interaction type. Make sure to download the latest version if you are using these packages.

1.7.3

(24/11/2021)

Changes

  • Impact Audio Interaction Collision Audio Clips now use a reorderable list for easy reordering.
  • Cleaned up editor scripts to better support undo/redo.
  • Exposed the previously private Trigger methods of ImpactRaycastTrigger class.

Bug Fixes

  • Fixed sliding and rolling not respecting the original volume and pitch of the Audio Source Template.

1.7.2

(14/10/2021)

Bug Fixes

  • Fixed Simple Collision Triggers not working properly.

1.7.1

(27/09/2021)

Bug Fixes

  • Fixed Impact Material editor not properly saving changes to interaction sets.
  • Fixed Impact Particle Interaction and Impact Decal Interaction editors overly restricting the allowed prefab types.

1.7.0

(12/08/2021)

Features

  • Added Rotation Mode and Axis options to Impact Particles for more control over how they are aligned with the surface.

Bug Fixes

  • Fixed incorrect collider usage when creating 2D Impact Contact Points.
  • Fixed possible ambiguity between Impact.Utilities.Range and System.Range.
  • Fixed possible null reference error when object pools are destroyed.

1.6.0

(09/07/2021)

Features

  • Added Impact Object Rigidbody (Cheap) component that can be used instead of the normal Impact Object Rigidbody. This version does not use FixedUpdate at the cost of slightly less accurate interactions, particularly when sliding and rolling.
  • Added Pool Fallback Mode property to interaction template objects. This specifies how the object pool should handle cases when all objects are in use.

Changes

  • Refactored internal pooling system to accomodate for Pool Fallback Mode option.

1.5.0

(22/04/2021)

Changes

  • The Audio Source Template property of Audio Interactions has been changed. See below changes for details.
  • Changed Impact Audio Pool implementation. Each audio source template now has it's own pool, similarly to the Particle and Decal interaction pools.
  • Audio Interactions now require a component that inherits ImpactAudioSourceBase to be on the Audio Source Template prefab.
  • Added Pool Size property to Impact Audio Source.
  • Removed Default Audio Pool Size property from the Impact Manager.
  • Improved handling and logging of missing dependencies on Impact components.

Bug Fixes

  • Impact Object Single Material now does a null-check on the Material on Awake.

Upgrading to 1.5.0

Version 1.5.0 changes the way the built-in Audio Interactions use their Audio Source Template prefab (Click here to learn more). These prefabs now require an Impact Audio Source component, which unfortunately will break the references on your Audio Interactions. A tool has been included in the 1.5.0 release that will attempt to automatically fix all broken references and add the Impact Audio Source component to your audio source templates. Go to Assets > Impact > Fix Audio Source Template References to run this tool, but make sure you have a backup!

Also, if you have pre-made Impact Audio Pool object in your scenes, make sure you delete them, or you will see errors when it they are destroyed on scene load or play mode exit.

1.4.1

(08/03/2021)

Changes

  • Built-in trigger base classes no longer specify IImpactCollisionWrapper and IImpactContactPoint types for ImpactTriggerBase, allowing you to inherit from them and specify your own types.

Bug Fixes

  • Fixed Particle and Velocity triggers calculating interaction velocity backwards.

1.4.0

(01/03/2021)

Features

  • Added new Velocity Collision Trigger. This trigger works similarly to the normal Collision Trigger, however it takes into account the actual change in velocity experienced by the rigidbody. This can produce better results when objects of significantly different masses collide. The object with a higher mass will have less velocity change and so will produce a less intense collision, the object with a lower mass will produce a more intense collision.
  • Added Rotation Mode property to Impact Decals.
  • Added Axis property to Impact Decals.
  • Added Version.txt for showing the currently installed version.

Changes

  • Removed Interaction Result Pool Size from Impact Manager. These pools are now dynamically sized as needed.
  • Removed GetKey function from IInteractionData interface.
  • Updated how interaction result keys are generated to reduce likelyhood of collisions.
  • ImpactTriggerBase now has IImpactCollisionWrapper and IImpactContactPoint type constraints at the class level, rather than on the individual methods.

Bug Fixes

  • Fixed Impact Material returning prematurely in some cases, meaning not all interaction results would be returned.
  • Fixed Impact Audio Source not copying spatialize and spatializePostEffects properties from the template.

If using the FMOD or WWise integration packages, make sure to download the latest version of the package.

1.3.1

(22/12/2020)

Bug Fixes

  • Fixed Impact Manager using Physic Material map instead of Physics Material 2D map when initializing material mapping.
  • Fixed Impact Materials not being marked as dirty when modifying interactions, causing changes to sometimes not be saved.

1.3.0

(14/12/2020)

Features

  • Created custom dropdown for Tag selection, which includes search capability.
  • Added OnTriggered event to ImpactTriggerBase and its implementations, which can be used to receive events when a trigger is triggered.

Changes

  • Interaction result objects are now pooled by the Impact Manager. The size of the pools is controlled by the Interaction Result Pool Size property.
  • ImpactManager.HasReachedPhysicsInteractionsLimit no longer increments the physics interactions counter. Added separate IncrementPhysicsInteractionsLimit method to do this instead.
  • Removed null check from ImpactManagerInstance.GetInstance and replaced with boolean to improve performance.
  • IInteractionResult interface no longer requires OriginalData property.
  • IContinuousInteractionResult.KeepAlive now takes an IInteractionResult object as a parameter instead of IInteractionData.
  • Key property for IContinuousInteractionResult is now a long instead of an int.
  • Improved Particle Collision Trigger to respect material mapping and have more accurate collision velocity.
  • Removed Contact Mode property from Particle Collision Trigger inspector since it is not used.
  • Built-in interactions now check intensity before creating an Interaction Result, saving wasted processing time.
  • Built-in interactions now check if the active continuous interactions limit has been reached before processing, saving wasted processing time.
  • Modified IImpactCollisionWrapper interface to be generic, now requiring an IImpactContactPoint implementation to be specified.
  • Modified methods of ImpactTriggerBase that take IImpactCollisionWrapper and IImpactContactPoint parameters to be generic, which prevents GC allocation of structs that implement an interface.
  • Changed InteractionData to struct.
  • All methods that took an IInteractionData parameter are now generic, which prevents GC allocation of structs that implement an interface.
  • Various improvements to utility functions to clean up redundant code and improve performance.

Bug Fixes

  • Fixed issues with tag selection when tags are not defined in a continuous sequence (i.e. numbers are skipped).

1.2.2

(11/11/2020)

Changes

  • Range.Normalize now will return 1 if the Min, Max, and input values are all equal.

Bug Fixes

  • Impact Manager now disposes of any active continuous interactions when it is destroyed.

1.2.1

(21/08/2020)

Bug Fixes

  • Fixed Speculative Collision Trigger error caused by using the wrong value for contacts index.

1.2.0

(19/08/2020)

Features

  • Added Set As Active Instance property to Impact Manager.
  • Added Enabled property to all physics triggers.
  • Added Multiple contact mode.
  • Added Contact Point Comparison property to Impact Speculative Collision Trigger.
  • Added Contact Point Lifetime property to Impact Speculative Collision Trigger.

Changes

  • Improved ImpactManager instance handling.
    • Created instance members in ImpactManager to mirror the static members.
    • Moved all static members previously on ImpactManager to new ImpactManagerInstance static class.
    • Added SetInstance and GetInstance methods to ImpactManagerInstance for setting and getting the currently active ImpactManager instance.
  • Changed how the Impact Speculative Collision Trigger compares contacts from rounding to comparing sqrMagnitude.
  • Impact Speculative Collision Trigger now also uses OnCollisionEnter message so that collision messages are handled more consistently.
  • Changed SpeculativeCollisionContact class to a struct.

Bug Fixes

  • Fixed Single Average contact mode not copying Physics Material IDs from the original contact points needed for Material Mapping.
  • Removed the Contact Mode property from the Impact Speculative Collision Trigger inspector since it is not actually used.

1.1.2

(20/07/2020)

Changes

  • Impact Terrain now better handles Material Composition:
    • Results are now returned sorted from highest to lowest Composition Value.
    • Terrain layers with the same Impact Material are now combined into a single result.
    • When the number of terrain layers is greater than the Material Composition Buffer Size, the most prevalent materials will be returned, and the sum of their Composition Values will be (close to) 1.

Bug Fixes

  • Fixed various issues with Impact Raycast Trigger methods.

1.1.1

(25/06/2020)

Changes

  • Made active continuous interactions array no longer static.
  • Improved handling of multiple Impact Manager instances. A warning will be logged to the console and duplicate Impact Managers will be disabled.

Bug Fixes

  • Fixed continuous interactions being processed when the active continuous interactions array is full, which would cause them to never be updated or disposed of. Continuous interactions will no longer be processed if the active continuous interactions array is full.

1.1.0

(12/06/2020)

Features

  • Added Impact Manager script.
    • Added Default Audio Pool Size property.
    • Added Physics Interactions Limit property.
    • Added Interaction Result Buffer Size property.
    • Added Max Active Continuous Interactions property.
    • Added Material Composition Buffer Size property.
    • Added ability to map Unity's physics materials (both 3D and 2D) to Impact Materials.
  • The built-in physics triggers now check Physics Interactions Limit when a collision message is recieved. If the limit has been reached further processing will be aborted.
  • Added High Priority property to ImpactTriggerBase for overrding Physics Interactions Limit.
  • Added Contacts Mode property to ImpactTriggerBase with Single and Single Averaged options.
  • Added ImpactObjectRigidbodyChild component that can be used for rigidbodies with multiple materials and has less overhead than ImpactObjectRigidbody.
  • Added more ImpactRaycastTrigger methods (including methods for 2D raycasting).

Changes

  • Changed string InteractionKeywords property to int InteractionType on IInteractionData interface to increase performance.
  • Changed GetKey function on IInteractionData interface to return an int to eliminate string concatenation and increase performance.
  • Added useMaterialComposition parameter to existing ImpactRaycastTrigger methods.
  • Removed ImpactTriggerInteractionData class and renamed buildAndSendInteractionData to buildInteractionData on ImpactTriggerBase. buildInteractionData now takes all parameters separately instead of as a class to reduce GC allocation.
  • Removed continuous interaction handling and FixedUpdate from ImpactObjectBase. This is now part of ImpactManager.
  • Removed ProcessInteraction and ProccessContinuousInteraction from IImpactObject interface. These methods are now a part of ImpactManager.
  • Removed interaction result buffer array from ImpactObjectBase. This is now a shared static array on ImpactManager.
  • Removed material composition result buffer array from ImpactTriggerBase. This is now a shared static array on ImpactManager.
  • Refactored ImpactRigidbodyWrapper to include center of mass, velocity, and angular velocity code that was previously in ImpactObjectRigidbody.

Bug Fixes

  • Fixed cached material composition not being updated on ImpactObjectSingleMaterial when the Material property is changed at runtime.
  • Fixed IndexOutOfRange exception when assigning a tag library with no tags to a material.