add_anim_state
Add a state node to a state machine inside an Animation Blueprint to define animation states and confirm whether it was created or already existed.
Instructions
Add a state node to a state machine inside an Animation Blueprint.
Returns: { anim_blueprint_path: string, machine_name: string, state_name: string, node_class: string, state_created: bool, already_existed: bool, saved: bool, state_count: int, save_error?: string }
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | Optional. This command is REFUSED while a Play-in-Editor session is running: it either compiles a Blueprint (the reinstancer can retain a world, and CheckForWorldGCLeaks is Fatal -- it KILLS the editor) or writes to disk (Editor.AllowSavingAssetsDuringPIE=0 makes the engine refuse the write, so it would report success without writing a byte). Stop PIE and retry instead; force=true runs it anyway, at your own risk. | |
| state_name | Yes | Name for the new state | |
| machine_name | Yes | Name of the target state machine | |
| blueprint_name | No | Alias of `anim_blueprint_path` (same value, same meaning). Accepted because sibling tools spell this parameter differently; prefer `anim_blueprint_path`. | |
| anim_blueprint_path | No | Path to the UAnimBlueprint asset |