> For the complete documentation index, see [llms.txt](https://docs.gercstudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gercstudio.com/weapons/weapon-controller/animations/animated-weapons.md).

# Animated Weapons

This feature is for professionals.

You can use animated weapons with the USK.

{% hint style="info" %}
**Important!**

To all parts of a weapon are animated, a path (in the character’s skeleton) to the weapon in an animation must correspond to the path to the weapon in the game - like in Generic Animations.

**For Example:**

You've created an animation - character with a pistol. In the animation your character bones have the struct: 

Hips -> Spine -> Spine1 -> ...

If you use this animation with another character which has different bone names or struct (swat:Hips -> swat:Spine -> swat:Spine1 -> ...), the pistol won't be animated during the game.
{% endhint %}

To add animations with animated weapons do the following:

* **Import an empty animation with all weapons in the root** (for example, T-Pose animation).

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-M0hIzfnpo8m2-8BV7MT%2F-M0qyQiazyarr5P62axx%2FT-Pose.png?alt=media\&token=73c2e9a5-0a64-4672-8448-4da1b823371a)

* **Create the Avatar Mask** with this animation avatar.

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-M0hIzfnpo8m2-8BV7MT%2F-M0r5ononkyoQCuQ3gLl%2FMask.png?alt=media\&token=ec71a1c4-9202-4f47-93b7-7cf7b6535af9)

* Make sure that all animated weapons and their parts are selected in the mask

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-M0hIzfnpo8m2-8BV7MT%2F-M0r68GtL3PCabdOpLp0%2FSelected%20Weapons.png?alt=media\&token=70bd12e5-759c-48df-b039-cca143293034)

* **Add the mask to weapons animations**. In each animation which contains an animated weapon, you must add the mask which you created before

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-M0hIzfnpo8m2-8BV7MT%2F-M0r6sCtcUf7bwqCg3F3%2FMask%20in%20anim.png?alt=media\&token=ad26bdb4-99f6-4591-b7ba-b02d7202be23)

* **Adjust the main Masks** (Tools -> Assets -> \_Masks -> **BodyTop** **(tp,td)** & **BodyTop (fp)**) with the T-Pose avatar (which you've imported in the 1st step). Select in the masks only animated weapons parts.

![](https://3854890582-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lf4aWZpqUiSipiEh-D6%2F-M0hIzfnpo8m2-8BV7MT%2F-M0r7TTKQLFJ46isHqmy%2FMain%20masks.png?alt=media\&token=a95bb499-d175-4af3-8f61-824b9c69f7f7)

#### Watch the video with an example of adding animations:

{% embed url="<https://youtu.be/wj9N1qC96IA>" %}

To learn how to synchronize animations with the player’s actions (for example, the spawn of magazines when reloading), read this page:

{% content-ref url="/pages/-M0na49egEhakjo7TCaG" %}
[Animation Events](/other-components/events.md)
{% endcontent-ref %}