{{tag>animation part}}

===== Animation =====
<grid>
<col xss="12" xs="12" sm="9" md="9" lg="9">
== Description == 
<block indent> The animation part allows you to play in-game animations on your playermodel or ragdolls. If you're looking for custom animations see [[:part:custom-animation]].
</block>

== Location == 
<block indent> This part can be found under: 
  * :entity: **Entity** > [[part:animation:]]
  * :model: **Model** > [[part:animation:]]
  * :poseparameter: **Modifiers** > [[part:animation:]]
</block>

<block tip>
== Tip ==
You can easily find it by clicking on the {{:icon:editor:add.png?nolink|}} sign and typing //**projectile**//.
</block>

== Notes ==
  * When [[#rate]] is set above **1**, [[#ping pong loop]] is disabled, this also causes some weird desync which can be fixed with [[#owner cycle]].
  * [[#Rate]] set to **1** + [[#owner cycle]] disables animation looping.
  * [[#Owner cycle]] disables all the other options except for [[#rate]].
  * Setting the [[#min]] value above [[#max]] breaks the animation part, you might have to re-add it.
  * The [[part:legacy_entity#animation rate]] on the [[part:legacy_entity]] part also affects animation rate.

----
</col>
<col xss="12" xs="12" sm="3" md="3" lg="3">
{{  :tutorial:part_thumbnails:animation.mp4}}
</col>
</grid>

==== Basic usage: ====
  - Add the [[part:animation:]] part to your entity or a ragdoll.
  - Select the animation that you want to play by clicking **''...''** next to **[[#sequence name]]**.
  - Tweak the settings to your liking.

----

==== Related commands: ====

|pac_enable_animation| 1/0 (1) | Enables/Disables the animation part. |

----
==== Properties ====
<tabs>
  * [[#tab-list|List View]]
  * [[#tab-table|Table View]]
 
<pane id="tab-list">
===Generic===
<block box in>
== loop ==
Doesn't seem to do anything. (label_broken?) (label_moreinfo).
</block>

<block box in>
== ping pong loop ==
Instead of going back to frame 1 when starting a new loop, inverts the animations and plays it from end to start.
</block>

<block box in>
== sequence name ==
The animation sequence that you want to play.
</block>

<block box in>
== rate ==
The animation rate. Default is **1**. Changing this duplicates outfit parts/creates desync, which can be fixed with [[#owner cycle]]. (label_broken?)
</block>

<block box in>
== offset ==
Offsets the animation.
</block>

<block box in>
== min ==
Controls the start frame of the animation where **0** is the first frame and **1** is the last frame. Values below **0** add delay before the animation starts. Setting this above [[#max]] completely breaks the part.
</block>

<block box in>
== max ==
Controls the end frame of the animation where **0** is the first frame and **1** is the last frame. Values above **1** add delay after the animation ends (before starting the next loop).
</block>

<block box in>
== weapon hold type ==
(label_moreinfo)
</block>

<block box in>
== owner cycle ==
Matches the owners animation cycle. This disables all other settings except for [[#rate]].
</block>

<block box in>
== invert frames ==
Inverts the animation.
</block>

<block box in>
== reset on hide ==
Resets the animation when hidden.
</block>

<block box in>
== name ==
The name of this part. Keep this unique.
</block>

<block box in>
== hide ==
Hides (disables) the part.
</block>

===Orientation===
<block box in>
== parent name ==
Parent of this part. 
</block>
</pane>

<pane id="tab-table">
^generic^^
|**{{anchor:loop}}[[#loop]]** | Doesn't seem to do anything. (label_broken?) (label_moreinfo) |
|**{{anchor:ping-pong-loop}}[[#ping pong loop]]**| Instead of going back to frame 1 when starting a new loop, inverts the animations and plays it from end to start. |
|**{{anchor:sequence-name}}[[#sequence name]]**| The animation sequence that you want to play. |
|**{{anchor:rate}}[[#rate]]**| The animation rate. Default is **1**. Changing this duplicates outfit parts/creates desync, which can be fixed with [[#owner cycle]]. (label_broken?) |
|**{{anchor:offset}}[[#offset]]**| Offsets the animation. |
|**{{anchor:min}}[[#min]]**| Controls the start frame of the animation where **0** is the first frame and **1** is the last frame. Values below **0** add delay before the animation starts. Setting this above [[#max]] completely breaks the part. |
|**{{anchor:max}}[[#max]]**| Controls the end frame of the animation where **0** is the first frame and **1** is the last frame. Values above **1** add delay after the animation ends (before starting the next loop). |
|**{{anchor:weapon-hold-type}}[[#weapon hold type]]**| (label_moreinfo) |
|**{{anchor:owner-cycle}}[[#owner cycle]]**| Matches the owners animation cycle. This disables all other settings except for [[#rate]].  |
|**{{anchor:invert-frames}}[[#invert frames]]**| Inverts the animation. |
|**{{anchor:reset-on-hide}}[[#reset on hide]]**| Resets the animation when hidden. |
|**{{anchor:name}}[[#name]]**| The name of this part. Keep this unique. |
|**{{anchor:hide}}[[#hide]]**| Hides (disables) the part. |
^orientation^^
|**{{anchor:parent-name}}[[#parent name]]**| Parent of this part. |
</pane>
</tabs>