Using the AnimationTree StateMachine
A common situation: you have a large number of animations, and it’s becoming difficult to manage transitions between them. Your code has become full of
if statements, and every time you change something, it all breaks.
AnimationTree to create an animation state machine. This will allow us to organize our animations and most importantly, control the transitions between them.
For this demo, we’ll be using the excellent “Adventurer” sprite by Elthen. You can get this and lots of other great art at https://elthen.itch.io/.
We’ll also assume you’ve already set up the character’s animations using
AnimationPlayer. Using the above spritesheet, we have the following animations: “idle”, “run”, “attack1”, “attack2”, “hurt”, and “die”.
AnimationTree node to the scene. In its Tree Root property, choose “New AnimationNodeStateMachine”.
AnimationTree is a node that controls animations created in
AnimationPlayer. To let it access the existing animations, click “Assign” in the Anim Player property and select your animation node.
Now we can begin to set up our state machine in the
Note the warning. Set the Active property to “On” in the Inspector.
Right-click and choose “Add Animation”. Choose “idle”, and you’ll see a small box representing that animation. Press its “Play” button and you should see the animation play. Do the same to add boxes for the other animations.
Now we can add connections. Click the “Connect nodes” button and drag between nodes to connect them. As an example, let’s use the two attack animations:
When you select an animation, the tree will follow the connected path from the current node to the destination. However, in the configuration above, if you play “attack2” you won’t see “attack1” along the way. That’s because the default “switch mode” for a connection is “Immediate”. Click the “Move/select” button and then click on the connection between “attack1” and “attack2”. In the Inspector, change Switch Mode to “At End”. Do the same with “attack2” to “idle”. The connection icon changes from to .
Now, with “idle” playing, if you click “attack2”, you’ll see the two attacks play in sequence.
But now the animation stops on “attack2”. On its connection, set the Advance/Mode property to “Auto”. This will make the tree go back to “idle” after playing both animations. Note that the connection icon turns green to show this.
Now the animations are played in sequence whenever they’re triggered.
Calling states in code
Here is the full tree for all of the animations:
Now let’s set up the character to use these animations in a script.
extends CharacterBody2D var state_machine var run_speed = 80.0 var attacks = ["attack1", "attack2"] @onready var state_machine = $AnimationTree["parameters/playback"]
state_machine holds a reference to the state machine, which is an
AnimationNodeStateMachinePlayback. To call a specific animation, you use
travel(), which will follow the connections to the given animation.
func hurt(): state_machine.travel("hurt") func die(): state_machine.travel("die") set_physics_process(false)
Here we have examples of functions we would call if the player is hurt or killed. For the other animations (running, attacking, etc.), we’ll need to combine them with our input and movement code.
velocity determines whether we should be showing “run” or “idle”.
func get_input(): var current = state_machine.get_current_node() velocity = Input.get_vector("move_left", "move_right", "move_up", "move_down") * run_speed if Input.is_action_just_pressed("attack"): state_machine.travel(attacks.pick_random()) return # flip the character sprite left/right if velocity.x != 0: $Sprite2D.scale.x = sign(velocity.x) # choose animation if velocity.length() > 0: state_machine.travel("run") else: state_machine.travel("idle") move_and_slide()
Note that we’re using
return after traveling to the attack animations. This is so that we won’t instead travel to the “run” or “idle” animations further down in the function.
You can use the AnimationTreeStateMachine to handle
Download This Project
Download the project’s example code here: https://github.com/godotrecipes/ai_behavior_demos