# Animations
## Opening the animations editor
Create a new "`ItemsAdder Entity Model`".\
You can create as many as animations files you want.
Decide if you want to create an emotes file with examples or a blank emotes file.
Decide a name for your emotes pack.
You can notice a lot of example animations on the left.
Delete all the emotes and edit/rename the ones you want.\
They are useful only as base for your new emotes, to have an example to learn from.
You can animate your models normally, like you would do with normal Blockbench models.\
You can find a lot of tutorials on YouTube.
{% embed url="" %}
When you are finished, save your `.iaentitymodel` project file into this folder (change `my_emotes` to your namespace, this one is an example):\
`ItemsAdder/contents/my_emotes/`
Then continue following the tutorial to know how to export the emotes into ItemsAdder.
### Apply the changes to ItemsAdder
Click on the **ItemsAdder** tab and press **Export**.
You should get a success message.
{% hint style="success" %}
If you didn't add any custom model into your emote there is no need to use `/iazip`!\
Use the command `/iareload` to load the new animation in the game.
{% endhint %}
## Playing the animations
Use the emote command: `/iaemote [player]` or `/emote [player]`
## Emote permission
Use the `/iaemote` command: `ia.user.iaemote`
Use an emote: `ia.user.iaemote.use.`\
Example: `ia.user.iaemote.use.yes`
### More info about permissions
{% content-ref url="../../plugin-usage/plugin-configuration/permissions" %}
[permissions](https://itemsadder.devs.beer/plugin-usage/plugin-configuration/permissions)
{% endcontent-ref %}
### Showcase of some examples
{% embed url="" %}
{% embed url="" fullWidth="false" %}
### Here you can download an example project:
{% embed url="" %}
You can add custom models to your emotes, for example: items, monsters, furniture, animated effects.
### Important
{% hint style="warning" %}
* DO NOT delete any built-in player bone.
* DO NOT resize any built-in player bone, it simply won't work ingame.
* Edit built-in player bones only in the animation view (rotate, move).
* You can hide the built-in player bones using scale to `0,0,0`. Set to `1,1,1` to show them again.
{% endhint %}
### Different type of emotes
* `.player_advanced_animations` file format is now used to identify player animations which also add custom models to the emote.
* `.player_animations` are the player animations which don't add any custom model but will be loaded into the default player model.
In order to decide that you have to set this option in the **Blockbench** extension settings.
[](https://user-images.githubusercontent.com/27242001/244145963-c9ca9a77-bb79-4804-92e4-8708eac41517.png)
### Importing elements into the scene
You can import any `.bbmodel` into the scene and use it in your animation.\
You can also import extruded textures to show items dynamically.
### Hiding unused elements in other animations of the game `.iaentitymodel` emotes file
1. select the animation
2. select the element you want to hide for a particular animation
3. move to the first frame of the animation, using the timeline
4. create a new scale key, make sure to set it to the first keyframe
5. set scale to 0
Now your model won't be shown for this particular animation.\
You can show/hide it in the middle of the animation just by doing the same thing but setting scale to 1.
## Lock the player movement
You can specify if the player can move while playing one specific animation or not.
## Looping animations
You can create animations which would play `start` -> `loop` -> `end` sub-animation.\
This allows you to create complex looping animations, for example a sleep animation where your player would lay and stay there until the player presses SHIFT.
### Step 1
Create the animation, in this example a death animation.
Right click it and mark it as `Loop`.
### Step 2
Now place the cursor on the frame where you want the loop to start, in this case when the player is on the ground.
### Step 3
Click on the `Add Loop Start/End marker` icon to add a `start loop` marker.
Now place the animation cursor on the frame where you want the loop to stop and press again on the `Add Loop Start/End marker` icon.
The result will be like this:
