batihandev/unity-mcp-skills/animator

Unity Animator Skills

Overview

Control Unity's animation system - create controllers, manage parameters, and control playback.

Common Mistakes

DO NOT (common hallucinations):

• animator_create_clip / animator_add_clip do not exist → AnimationClips are created via Unity Editor or asset import
• animator_set_speed does not exist → use component_set_property on Animator component with propertyName="speed"

Routing:

• For Timeline animation → use timeline module
• For component properties on Animator → use component module
• For animation import settings → use importer module

Skills Overview

Parameter Types

Skills

animator_create_controller

Create a new Animator Controller.

Returns: {success, name, path}

animator_add_parameter

Add a parameter to a controller.

animator_get_parameters

Get all parameters from a controller.

Returns: {success, parameters: [{name, type, defaultFloat/defaultBool/...}]}

animator_set_parameter

Set a parameter value at runtime.

*Use the appropriate value for paramType (trigger doesn't need a value)

animator_play

Play a specific animation state.

animator_get_info

Get Animator component information.

Returns: {gameObject, instanceId, hasController, controllerPath, speed, applyRootMotion, updateMode, cullingMode, layerCount, parameterCount}

animator_assign_controller

Assign a controller to a GameObject.

animator_list_states

List all states in a controller layer.

Returns: {success, states: [{name, tag, speed}]}

animator_add_state

Add a state to an Animator Controller layer.

Returns: {success, controller, stateName, layer}

animator_add_transition

Add a transition between two states in an Animator Controller.

Returns: {success, from, to, layer, hasExitTime, duration}

Recipe Path

Recipe path rule: ../../recipes/animator/<command>.md

See ../../recipes/animator/README.md for the full command index.

Best Practices

1. Create controller before adding parameters
2. Use meaningful parameter names
3. Triggers reset automatically after firing
4. Set parameters before playing states
5. Use layers for independent animations (body + face)
6. States must exist in controller before playing