# Animations [WIP]

<p class="callout info">This feature is available in **1.20.1-1.5+** and will **NOT** be backported to any outdated versions.</p>

#### Features

This update can support adding custom animations with or without overriding the default variants.  
It was not possible to add animations via community pack, **they require a resource pack.**

- Animations must be triggered via the command `/swem rrp anim <Animation>`
- Animations will loop (repeat) until the command is repeated
- Animations will not auto-fill (list possible options), creators should provide the valid options
- Animations will be seen by any player with the animation pack installed

---

#### Important - Update Changes

This update has not made any significant changes to default animations.


---

#### Frequently Asked Questions 


This section has drop-downs for FAQs and expanded information about Animation Resource Packs.  
If your question is not answered here, check out [General Information.](https://wiki.swequestrian.com/books/star-worm-equestrian/page/general-information-wip)

<details id="bkmrk-%5B3%5D-multiplayer-use-"><summary>\[EXPAND\] FAQs</summary>

**⮞ CAN ANIMATIONS BE TRIGGERED WITHOUT COMMANDS?** No. While this is not ideal for discipline specific commands (ie dressage moves), there is currently no way to support keybind(s) to trigger custom animations.

**⮞ CAN ANIMATION PACKS MODIFY DEFAULT ANIMATIONS?** Yes, this was already possible and several packs exist to override specific default animations.

**⮞ CAN I INSTALL MULTIPLE ANIMATION PACKS AT ONCE?  
<span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> \[TBC\] </span>** Yes. Animation packs must include both the default animations **and** any custom animations, so if you install more than one pack, you should load any that override default animations at the top.

**Example** If you have an animation pack that adds new dressage moves **and** modifies default gait or jump animations, you should load this **above** any other packs that only add new animations. Since they include the unaltered default animations, they will override your modified defaults unless lower in the list.

**⮞ WHERE CAN I SEE A LIST OF ANIMATION NAMES FOR THE TRIGGER COMMAND?** Animation names will not auto-fill when using the command. Short of opening up the files, it is recommended to confirm valid options with the creator. Check their content or site(s) for a list of valid commands before contacting them directly.

**⮞ CAN I INSTALL ANIMATION PACKS IN A MULTIPLAYER SERVER? <span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> \[TBC\] </span>** Animation packs should work on multiplayer servers, but all players require the resource pack to view the triggered animations. This should all work client-side, servers should not need to make any alterations to support custom animations (ie not required on the server).

**⮞ HOW DO ANIMATION PACKS WORK ON MULTIPLAYER SERVERS WITH KEYS / PERMISSIONS? <span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> \[TBC\] </span>**

**⮞ HOW DO ANIMATION PACKS APPEAR IF A PLAYER IS MISSING THE RESOURCE PACK?  
<span style="color: rgb(255, 255, 255); background-color: rgb(224, 62, 45);"> \[TBC\] </span>**

</details>---

#### Using An Animation Resource Pack

To install an animation resource pack, paste it into the `resourcepack` folder.  
If you have multiple animation packs, put any packs that override **default** animations at the top.

---

#### Creating A Community Pack Tack Set

To create an animation resource pack, see [Creators' Corner](https://wiki.swequestrian.com/books/star-worm-equestrian/page/creators-corner-wip#bkmrk-adding-custom-animat).

---

#### Troubleshooting **<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> COMING SOON </span>**

If you experience an issue with animation packs in game, please follow this troubleshooting guide.

<details id="bkmrk-%5Bexpand%5D-troubleshoo"><summary>\[EXPAND\] Troubleshooting Errors</summary>

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> ANIMATION PACK TROUBLESHOOTING </span>  
FOLLOW <span style="text-decoration: underline;">EACH STEP</span> CAREFULLY + NOTE ISSUES AS YOU GO. ONLY REQUEST HELP <span style="text-decoration: underline;">AFTER</span> USING THIS!**

**⮞ COMING SOON  <span style="background-color: rgb(224, 62, 45); color: rgb(255, 255, 255);"> DO NOT UPLOAD PAID/PRIVATE PACKS WITH FILES FROM CREATORS WITHOUT CONSENT </span>**

</details>