Animancer v3.1

Released 2019-08-12

When upgrading to a newer version of Animancer, you must delete any previous version from your project first. This is mandatory since Unity's package importer system doesn't delete or rename existing files so any old scripts that aren't directly overwritten will cause compile errors that prevent anything from working.


  • Added several new examples:
    • Root Motion demonstrates how to use serializables to determine whether each animation should use root motion or not.
    • [Pro-Only] Hybrid demonstrates how to use a default Animator Controller for some things and individual separate AnimationClips for others.
    • [Pro-Only] 3D Game Kit demonstrates how to translate the player Animator Controller based character from the 3D Game Kit to use Animancer.
  • [Pro-Only] Added HybridAnimancerComponent for managing a main Animator Controller alongside the regular Animancer functionality.
  • Added AnimancerUtilities.EditModePlay to easily play animations in Edit Mode and used it in the Directional Sprites examples to show the correct sprite for the assigned animation sets.
  • [Pro-Only] Moved AnimancerState.Speed into AnimancerNode so layers can have a custom speed too.
    • It now uses a private field to cache its value instead of retrieving it from the Playable, giving a slight performance increase.
  • [Pro-Only] Added AnimancerPlayable.Speed.
  • Moved AnimancerState.IsPlaying and related functionality to AnimancerNode so layers can be paused in the same way.
  • Added an implicit cast from AnimancerLayer to int so you can pass a layer reference into Play/CrossFade methods.
  • Added AnimancerComponent.Dispose methods that take a key so the caller doesn't need to get and null check a state before calling AnimancerState.Dispose.
  • Added constructors and implicit casts to ControllerState.Serializables.
  • Added AnimationClip/Toggle Looping Context Menu Function.
  • [Pro-Only] Unsealed AnimancerState.Stop so ControllerState can override it to reset itself to its default state. If you do not want this behaviour, you can set its DefaultStateHashes = null.


  • Reorganised the examples:
    • Changed the Layers example to use a tennis animation instead of golf so it actually makes sense to play it while running.
    • Organised all examples into sub-namespaces.
    • Removed unnecessary prefixes from classes in the State Machines examples.
    • Changed example scripts to put the [SerializeField] attribute on the same line as its field.
    • Reorganised the example art assets to put all Humanoid Animations in one folder and Props in another.
  • Replaced WelcomeWindow with ReadMe (a ScriptableObject instead of an EditorWindow).
  • Renamed AnimancerLayer.IsPlaying() to IsAnyStatePlaying.
  • AnimancerNode.IsPlaying is no longer virtual.
  • MixerState now has a dedicated method for SetChildrenTime instead of overriding the Time property because NormalizedTime would not have worked properly.
  • Renamed AnimancerPlayable.KeepPlayablesConnected to KeepChildrenConnected.
  • Replaced EventfulAnimancerComponent with SimpleEventReceiver which isn't an AnimancerComponent.
  • Changed the ControllerState.Drawer to show the time of the current state instead of the playable's overall time (which was basically useless).
  • Renamed AnimancerPlayable.CreatePlayable to Create and moved the graph name parameter out to an Editor-Conditional SetNextGraphName method so the caller doesn't access the unnecessarily or use any #ifs.
  • AnimancerComponent no longer sets the Animator.enabled = true every time an animation is played. Anything that disables the Animator will be responsible for re-enabling it.
  • Changed InputBuffer to allow a state to re-enter itself.
  • Removed Documentation and Support context menu functions from AnimancerComponent to avoid cluttering the menu.


  • Improved the AnimancerComponent Inspector:
    • Added the ability to Ctrl + Shift + Click on states in the Inspector to queue them to Cross Fade in a sequence (Ctrl + Click normally Cross Fades the state immediately). Also available as a context menu function.
    • Ctrl + Click on an animation while the graph is paused will now Play and Evaluate it immediately.
    • You can now drag and drop animations anywhere in the AnimancerComponent Inspector to create states for them.
    • You can now assign a new AnimationClip to a state using the Inspector.
    • Added the ability to middle click on Inspector fields to reset them to their default value.
    • The context menu function to open the Playable Graph Visualizer will now be disabled when the visualizer is not present instead of not being shown at all.
    • NamedAnimancerComponentEditor now draws the default animation on the same line as the Play Automatically toggle.
    • By default, all Inspector labels will have spaces removed if the window isn't in wide mode so they are less likely to get truncated.
  • Added a setter for AnimancerPlayable.IsGraphPlaying.
  • Added IPlayableWrapper interface to use for AnimancerNode.Parent so layers and states do not need separate hierarchy code.
  • Added AnimancerNodeDrawer as a common parent for AnimancerStateDrawer and AnimancerLayerDrawer.
  • Improved the error message for IK in Unity versions that do not support it.
  • Grouped most string constants into a Strings class.
  • Cleaned up unnecessary #pragma warning disables.
  • Added AnimancerEditorUtilities.TempContent(SerializedProperty) to use the display name and tooltip of a property.


  • Inspector fixes:
    • Fixed changing fade details in the Inspector to actually start fading properly.
    • ScriptableObjectEditor now only targets specific Animancer classes by default instead of all ScriptableObjects (it was causing a conflict with Inspector Gadgets). You can uncomment the #define ANIMANCER_SCRIPTABLE_OBJECT_EDITOR to have it apply to everything if you want (or define that symbol in your project settings).
    • Fixed the weight label display to go between white and grey in the dark theme (instead of black to grey).
    • Fixed indentation of ClipState.Serializable.StartTime.
    • Fixed a layout bug in NamedAnimancerComponentEditor.
    • Fixed NamedAnimancerComponent.OnValidate to not remove null elements from the Animations array because it was immediately removing any newly added elements when you click the + button or increase the size.
    • [Pro-Only] Fixed ControllerState.Drawer to work properly with parameters and to only show them when expanded.
  • Fixed ClipState.Clip and ControllerState.Controller setters to dirty the weight of the new Playable.
  • Fixed a bug in InputBuffer.TrySetState which caused it to attempt to enter the previously buffered state instead of the new one.
  • Fixed exceptions caused when an AnimancerNode has no parent.
  • Fixed the GolfHitController example script to be reusable if it is disabled and re-enabled.
  • Changed the Sequence Coroutine example to use a TextMesh so it doesn't need to reference the UI assembly (was causing problems in the Unity 2019.2 Beta).