# Locomotion
## Overview
The Locomotion State [**ID** ](https://malbersanimations.gitbook.io/animal-controller/scriptable-architecture/scriptables/scriptable-ids#states-ids)is **1.** It allows the animal to move while it's on any ground surface
## How it works
When the character moves it uses the `MAnimal.Move(Vector 3 Direction)`method, this will activate the locomotion animations.
## Creating the State
To create a new Locomotion State, click the Plus button on the States list and select: \[Locomotion]
Or duplicate any of the already created locomotion assets of any animal you own and drag it to the States List.
## Priority
Locomotion should always be on top of the Idle and below all other assets.
## Requirement
The Idle State does not require extra gameobjects, pivots, or internal animal configuration. Just an animation or animations to be used as Idles.
## Activation Condition
* The Animal has detected any movement. (Movement Detected = true)
* The Animal is grounded. (Grounded = true)
You can always Force its activation via code.
**`Animal.State_Force(1)` or `Animal.State_Force(StateEnum.1)`**
## Exit Conditions
Through code, the exit conditions will be executed to check if the State can exit. In the case of this state, the **conditions** are:
* The Animal has **NOT** detected any movement. (Movement Detected = false)
## Animator
### Locomotion Sub-State Machine
The Sub-State Machine \[Locomotion] will hold all the Locomotion Animations.
Its entering transition conditions are:
### Core Animations
All States have a core animation, on which the animal will play while the state is active. In the case of locomotion, a blend tree is required with all the speeds the character may have,
The core animations must be always tagged just like the Name of the State ID.
The multiplier parameter is linked to the SpeedMultiplier. This handles the speed of the animation with the **Speed Modifiers.**
### Exit Condition
The Locomotion will exit only when there is no movement registered.
## Locomotion Features
### Fall Ray Backwards
### Reset Inertia
### Wall Stop
#### Stop Layer:
Layer used in the raycast to check front Walls and stop the character from moving.
#### Wall Stop Properties
{% embed url="" %}
### Anti Fall
Antifall allows the animal to avoid ledges. This is used mainly for huge animals that does not have the Fall State and it should avoid falling from edges at all times. E.g. The elephant
### Locomotion Start Tag
When you set a new Tag and Use it on the Enter Tag Parameter, the **Vertical parameter on the animator** will be set with no smoothness to the Speed Vertical value. E.g. If we are entering from Idle To locomotion in a Run Speed, the Vertical will be set to 3 directly. This is used to play IdleToRun animations correctly.
