# Resource Packs [WIP]

# Resource Packs

<p class="callout info">Resource Packs enable you to modify certain assets of Minecraft or Mods, like SWEM.</p>

#### Purpose

You can use Resource Packs to:

- Modify **default** horse coats
- Modify entity animations
- <span style="color: rgb(149, 165, 166);">**1.20.1-1.5+**</span> Add new animations
- Modify default horse model
- Modify item inventory or block textures

---

#### Limitations

Resource packs are an **override**, meaning the content a resource pack contains will **replace** the default asset.

You cannot\* use Resource Packs to:

- Add new coats\*
- Add new entities or breeds (see section on model overrides)

\* *There are some clever Resource Packs out there with entity variations, but this is not straightforward or simple!*

<details id="bkmrk-%5Bexpand%5D-model-overr"><summary>\[EXPAND\] Model Overrides</summary>

Several talented Creators have created "Add On" Resource Packs with "breed" models, or custom features (ie mane variations).

- Packs may include one option (ie Arabian or Fjord)
- Packs may support multiple breeds +/- features
- Packs may support the default model coats (ideally) or override it entirely

**RELEVANT INFORMATION (USERS / SERVERS)**

<p class="callout info">Model Overrides are used at your own "risk" and support for issues should be sought via the **Pack** **Creator** <span style="text-decoration: underline;">not</span> SWEM.</p>

**How do they work?**

- In simple terms, it works by adding extra blocks to the default model
- If a coat artist leaves the blocks uncolored (invisible) you will see all / some of the default horse
- If a coat artist colors the blocks in, you will see those additional blocks on the default horse  
    `EXAMPLE` If a coat texture color in blocks added around the hoof, a horse would have "feathers"

**Can I use more than one model?**

- If you install multiple model override packs, only the **highest in load order will apply**
- If you want models from different Creators, they would have to merge their packs

**Can I use model overrides with a community pack or coat replacement resource pack?**

- If the model does not modify (only add on to) the default model, custom coats should work fine
- If not, this may 'break' default or custom coats `Example:` Horses with no mane or tail using some models
- It might be rare to get a 'custom model coat' if you are mostly using ones designed for the default model

**Can I use model overrides with an animation pack (ie Dressage animations)?**

- <span style="background-color: rgb(224, 62, 45); color: rgb(255, 255, 255);"> **TBC** </span> It is unlikely custom models will support all animation packs
- If you load a model pack **above** an animation pack, it will override any animations they both share
- If you load a model pack **below** an animation pack, it may not correctly animate the custom model

**Can I use model overrides on a server?**

- `SERVER` You may be able to install a model resource pack server-side
- `CLIENT (PLAYER)` If you install a model override in multiplayer, only you will see it  
    → Read the section about community packs + coat replacements above (may affect what you see in game)  
    → <span style="background-color: rgb(224, 62, 45); color: rgb(255, 255, 255);"> **TBC** </span> Server packs may override client side unless you can opt out of using it

**RELEVANT INFORMATION (CREATORS)**

<p class="callout warning">Model overrides use copyrighted SW assets and must be **FREE USE ONLY**   
→ You can accept **optional** donations  
→ You can sell coat textures that require your add on, provided it is 100% your own work (no SW coat edits)  
</p>

- You should not modify any of the core blocks involved in tack rendering
- You should **add to** (not modify where possible) the model to avoid breaking default + custom coats
- You will need to adjust the default animations for any additional blocks added
- You should be able to (optional) add support for custom animations in animation packs  
    → Consent may be required to include a modified animation from other Creators  
    → <span style="background-color: rgb(224, 62, 45); color: rgb(255, 255, 255);"> **TBC** </span> If add on models can support "new" custom animations via 1.20.1-1.5+ features

</details>---

#### Creating Basic Resource Pack Files

This guide covers how to create a basic resource pack folder. Alternatively, download the premade [**template**](https://discord.com/channels/715626418893095012/748632231257440336/1114586256542801970) on Discord.

<details id="bkmrk-%5Bexpand%5D-instruction"><summary>\[EXPAND\] Instructions</summary>

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE: </span> CREATE YOUR RESOURCE PACK FOLDER**

1. Create a new folder   
    → It can be anywhere for now (ie Documents)
2. Name your resource pack  
    → This can include capitals, some symbols and spaces
3. Go inside the folder
4. Create a new folder here
5. Name it `assets`  
    → This must be in lowercase exactly as shown

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP TWO: </span> CREATE YOUR PACK.MCMETA FILE**

1. Open a blank text editor file using Notepad (Windows) or TextEdit (Mac)
2. Paste in the pack template (below)
3. Edit the template to your pack  
    → `description` Any information to display **in game** **✅** `"description": "Pack Name V1.0 By Creator Name"`   
     <span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> **Note:** </span> Supports [color + format](https://minecraftitemids.com/color-codes) `&l&9Pack Name V1.0 &0By &dCreator` = `<strong><span style="color: rgb(35, 111, 161);">Pack Name  V1.0</span></strong> By <span style="color: rgb(185, 106, 217);">Creator</span>`  
    → `pack_format` Which [format](https://minecraft.wiki/w/Pack_format) (MC version) is supported **✅** `"pack_format": 15` = `MC 1.20 - 1.20.1`  
     <span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> **Note:** </span> Format gives a harmless warning when a resource pack is used in other versions (even if it works fine)
4. Select `file > save as`
5. Select the resource pack folder (not assets)
6. Name the file `pack.mcmeta` in lowercase
7. Save as the correct file type:  
    → **Windows:** `Save As Type: All Files` (Drop down menu, change from .txt)  
    → **Mac:**
8. Check it displays as a `MCMETA` file type in your folder

<details><summary>\[EXPAND\] pack.mcmeta Template</summary>

{  
 "pack": {  
 "description": "Text Here",  
 "pack\_format": 15  
 }  
}

</details>**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP THREE: </span> CREATE YOUR PACK ICON**

1. Choose or create an icon for your pack
2. Name it `pack` and save it as a `.png`
3. Paste it in your resource pack folder (not assets)

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP FOUR: </span> ADD YOUR CONTENT**

Go to the section(s) below for the content you want to add.

</details>---

#### Custom Coat Overrides

<p class="callout info">This is to **override one or more default coats** - to add **new** coats use a [Community Pack](https://wiki.swequestrian.com/books/star-worm-equestrian/page/creators-corner-wip)!</p>

<p class="callout warning">It is not permitted to modify SW mod assets for sale or re-upload. **Textures must be 100% your own work from scratch!**</p>

This guide will not cover how to create a coat, for information please read our **[resources](https://discord.com/channels/715626418893095012/748632231257440336/1117996750842630194)** on Discord.

<details id="bkmrk-%5Bexpand%5D-instruction-1"><summary>\[EXPAND\] Instructions</summary>

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE: </span> CREATE A COAT TEXTURE**

1. Create your coat texture in Blockbench
2. Choose a coat to override from the list of default coats
3. Save the texture as a `.png` file
4. Name the texture to match the coat it will replace

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP TWO: </span> CREATE ASSETS SUB-FOLDERS FOR YOUR COAT**

1. Go inside `assets`
2. Create a folder called `swem`
3. Inside that, create a folder called `textures`
4. Inside that, create a folder called `entity`
5. Inside that, create a folder called `horse`
6. Inside that, create a folder called `coats`
7. Paste your texture file here  
    → If you have more than one override you can add them also

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP THREE: </span> FINAL STEPS**

1. Your pack is ready and may work unzipped
2. You can zip it so it is easier to share or keep it unzipped to add new files  
    → If your zip does not show up in game, check your files are not too deep  
    → **✅Pack Name (Zip)** &gt; assets / pack.mcmeta / pack  
    → **❌Pack Name (Zip)** &gt; Pack Folder &gt; assets / pack.mcmeta / pack
3. Load into Minecraft
4. Open the Resource Pack menu
5. Open the folder (button)
6. Paste in your Resource Pack
7. Enable the Resource Pack
8. Check it is working in game  
    → Summon the coat you chose to override  
    → Confirm it uses the replacement coat, not original  
    → Check there are no texture errors and it looks correct on the horse

This page will not provide any resources for troubleshooting errors with texture files.   
You can look up a tutorial for texturing entities or ask for assistance with details on your issue in our Tech Help channels.

</details><details id="bkmrk-%5Bexpand%5D-default-coa"><summary>\[EXPAND\] Default Coat Names</summary>

![image.png](https://wiki.swequestrian.com/uploads/images/gallery/2024-07/scaled-1680-/image.png)

</details><table border="1" id="bkmrk-%F0%9F%93%82-txp_name-%F0%9F%93%82-assets-" style="width: 100%; height: 143.188px;"><colgroup><col style="width: 13.6072%;"></col><col style="width: 16.303%;"></col><col style="width: 10.0128%;"></col><col style="width: 11.5533%;"></col><col style="width: 10.0128%;"></col><col style="width: 9.62773%;"></col><col style="width: 9.62773%;"></col><col style="width: 19.3838%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td rowspan="3" style="height: 89.3907px;">📂 TXP\_name  
</td><td style="height: 29.7969px;">📂 assets</td><td rowspan="3" style="height: 89.3907px;">📂 swem  
</td><td rowspan="3" style="height: 89.3907px;">📂 textures  
</td><td rowspan="3" style="height: 89.3907px;">📂 entity  
</td><td rowspan="3" style="height: 89.3907px;">📂 horse  
</td><td rowspan="3" style="height: 89.3907px;">📂 coats  
</td><td style="height: 29.7969px;">🖼️ coat\_name.png</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🖼️ pack.png</td><td style="height: 29.7969px;">🖼️ coat\_name.png</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🗒️ pack.mcmeta</td><td style="height: 29.7969px;">📂 foal **(optional)**</td></tr><tr style="height: 53.7969px;"><td colspan="8" style="height: 53.7969px;"><p class="callout info">Shown: The file structure for texture packs overriding default horse +/- foal coats.</p>

</td></tr></tbody></table>

<table border="1" id="bkmrk-file-type-descriptio" style="border-collapse: collapse; width: 100%; height: 149.609px;"><colgroup><col style="width: 17.4017%;"></col><col style="width: 44.8153%;"></col><col style="width: 37.7831%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**File Type**</td><td style="height: 29.7969px;">**Description**</td><td style="height: 29.7969px;">**Note**</td></tr><tr><td>📂 Pack Name</td><td>A folder with the name of your resource pack</td><td>  
</td></tr><tr><td>🖼️ pack.png</td><td>PNG image for your pack - displayed in game.</td><td>This must remain named `pack.png`</td></tr><tr><td>🗒️ pack.mcmeta</td><td style="height: 30.1094px;">MCMETA file with your pack's description and version(s)</td><td style="height: 30.1094px;">This must remain named `pack.mcmeta`</td></tr><tr style="height: 30.1094px;"><td style="height: 30.1094px;">🖼️ coat\_name.png</td><td style="height: 30.1094px;">PNG for the coat to override.</td><td style="height: 30.1094px;">This must be the name of a valid swem coat</td></tr></tbody></table>

<p class="callout info">Coat names in files might not be identical to in-game names or values. **Example** `swem:sweetboi` = `13_m_sweetboi`  
→ You must use the **file** names, a list of valid names can be found above  
</p>

---

#### Custom Animation Overrides / Additions

<p class="callout warning">It is not permitted to modify SW mod assets for sale or re-upload. **Animations must be 100% your own work from scratch!**</p>

This guide will not cover how to create animations. You can request help from other creators in our [**Tech-Help**](https://discord.com/channels/715626418893095012/997404105704210432) channel (Discord).

<details id="bkmrk-%5Bexpand%5D-instruction-2"><summary>\[EXPAND\] Instructions</summary>

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE \[A\]: </span> CREATE A NEW ANIMATION**

1. Create an animation in Blockbench
2. Save the `swem_horse.json` file  
    → This should include your animation(s) **and** all default animations

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE \[B\]: </span> MODIFY AN EXISTING ANIMATION**

1. Modify one or more default animation in Blockbench
2. Save the `swem_horse.json` file

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE \[B\]: </span> CREATE ASSETS SUB-FOLDERS FOR YOUR COAT**

1. Go inside `assets`
2. Create a folder called `swem`
3. Inside that, create a folder called `animations`
4. Paste your `swem_horse.json` file here

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP THREE: </span> FINAL STEPS**

1. Your pack is ready and may work unzipped
2. You can zip it so it is easier to share or keep it unzipped to add new files  
    → If your zip does not show up in game, check your files are not too deep  
    → **✅Pack Name (Zip)** &gt; assets / pack.mcmeta / pack  
    → **❌Pack Name (Zip)** &gt; Pack Folder &gt; assets / pack.mcmeta / pack
3. Load into Minecraft
4. Open the Resource Pack menu
5. Open the folder (button)
6. Paste in your Resource Pack
7. Enable the Resource Pack
8. Check it is working in game  
    → Tame and mount a horse  
    → Use `/swem rrp anim <Animation Name>` to trigger the animation  
    → Confirm the animation works as expected

This page will not provide any resources for troubleshooting errors with animations.   
You can look up a tutorial for animating or ask for assistance with details on your issue in our Tech Help channels.

</details><table border="1" id="bkmrk-%F0%9F%93%82-pack-name-%F0%9F%93%82-assets" style="width: 100%; height: 132.984px;"><colgroup><col style="width: 12.8725%;"></col><col style="width: 14.7795%;"></col><col style="width: 9.89273%;"></col><col style="width: 13.23%;"></col><col style="width: 49.2253%;"></col></colgroup><tbody><tr style="height: 19.5938px;"><td rowspan="3" style="height: 79.1876px;">📂 Pack Name  
</td><td style="height: 19.5938px;">📂 assets</td><td rowspan="3" style="height: 79.1876px;">📂 swem  
</td><td rowspan="3" style="height: 79.1876px;">📂 animations  
</td><td style="height: 19.5938px;">🗒️ swem\_horse.json

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🖼️ pack.png</td><td rowspan="2" style="height: 59.5938px;">🗒️ swem\_horse\_foal.json

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">🗒️ pack.mcmeta</td></tr><tr style="height: 53.7969px;"><td colspan="5" style="height: 53.7969px;"><p class="callout info">Shown: The file structure for animation packs overriding default horse +/- foal coats.</p>

</td></tr></tbody></table>

<table border="1" id="bkmrk-file-type-descriptio-1" style="border-collapse: collapse; width: 100%; height: 149.609px;"><colgroup><col style="width: 17.4017%;"></col><col style="width: 44.8153%;"></col><col style="width: 37.7831%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">**File Type**</td><td style="height: 29.7969px;">**Description**</td><td style="height: 29.7969px;">**Note**</td></tr><tr><td>📂 Pack Name</td><td>A folder with the name of your resource pack</td><td>  
</td></tr><tr><td>🖼️ pack.png</td><td>PNG image for your pack - displayed in game.</td><td>This must remain named `pack.png`</td></tr><tr><td>🗒️ pack.mcmeta</td><td style="height: 30.1094px;">MCMETA file with your pack's description and version(s)</td><td style="height: 30.1094px;">This must remain named `pack.mcmeta`</td></tr><tr style="height: 30.1094px;"><td style="height: 30.1094px;">🗒️ swem\_horse.json</td><td style="height: 30.1094px;">JSON file with your new / modified animations</td><td style="height: 30.1094px;">This must remain named `swem_horse.json`</td></tr></tbody></table>

---

#### Custom Item Texture Overrides

<p class="callout warning">It is not permitted to modify SW mod assets for sale or re-upload. **Textures must be 100% your own work from scratch!**</p>

This guide will not cover how to create icons or how to override models.

<details id="bkmrk-%5Bexpand%5D-instruction-3"><summary>\[EXPAND\] Instructions</summary>

 **<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP ONE \[A\]: </span> EXTRACT THE MOD FILE**

1. Download a copy of whatever version of the swem mod you intend to modify
2. Right click the jar file in your downloads and extract it  
    → This may require a program such as WinRar (Windows)
3. Go inside `assets > swem > textures`
4. Locate the folder for whatever you want to override  
    → `block` Includes any textures for building blocks or items that can be placed. **Example:** Wheelbarrows  
    → `entity` Includes any textures for horse poop, rope knots and the wormieboi entity.  
    → `entity_icon` Includes textures for entity icons named **the same as an existing coat.** → `gui` Includes textures for jump bar and the jump creation tool  
    → `gui > container` Includes textures for various inventory items **Example:** Saddle Bags or Tack Boxes  
    → `item` Includes the textures of virtually every item you can have in your inventory (inventory icon)  
    → `models > armor` Includes the textures of some armor pieces.  
    → `painting` Includes the textures of any paintings added by the mod.  
    → `particle` Includes the textures of any particle effects emitted by horses for various interactions or events.
5. Locate the texture(s) for whatever asset(s) you want to override:  
    → Note the **exact** file names  
    → Note the **exact** types - some assets need multiple textures (ie for different blockstates, sides etc)  
    → Note the **texture size** - for some blocks and items you may be able to scale textures up or down, but not for all!

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP TWO \[B\]: </span> CREATE A NEW TEXTURE**

1. Create an texture in your preferred painting program
2. Save the file as a png with the **exact** name for the item/block etc you are overriding (above).

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP THREE \[C\]: </span> CREATE ASSETS SUB-FOLDERS FOR YOUR TEXTURE**

1. Go inside `assets`
2. Create a folder called `swem`
3. Inside that, create a folder called `textures`
4. Create a folder that matches your item (step one)  
    → **Example:** If you're replacing `rack_saddle` from `block` then create a `block` folder
5. Paste your `png` (texture) file here
6. Repeat for any addition textures you want to override (correct folders for each item)

**<span style="background-color: rgb(132, 63, 161); color: rgb(255, 255, 255);"> STEP FOUR \[D\]: </span> FINAL STEPS**

1. Your pack is ready and may work unzipped
2. You can zip it so it is easier to share or keep it unzipped to add new files  
    → If your zip does not show up in game, check your files are not too deep  
    → **✅Pack Name (Zip)** &gt; assets / pack.mcmeta / pack  
    → **❌Pack Name (Zip)** &gt; Pack Folder &gt; assets / pack.mcmeta / pack
3. Load into Minecraft
4. Open the Resource Pack menu
5. Open the folder (button)
6. Paste in your Resource Pack
7. Enable the Resource Pack
8. Check it is working in game  
    → Obtain or place your item(s) and check the new texture shows  
    → Check for any texture errors (missed pixels etc)

This page will not provide any resources for troubleshooting errors with textures.   
You can look up a tutorial for animating or ask for assistance with details on your issue in our Tech Help channels.

</details><table border="1" id="bkmrk-%F0%9F%93%82-pack-name-%F0%9F%93%82-assets-1" style="width: 100%; height: 323.766px;"><colgroup><col style="width: 13.7058%;"></col><col style="width: 14.8997%;"></col><col style="width: 9.77354%;"></col><col style="width: 11.2038%;"></col><col style="width: 13.1108%;"></col><col style="width: 37.3063%;"></col></colgroup><tbody><tr style="height: 29.7969px;"><td rowspan="9" style="height: 91.1876px;">📂 Pack Name  
</td><td style="height: 29.7969px;">📂 assets</td><td rowspan="9" style="height: 91.1876px;">📂 swem  
</td><td rowspan="9" style="height: 91.1876px;">📂 textures  
</td><td style="height: 29.7969px;">📂 block

</td><td style="height: 29.7969px;">🖼️ block\_name.png

</td></tr><tr style="height: 31.5938px;"><td style="height: 31.5938px;">🖼️ pack.png</td><td style="height: 31.5938px;">📂 entity

</td><td style="height: 31.5938px;"> </td></tr><tr style="height: 29.7969px;"><td rowspan="7" style="height: 29.7969px;">🗒️ pack.mcmeta  
</td><td style="height: 29.7969px;">📂 entity\_icon

</td><td style="height: 29.7969px;">🖼️ coat\_artist.png

</td></tr><tr style="height: 29.7969px;"><td rowspan="2" style="height: 59.5938px;">📂 gui

</td><td style="height: 29.7969px;">🖼️ gui\_type.png

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">📂 container -&gt; 🖼️ container\_type.png

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">📂 item

</td><td style="height: 29.7969px;">🖼️ item\_name.png

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">📂 models

</td><td style="height: 29.7969px;">📂 armor -&gt; 🖼️ armor\_layer.png

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">📂painting

</td><td style="height: 29.7969px;">🖼️ painting\_name.png

</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">📂particle

</td><td style="height: 29.7969px;">🖼️ particle\_name.png

</td></tr><tr style="height: 53.7969px;"><td colspan="6" style="height: 53.7969px;"><p class="callout info">Shown: The file structure for animation packs overriding default textures - only use folders you are creating overrides for. </p>

</td></tr></tbody></table>