Skip to main content

Creators' Corner [WIP]

  READ ME ME 

This page is an early WORK IN PROGRESS and information is subject to change or correction for any errors.
It is public to accept feedback and external input from creators prior to final additions and corrections.
Please contact Delphi via SWEM DC for feedback or to contribute any resources to this guide!
If you are a content creator with a video guide, I will gladly add links to help visual learners.


Note To Content Creators

This update will support you in sharing your content to a wider audience, with or without coding experience.

  • You will no longer need to create resource packs that override a limited number of default options for coat or tack.
  • You can add limitless (within reason) options to expand the game without creating a separate mod (add-on).
  • You can integrate your content into some existing features of the mod, such as coat cycling and breeding tags.

To properly transition towards community packs, we recommend:

  • Read this page carefully to fully understand creating community packs.
  • Create simple, clear and easy to follow / enforce Terms Of Use (TOU) if you share or sell your content.
  • Upload content in a player-friendly format, such as Community Pack, Content Pack or standalone files.

You must read and follow the Content Creation Rules (below) to comply with SWEM's license and permitted use of assets.

Content Creation Rules

⮞ YOU MUST NOT SELL (OR TRADE FOR PROFIT) ANY ASSETS CREATED AND OWNED BY SWEM

EXCEPTIONS MAY BE MADE ON AN INDIVIDUAL BASIS WITH EXPLICIT CONSENT FROM SWEM (ALAHARRANHONOR)

  • Modified versions of the horse model
  • Modified versions of any blocks or items
  • Modified version of any default coats
  • Modified textures of any blocks or items
  • Freely provided materials:
    → Shading layers
    → Rights to use standard techniques (eyes, nose, hoof etc)
    → Template resource packs
    → Template community packs
    → JSON files (not in a working community pack)

⮞ YOU MUST NOT SELL (OR TRADE FOR PROFIT) OR REDISTRIBUTE ASSETS OF OTHER CREATORS

EXCEPTIONS MAY BE MADE WITH EXPLICIT CONSENT FROM THE CREATOR OR THEIR T.O.U

  • Modified textures
  • Modified .json files that remove or alter credits
  • Free resources
    → Including the Official Community Pack (free) and any donated works from community artists

⮞ YOU CAN PROVIDE PROVIDE FREE CONTENT THAT ACCEPTS AN AN OPTIONAL DONATION

COAT MODIFICATIONS ARE ONLY PERMITTED WITH WITH EXPLICIT CONSENT FROM SWEM (ALAHARRANHONOR)

  • Modified horse model and "breed add-ons"
  • Modified .json files files 
    → Altered breeding tags or coat cycling information

⮞ YOU CAN SELL CONTENT THAT IS AT LEAST LEAST 90%* YOUR OWN WORK

90% ACCOUNTS FOR THE 10% FAIRLY ACCREDITED TO SIMILAR ARTISTIC STYLE, INSPIRATION, REFERENCE OR COLOR PICKING

  • You can sell content that is at least 90%* your own work
    → Models for entities, blocks or items
    → Textures for entities, including coats using the freely provided shading layer or standard features (eyes, nose, hoof etc)
    → Textures for inventory icons of custom content using the default pixel outline (shape) of SWEM tack
    → Textures for blocks or items
    Animations Animations 

Star Worm Equestrian is PG13: appropriate for users of all ages.
Any content or creators that modify it to be or appear otherwise do so against the terms of use for this project.

⮞ YOU MUST NOT SELL, PROMOTE OR FEATURE SWEM IN ANY CONTENT CONTENT OR MEDIA THAT INCLUDES:

  • Extreme violence or gore
  • Mature (18+) themes
    → Including realistic anatomy or animations animations 
Terms Of Use Information
WARNING

Creating a complicated or highly restrictive TOU will set you up for frustration when it is inevitably violated or misinterpreted.
To protect your content within the very limited legal recourse for TOUs we encourage creators to share their creations in a similar way to mods; allow public or private use with minimal restrictions, provided the creator receives the download or support.

  • If you choose to share your content publicly, it is your responsibility to clearly inform users of appropriate use.
  • It is unreasonable to expect users to be remain informed of alterations to TOU after the time of download.
  • It recommended to:
    → Post your full TOU in a public source that can be accessed by anyone without membership or sign up/in.
    → Include your TOU as a text file in any premade community packs.
    → Include your TOU as a link or summary in any location your files are hosted or downloaded.
RECOMMENDATIONS

Avoid requiring credit for use in media; it should be encouraged but no credits does not equal insult!
It is not standard practice to credit every creation (ie mods)  in casual images; nice if you do, but optional!
→ It should only be "required" to credit where appropriate (promotion, inspiration or reference), and and not falsely claim.

Avoid Avoid prohibiting prohibiting inspiration or reference; similarity is not proof of plagiarism!
→ It is possible for creators to have a similar idea, share the same reference, or take respectful inspiration!
→ It should be expected that work(s) clearly and directly referenced or inspired by your creation is fairly credited.

Avoid Avoid restrictive restrictive use policies that are difficult to monitor and enforce.
→ It is an unfortunate reality that players +/- servers will violate agreements, especially if they are restrictive.
→ There is limited legal recourse to address this; so state what you are willing and able to action if necessary!

Consider providing content in a compact format with minimal individual downloads!
→ Players and servers will be less likely to distribute (or more likely to use) easily accessible files.
→ It is suggested to provide creator pack(s) in bundles such as 'Bays', 'Pintos', '2023 Coats'

Avoid uploading to unsecure file hosting sites or encouraging users to engage in unsafe internet habits.
→ It is recommended to use popular sites such as Kofi, Google Drive.


EXAMPLE TERMS OF USE (NOT A LEGAL CONTRACT OR LICENSE)
  • OWNERSHIP & AGREEMENT
    → The creator (name) retains all rights of ownership to this content
    → The right to use this content is granted to you (player) in accordance with this agreement
  • USE
    → This creation can/not be used in content (images, videos) - credits are optional but appreciated.
    → This creation can/not be used privately in singleplayer or a small private group.
    → This creation creation can/not be used publicly in multiplayer.
    → This creation creation can/not be used in reasonable commercial services services with/without consent.
          ✅🚫 Offered as part of a service (ie random / selected coat change) requiring real money
          ✅🚫 Offered as a prize or reward for activity or events requiring real money
          ✅🚫 Offered as an unlock via crowdfunding or engagement (ie server cost covered -> unlock)
          NOTE: Commercial services must abide by Minecraft's EULA

  • DISTRIBUTION
    This This creation can/not be reuploaded reuploaded with/without consent and/or credits credits and/or payment.
          ✅🚫 Limited private use by friends or small groups
          ✅🚫 Custom Community Packs (folder)  
          ✅🚫 Custom Modpacks (zip)
          ✅🚫 Exceptions: Paid vs Free, Commissions (paid) or Gifts (prizes)
          ✅🚫 Other: File Hosting Sites, Discord Servers etc
  • ALTERATIONS
    → This creation creation can/not be altered altered with/without consent and with/without  credits for public/private use.
          ✅🚫 Texture
          ✅🚫 Information (json: name, description, color tags etc)
          ✅🚫 Other conditions conditions 

Updating A Community Pack

Official Community Pack Pack  [VERSION TBC]   has been updated to support the latest release.

If you have a custom coat community pack for 1.20.1-1.5-beta7, you must modify it to stay compatible in newest release.

  1. Close Minecraft
  2. Locate your community pack(s)
  3. Go inside inside packname > jsons > coats
  4. Open the first coat file in a text editor
  5. Change Change "legacy": "default:coats/legacy/coat_artist.png" to "legacy": "legacy/coat_artist.png"
  6. Save and close the file
  7. Repeat for all coat files +/- all outdated packs

Creating A Community Pack

You can skip step 1-3 by downloading a template community pack found  [HERE] .

You can skip or delete any folder that will not be used for your content (ie tack folders if you will not add any tack).

  READ ME:   RESOURCES

[EXPAND] Recommendations

⮞ USE A STANDARD NAMING FORMAT

This keeps your creations consistent, well organized and easy to identify as your work.
  PACKS   artist_packname Example: arishant_freecoats
  COATS
  coatname_artist  Example:  maple_arishant
  TACK   name_type_artist Example: midnight_saddle_jenny

You might notice some items recommend credits before before or or after the name, this is for a few reasons!
  PACKS   Sorted alphabetically in folder and in-game, so packs group by artist instead of pack name
  COATS   Listed alphabetically in game once filtered by pack. Example:  apple_artist / banana_artist / coconut_artist
  TACK   Listed alphabetically in game, instead of by type. Example:  midnight_bridle / midnight_halter / midnight_saddle

⮞ USE A UNIQUE NAME FOR PACKS

Naming a pack koficoats will work, but if another pack shares the same name they would merge together.
If you use artist_packname it significantly reduces the chance of name duplication and folder merging.

⮞ USE A UNIQUE NAME FOR FILES

Naming a coat coat coatname or tack item name_type without artist will work, but it increases the risk of file replacement.
Pack that use the same name and coats or tack with the same name, will replace existing files of the same name.

If you are an artist that offers different variations of content, always use a unique name.
Example: 2 files both named named coatname_artist but one with braids and one with roached mane will replace the other if a player chooses to use both options. If you named one one coatname_braids_artist and the other other coatname_roached_artist the player can choose to have one or both without replacing the other.

⮞ USE CORE PACKS AND CONTENT PACKS

If you want to make every pack unique, that's up to you. Example:  artist_pack1  artist_pack2  artist_pack3
However, if you create a lot of content this is going to be annoying for you to keep track of, and overwhelming to players.

Instead of using many packs with just one of two creations inside, consider using a core pack and offering add-ons via content packs. This is explained more in a section further down!

⮞ REMOVE (OR RENAME) OUTDATED FILES

If you fix and issue with a pack, file or texture it is recommended to remove the original download. If you want to keep it as a legacy version, consider renaming it (ie coatname_artist_old). Old files using the name name may replace newer ones if accidentally downloaded, or included in an outdated pack.

[EXPAND] File Structure Example
📂 config
📂swem
📂community-packs
📂artist_packname
📂jsons

📂coats

🗒️artist_coat.json files

📂tack










📂blanket

📂breast_collar

📂bridle

📂girth_strap

📂halter

📂horse_armor

📂leg_wraps

📂pasture_blanket

📂saddle

📂saddle_bag

📂textures
📂coats 🗒️artist_coat.png files
📂tack

📂blanket

📂breast_collar

📂bridle

📂girth_strap

📂halter

📂horse_armor

📂leg_wraps

📂pasture_blanket

📂saddle

📂saddle_bag

📂tokens 🗒️token_name.png  files
🗒️ tokens.json

Shown: The file structure for community packs, including correct placement inside inside config > swem > community-packs

  STEP ONE:   CREATE THE PACK FOLDER STRUCTURE

  1. Create a new folder folder 
    → It can be in config > swem > community-packs or somewhere else (move later)
  2.   Name your community pack
    → It must be in lowercase letters with no spaces
    → It is recommended to use use artist_packname such as as yourname_kofi or or yourname_bays
  3. Go inside the empty folder
  4. Create two new folders here
      jsons to store the information files
      textures to store the coat and tack files

  STEP TWO:   CREATE THE JSONS FOLDER STRUCTURE

  1. Go inside the empty jsons folder
  2. Create two new folders here
      coats to store .json information files for coats
      tack to store .json information files for tack
  3.   Go inside the empty empty tack folder
  4. Create 10 new folders here
      blanket
      breast_collar
      bridle
      girth_strap
      halter
      horse_armor
      leg_wraps
      pasture_blanket
      saddle
      saddle_bag

  STEP THREE:   CREATE THE TEXTURES FOLDER STRUCTURE

  1. Go inside the empty empty textures folder
  2. Create two new folders here
      coats  
      tack  
  3. Go inside inside the empty empty coats folder
  4. Create one new folder here:
      legacy to store .png texture files for coats
  5. Go inside the empty empty tack folder
  6. Create 10 new folders here
      blanket
      breast_collar
      bridle
      girth_strap
      halter
      horse_armor
      leg_wraps
      pasture_blanket
      saddle
      saddle_bag

Creating A Content Pack

If you are making a pack for personal use, you can skip this. Content packs are aimed at Creators providing expansion content.

A Content Pack is exactly the same as a community pack, but differs in how and why it is used.

  • Content Packs use the same name as a 'core' community pack.
  • Content Packs merge into any packs with the same name, or work as a standalone if one does not exist.
  • Content Packs usually include less content, or content bundled by theme (ie Black Coats, Bay Coats)
[EXPAND] Content Packs Example

If you create a lot of content, you probably do not want to provide ALL of your coats in a single bundle, or maintain lots of individually named packs. This would quickly get confusing and difficult should any packs require a fix to files or textures.

Let's say you decide that your core pack will be yourname_koficoats. Each time you create a new coat, you will provide that coat in its own pack, using that name. You set it up like a normal community pack, and if a player downloads it it will work in-game when pasted into the community pack folder.

If you then create another new coat, you do the same thing; make a community pack named named yourname_koficoats with just the NEW coat file and texture. If a player downloads that file and pastes it into the community pack folder,  it will merge into any pack folders that share the same name.

This means you can offer optional content that players can pick and choose which files they want. They don't need to download any requirements, every pack will work on its own, or merge with others if they already exist.

Unfortunately, downloads get renamed if they have the same name, ie artist_pack [1] and artist_pack [2]
→ There is no way to avoid this without downloading packs one at a time, or manually renaming them to merge files.


Creating Content

If you followed the guide above, you have a basic community pack, but it needs content to work in game.

Community Packs can support custom coats, tack and animations - this can be all in one pack, or split into separate packs.


Adding Custom Coats

This guide will not cover how to create a coat, for information please read our resources on Discord.

  STEP ONE:   CREATE OR DOWNLOAD A CUSTOM COAT

  1. Save or rename the file as artist_coatname
    → The file type should display as as PNG File   
  2. Paste this file into your community pack artist_packname > textures > coats > legacy > coatname_artist.png

  STEP TWO:   CREATE A JSON FILE

    1. Open a blank text editor file using Notepad (Windows) or or [MAC ALTERNATIVE]
    2. Paste in the coat template code (below)
    3. Edit the template to your coat
        credits the name of the coat artist(s) "credits": "Arishant",  
        inspiration optional notes on inspiration or reference "inspiration": "Esperanza from Spirit",  
        models the texture path (location) for legacy model "legacy": "legacy/esperanza_arishant_legacy.png"
        lapis_cyclable if the coat can be cycled using lapis or redstone redstone true or or false
        obtainable_by_breeding if the coat can appear from a (bred) foal true or or false
        base_colors which color tags the coat uses ["black","gray"]  "base_colors": ["creamy"]
    4. Save the file as a .json file by using using save as and naming the file file artist_coatname.json
      → The file type should display as as JSON File    
    5. Paste this file into your community pack artist_packname > jsons > coats > coatname_artist.json
[EXPAND] Coat Template

{
   "credits": "Artist(s)",
   "inspiration": "N/A",
   "models": {
      "legacy": "legacy/coatname_artist_legacy.png"
   },
   "lapis_cyclable": true,
   "obtainable_by_breeding": true,
   "base_colors": ["black","gray","white","creamy","brown","dark_brown","chestnut"]
}

[EXPAND] Info & Common Mistakes

⮞ LEGACY MODEL

Legacy model is the current horse model in game, but more models are planned in future.

  • Texture must use the legacy model texture path
  • Future model types may come pre-listed listed, but do not function in game

⮞ TEXTURE PATH
Texture path is the location of the coat file placed in artist_packname > jsons > coats > legacy > coatname_artist.png

  • Texture path must match the exact name of the coat png file
    → Must be a lowercase name with no spaces or symbols
    → Can include numbers or underscores underscores 
    → Should use the format format artist_coatname or or artist_coatname_legacy to indicate it uses original model
    → Should share the same or similar name as the json file

⮞ COAT CYCLING
Coat cycling is the function that allows a player to cycle through coat options by right clicking a horse with redstone or lapis.

  • Cycling a coat will only work if:
    → Set to to "lapis_cyclable": true,  in the json file
    → Coat cycling is enabled in server config config allowCoatCycling = true  
    → Coat is not blacklisted in server config config blacklistedCoatIds
    → Server config is per-world; enabling settings in one world does not auto-apply it to others!

  • Summoning a (random) coat via command will only work if:
    → Set to to "lapis_cyclable": true, in the json file
    → Coat is not blacklisted in server config config blacklistedCoatIds

⮞ BREEDING & COLOR TAGS

  • Color tags must use at least one of 7 valid choices:
    ["black","gray","white","creamy","brown","dark_brown","chestnut"]
    → Separate multiple tags with a comma
    → There must not be a comma between between " and ]

  • Coats can appear from converting horses if:
    → Coat has at least one valid color tag
    → Coat has the same color tag as the vanilla horse (randomly chooses from coat options)
    → Set to to "obtainable_by_breeding": true, in the json file
    → Converting is enabled in server config file (default)  tokensBreeding = false
    → Coat is not blacklisted in server config blacklistedCoatIds
    → Server config is per-world; enabling settings in one world does not auto-apply it to others!

  • Coats can appear from breeding if:
      Set to to "obtainable_by_breeding": true,  in the json file
    → Coat is not blacklisted in server config config blacklistedCoatIds
    → Foals are assigned one tag from any their parents have and use one of 7 foal coats (one per tag)
    → Foals choose from a random adult coat with the same tag when they grow up
  • Color tags and breeding outcomes are are very basic basic and do not support realistic genetics
    → Setting tags you expect the horse to 'pass on' is more likely to get your coat coat from from those tags.
      Example: Bay coat with "chestnut", "black", "brown" - any chestnut, black or brown foal can grow up to use it.
    → Setting tags for any color a coat has a small amount of will result in dramatic changes from foal to adult coats.
    Example: Leopard Appaloosa with "black", "white" - a fully black foal would grow up to a mostly white coat.

  RECOMMENDATION
→ Set one or two tag(s) for a foal color you would expect to get the coat from Example:  Black Foal -> Black Horse Horse 

  STEP THREE:    TEST YOUR COMMUNITY PACK

    1. Paste the community pack file in in config > swem > community-packs
      → Read here if this is your first time installing a community pack.
    2. Load the game
    3. Open a test world with cheats enabled
    4. Type Type /swem summon LEGACY
      → Your pack should be listed in the options
      → It may be above or below the default default swem: options
      → If your pack is not listed, you have made an error
    5. Select your coat and enter the command
    6. Check the coat has the expected texture.

If this worked as expected, you can repeat Step 1 + 2 to add additional coats to the pack.

[EXPAND] Troubleshooting Errors

     COMMUNITY PACK TROUBLESHOOTING TROUBLESHOOTING    
FOLLOW EACH STEP CAREFULLY + NOTE ISSUES AS YOU GO. ONLY REQUEST HELP AFTER USING THIS!

⮞ [1] MOD VERSION

  • Double check you are using the latest 1.20.1 Beta version.
      Even if you feel sure, go and check it. It's the most common error!
    Curseforge App Will not auto-install beta files, go to mod's page > versions > install
      Multiplayer Servers Check server is on latest release
      Multiplayer Users Check client + server use same version
    ⚠️ Community Packs are for 1.20.1-1.5 and above only.

[2] OFFICIAL COMMUNITY PACK VERSION

  • Skip this step if you are not using the official Community Pack.
      Check you have swem_community_pack_beta_5 or above.
      Check this is the latest version posted - it may have a new release!
      Multiplayer Servers Check server has the correct pack
      Multiplayer Users Check clients have the same pack name + contents as server

⮞ [3] COMMUNITY PACK LOADING

  • Open the game and load into a world
  • Type Type /swem summon LEGACY
      Is the pack listed?  
      Is Is any any pack listed (excluding swem:)

    ✅ Pack(s) are recognized
      Pack(s) are not recognized, specific packs are invalid or have no valid files. Go to solutions [3].

⮞ [4] COAT REGISTERED

  • Type Type /swem summon LEGACY packname:
      Is the coat(s) you expect to see listed? Example  kofi_coats:spirit_arishant_legacy

    ✅ Coat(s) have registered.
      Coats have not registered OR specific coat(s) are invalid.  Go to solutions [4].

⮞ [5] JSON -> TEXTURE PATH

  • Summon coat(s) from the pack
      Do coat(s) have a texture that is correct for that horse?

    ✅ Coat(s) have the correct texture
    Black Texture Texture path or file name is invalid or missing. Go to solutions [5].
              Multiplayer Player is missing the pack or no texture for that coat path. Go to solutions [5].
    Wrong Coat Texture path or file name is incorrect. Go to solutions [4].
    Looks Wrong Texture or UV map error. Contact Coat Artist or request help.

⮞ [6] OTHER

  • Lapis Cycling
    If you cannot cycle cycle any coats using lapis or redstone, it is disabled in server config.
      If you can cycle coats, but some options are missing, it is disabled in the coat .json file.
  • White Texture  
      If a coat is white, the pack or coat .json files were removed or renamed
      If that is not the case, information in .json may have an error (invalid format) Go to solutions [5].
  • Texture Error
      If a coat appears broken (color in wrong places, missing pixels, marker blocks) it needs a texture or UV fix.
      If you are not the coat artist, contact the original creator.
  • Error On Load / Crashing  
    Too many potential causes
      
    Paste your your latest.log log file in Tech Help in our Discord with a description of the issue(s).


     SOLUTIONS & SUGGESTIONS SUGGESTIONS    
ALWAYS SHUT DOWN THE GAME + RELOAD AFTER MAKING CHANGES

It is not recommended to modify packs from a Creator Creator unless you intend to customize it and solve any issues.
✅ You should follow this troubleshooting guide to identify your likely issue first.
✅ You should notify Creator's of potential problems with the the default pack (might need a fix or update).
  You should NOT expect Creator's to troubleshoot an issue you might have caused by altering files!

⮞ ISSUE [3]

  • Check the community pack:
    → Pack is directly in in config > swem > community-packs  
    → Pack is a folder and not a zip file!
      
    Pack has a valid valid lowercase lowercase name with no spaces  artist_kofi   Artist Kofi Coats
      Pack includes at least one .json and .png file in the correct folder
          📁 jsons > 📁 coats > JSON FILES HERE
          📁 textures > 📁 coats > 📁 legacy > PNG FILES HERE

    If this is is ALL correct the issue is not the community pack structure.  Go back to Step [4] above.

⮞ ISSUE [4]

  • Identify a coat that is missing in game
  • Check the .json file for the coat
    → File is listed as a JSON File type
    → File is directly in community-packs > artist_packname > jsons > coats
    → File has a valid valid lowercase lowercase name with no spaces  coatname_artist   Coat - Artist
    → File texture path uses ✅ "legacy": "legacy/coatname_artist.png" ❌   "legacy": "default:legacy/

    If this is correct, the most likely issue is formatting (invalid json).
    → Compare your json to the template and note any missing " , or or { } or different indentation
    → If unsure, delete and rewrite the .json file using a blank template
    → Reload the game and repeat Step [4] above.

    If this is is ALL correct or changes did not work,  paste your your .json file in Tech Help in our Discord

⮞ ISSUE [5]

  • Identify a coat with a black (missing) texture
  • Check the the .json file for the coat
    → File uses uses legacy model line (not any for future models)
    → File texture path uses ✅ "legacy": "legacy/coatname_artist.png" ❌   "legacy": "default:legacy/
    → File texture path has the exact name used by the coat texture .png file

  • Check the .png file for the coat
    → File is listed as a PNG File type
    → File is directly in community-packs > artist_packname > textures > coats > legacy
    File File has a valid valid lowercase lowercase name with no spaces  coatname_artist   Coat - Artist

  • MULTIPLAYER SERVERS
    → Client (player) has community pack(s) with the same name (ID) as those on the server.  
    → Client (player) has .png files with the same names as those in the server pack.

    If you cannot check this due to permissions, you will need to contact server admins.

⮞ [6] OTHER OR NOTHING WORKED

  • Create a post in in Tech Help in our Discord
    → Describe your issue(s) and what you have tried
    → Upload your latest.log file to provide info that may help others assist you

    DO NOT UPLOAD PAID/PRIVATE PACKS WITH TEXTURES FROM CREATORS WITHOUT CONSENT


    Adding Custom Tack

    This guide will not cover how to create tack, for information please read our our   [RESOURCES]   on Discord.

    [EXPAND] Files & Naming Format

    This is the standard format used in the Beta pack. It is recommended to use a consistent naming format as shown here.

    Type Texture + Name Comment
    Bridle name_bridle_icon
    Inventory Icon
    name_bridle_legacy
    Horse Texture
    name_bridle_bit_legacy Horse Texture Texture 
    rack_bridle_name_blanket
    Bridle Rack Texture
    Blanket
    name_blanket_icon
    Inventory Icon
    name_blanket_legacy
    Horse Texture
    rack_saddle_name_blanket
    Saddle Rack Texture
    rack_saddle_5_name_blanket Blanket Rack (5X) Texture
    Saddle name_saddle_icon
    Inventory Icon
    name_saddle_legacy Horse Texture
    rack_saddle_name_saddle Saddle Rack Texture
    rack_horse_armor_name_saddle
    ? ?
    Girth Strap name_girth_strap_icon
    Inventory Icon
    name_girth_strap_legacy
    Horse Texture
    rack_saddle_name_girth_strap
    Saddle Rack Texture
    Breast Collar
    name_breast_collar_icon
    Inventory Icon
    name_breast_collar_legacy
    Horse Texture
    Leg Wraps
    name_leg_wraps_icon
    Inventory Icon
    name_leg_wraps_legacy
    Horse Texture Texture Optional (Pick One)
    name_leg_wraps_hoof_legacy Horse Texture Optional (Pick One)
    Saddlebag
    name_saddle_bag_icon
    Inventory Icon
    name_saddle_bag_legacy
    Horse Texture
    Horse Armor name_horse_armor_icon
    Inventory Icon
    name_horse_armor_legacy
    Horse Texture
    name_horse_armor_wings_legacy Horse Texture Optional (Default: Amethyst Tier)
    rack_horse_armor_name_horse_armor Armor Rack Texture
    Halter name_halter_icon
    Inventory Icon
    name_halter_legacy
    Horse Texture
    rack_halter_lead_name_halter
    Lead Rack Texture
    Pasture Blanket
    name_pasture_blanket_icon Inventory Icon Optional (One or Both)
    name_pasture_blanket_armored_icon
    Inventory Icon Optional (One or Both)
    name_pasture_blanket_legacy Horse Texture Optional (One or Both)
    name_pasture_blanket_armored_legacy
    Horse Texture Optional (One or Both)
    rack_pasture_blanket_3_short_name Pasture Blanket Rack (3X) Texture
    rack_pasture_blanket_5_long_name Pasture Blanket Rack (5X) Texture

      STEP ONE:   CREATE OR DOWNLOAD TACK ICONS

    This is the icon that will display in inventory slots of when held in hand. Each tack item needs ONE icon.

    1. Save or rename the files as as name_type_icon
      → Name should relate to in-game name. Example Midnight Saddle →  midnight_saddle_icon
      → Type should match a valid tack type Example Example midnight_blanket_icon  midnight_girth_strap_icon
      → The file type should display as as PNG File
      → Icons should be default 16 x 16 pixels
    2. Paste this file into your community pack artist_packname > textures > tack > [type] > name_type_icon.png
      → Type should use the relevant folder Example Midnight Saddle →  textures > tack > saddle

      STEP TWO:   CREATE OR DOWNLOAD TACK TEXTURES

    This is the texture for the tack on the horse. Note, there are a few optional variations:

    • Bridles need a texture for both the 2D components and the 3D bit.
    • Leg wraps support leg_wraps for western (legs only) or leg_wraps_hoof for english (hoof and ear bonnet coverage)
    • Horse armor has horse_armor for default tiers up to diamond and horse_armor_wings for default amethyst tier
      → Custom armor can support wings without being amethyst tier, or non-winged armor at amethyst tier.
    • Pasture Blanket has has pasture_blanket (cosmetic only) and pasture_blanket_armored with amethyst tier armor protection.
    1. Save or rename the files as as name_type_artist or or name_type_legacy_artist
      → Name and Type means the same as in Step One.
      → Legacy is optional, but recommended to indicate it is for the original horse model.
      → The file type should display as as PNG File
    2. Paste this file into your community pack artist_packname > textures > tack > [type] > name_type_artist.png
      → Type means the same as in Step One.

      STEP THREE:    CREATE OR DOWNLOAD RACK TEXTURES

    This is the texture for the tack on compatible storage racks. Not all tack supports rack storage.

    • Bridles and halters can be stored on Bridle Racks  rack_bridle  
    • Halters can be stored on Halter & Lead Racks rack_halter_lead
    • Blankets (Saddle Pads) can be stored on on Blanket Racks  rack_saddle_5
    • Saddles, Blankets (Saddle Pads) and Girth Straps can be stored on on Saddle Racks  rack_saddle
    •   [TBC]    Saddles and Horse Armor can be stored on on Armor Racks  rack_horse_armor
    • Pasture Blankets can be stored on Pasture Blanket Racks rack_pasture_blanket_3_short  rack_pasture_blanket_5_long
    • Breast Collars, Leg Wraps and Saddle bags do not support any tack storage racks.

      [TBC]   Rack textures are default for blankets (saddle pads), girth straps and pasture blanket.

    •  [TBC]  They usecan support a defaultpremade grayscale texturetemplate with a color overlay specified in the tack .json file.overlay.
    • ThisThe texture template can be foundcopied in from assets > swem > textures > block
    • The color code (RGB code) is specified in the tack .json file 
    • You can make a custom texture instead; retexture the template.
    • If you create a custom texutre, use [255, 255, 255] (white) overlay in .json to disable the overlay.
    • If you create a custom grayscale texture, use the RGB color overlay as normal.

      [TBC]   Rack textures are custom for for bridles, halters, saddles and horse armor.

    •   [TBC]   They use a modified version of the horse tack texture.
    •   [TBC]   This can be found in...
    1. Save or rename the files as racktype_name_type
      → Name and Type means the same as in Step One.
      → Rack Type means the compatible storage type (see list above)
      → The file type should display as as PNG File
    2. Paste this file into your community pack
        artist_packname > textures > tack > [type] > racktype_name_type_artist.png
      → Type means the same as in Step One.

      STEP FOUR:   CREATE JSON FILE(S)

    This is the information file that registers custom tack as an item in game, and specifies its properties.

    1. Open a blank text editor file using Notepad (Windows) or or [MAC ALTERNATIVE]
    2. Copy the template code for your tack item (below)
    3. Edit the template to your coat
      → You only need to edit the BOLDED PURPLE text - leave the rest unless you know what you're doing!
        credits the name of the texture artist(s) "credits": "Arishant",  
        inspiration optional notes on inspiration or reference "inspiration": "Midnight Tack Set",  
        token   TBC   TBC
      amount number of tokens required to purchase at EQ shop "amount": 2
      name item name (ID) in lowercase letters "name": "midnight_bridle"
      icon texture path for the inventory icon "icon": "bridle/midnight_bridle_icon.png"
      type the tack type and tack slot it is equipped in "type": "bridle"
      model_type if it is western or english tack (specific items) - input ONE type "model_type": "western"
      → color RGB color code overlay for rack textures (specific items) "color": [0, 51, 102], <- Dark Blue
           Note:  Custom rack textures should use a white overlay [255, 255, 255] to not alter colors.
      tier tier of horse armor (inherits the benefits of all previous tiers) ✅ "tier": "amethyst"
           Note:  Valid tiers are cloth > leather > copper > iron > gold > diamond > netherite > amethyst
      can_wear_armor if it supports armor equipping (specific items) - set to true or false "can_wear_armor": false textures texture path for the horse texture "bridle": "bridle/midnight_bridle_bit_legacy.png"
              Note:     The path and textures required vary by tack type - only modify the template where shown!  
      rack texture path for tack storage racks (specific items) "bridle": "bridle/rack_bridle_name_bridle.png"
              Note:     The path and supported storage racks vary by tack type - only modify the template where shown!  
    4. Save the file as a .json file by using using save as and naming the file file name_type.json
      → Use the Files & Naming Format guide (above)
      → The file type should display as as JSON File    
    5. Paste this file into your community pack artist_packname > jsons > tack > [type] > name_type.json
      → Type should use the relevant folder Example Midnight Bridle → textures > tack > bridle
    6. Repeat for all items
    [EXPAND] Bridle Template

    {
       "display": {
          "name": "Name Bridle",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 2
       },
       "meta": {
          "name": "name_bridle",
          "icon": "bridle/name_bridle_icon.png",
          "type": "bridle",
          "data": {
              "model_type": "western / english (select one)",
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "bridle": "bridle/name_bridle_bit_legacy.png",
                      "halter": "bridle/name_bridle_legacy.png"
                  }
              },
              "rack": {
                  "bridle": "bridle/rack_bridle_name_bridle.png"
              }
          }
       }
    }

    [EXPAND] Blanket Template (Saddle Pad)

    {
       "display": {
          "name": "Name Blanket",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 2
       },
       "meta": {
          "name": "name_blanket",
          "icon": "blanket/name_blanket_icon.png",
          "type": "blanket",
          "data": {
              "color": [255, 190, 0],
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "blanket": "blanket/name_blanket_legacy.png"
                  }
              },
              "rack": {
                  "saddle": "blanket/rack_saddle_name_blanket.png",
                  "blanket_5": "blanket/rack_blanket_5_name_blanket.png"
              }
          }
       }
    }

    [EXPAND] Saddle Template

    {
       "display": {
          "name": "Name Saddle",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 3
       },
       "meta": {
          "name": "name_saddle",
          "icon": "saddle/name_saddle_icon.png",
          "type": "saddle",
          "data": {
              "model_type": "western / english (select one)",
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "saddle": "saddle/name_saddle_legacy.png"
                  }
              },
              "rack": {
                  "saddle": "saddle/rack_saddle_name_saddle.png",
                  "horse_armor": "saddle/rack_horse_armor_name_saddle.png"
              }
          }
       }
    }

    [EXPAND] Girth Template

    {
       "display": {
          "name": "Name Girth Strap",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 1
       },
       "meta": {
          "name": "name_girth_strap",
          "icon": "girth_strap/name_girth_strap_icon.png",
          "type": "girth_strap",
          "data": {
              "color": [255, 190, 0],
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "girth_strap": "girth_strap/name_girth_strap_legacy.png"
                  }
              },
              "rack": {
                  "saddle": "girth_strap/rack_saddle_name_girth_strap.png"
              }
          }
       }
    }

    [EXPAND] Breast Collar Template

    {
       "display": {
          "name": "Name Breast Collar",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 1
       },
       "meta": {
          "name": "name_breast_collar",
          "icon": "breast_collar/name_breast_collar_icon.png",
          "type": "breast_collar",
          "data": {
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "breast_collar": "breast_collar/name_breast_collar_legacy.png"
                  }
              },
              "rack": {
                  "blanket": ""
              }
          }
       }
    }

    [EXPAND] Leg Wraps Template

    {
       "display": {
          "name": "Name Wraps",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 2
       },
       "meta": {
          "name": "name_leg_wraps",
          "icon": "leg_wraps/name_leg_wraps_icon.png",
          "type": "leg_wraps",
          "data": {
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "leg_wraps": "leg_wraps/name_leg_wraps_legacy.png",
                      "hoof": "leg_wraps/name_leg_wraps_hoof_legacy.png"
                  }
              },
              "rack": {
                  "blanket": ""
              }
          }
       }
    }

    [EXPAND] Saddle Bag Template

    {
       "display": {
          "name": "Name Saddle Bag",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 5
       },
       "meta": {
          "name": "name_saddle_bag",
          "icon": "saddle_bag/name_saddle_bag_icon.png",
          "type": "saddle_bag",
          "data": {
              "color": [255, 190, 0]
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "saddle_bag": "saddle_bag/name_saddle_bag_legacy.png"
                  }
              },
              "rack": {

              }
          }
       }
    }

    [EXPAND] Horse Armor Template

    {
       "display": {
          "name": "Name Horse Armor",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 10
       },
       "meta": {
          "name": "name_horse_armor",
          "icon": "horse_armor/name_horse_armor_icon.png",
          "type": "horse_armor",
          "data": {
              "tier": "amethyst"
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "armor": "horse_armor/name_horse_armor_legacy.png",
                      "wings": "horse_armor/name_horse_armor_wings_legacy.png"
                  }
              },
              "rack": {
                  "horse_armor": "horse_armor/rack_horse_armor_name_horse_armor.png"
              }
          }
       }
    }

    [EXPAND] Halter Template

    {
       "display": {
          "name": "Name Halter",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 2
       },
       "meta": {
          "name": "name_halter",
          "icon": "halter/name_halter_icon.png",
          "type": "halter",
          "data": {
              "color": [255, 190, 0],
              "can_wear_armor": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "halter": "halter/name_halter_legacy.png"
                  }
              },
              "rack": {
                  "halter_lead": "halter/rack_halter_lead_name_halter.png"
              }
          }
       }
    }

    [EXPAND] Pasture Blanket Template

    {
       "display": {
          "name": "Name Pasture Blanket",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 3
       },
       "meta": {
          "name": "name_pasture_blanket",
          "icon": "pasture_blanket/name_pasture_blanket_icon.png",
          "type": "pasture_blanket",
          "data": {
              "color": [255, 190, 0]
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "pasture_blanket": "pasture_blanket/name_pasture_blanket_legacy.png"
                  }
              },
              "rack": {
                  "pasture_blanket_long_5": "pasture_blanket/rack_pasture_blanket_long_5_name.png",
                  "pasture_blanket_short_3": "pasture_blanket/rack_pasture_blanket_short_3_name.png"
              }
          }
       }
    }

    [EXPAND] Armored Pasture Blanket Template

    {
       "display": {
          "name": "Armored Name Pasture Blanket",
          "credits": "Artist(s)",
          "inspiration": "N/A"
       },
       "cost": {
          "token": "TBC",
          "amount": 5
       },
       "meta": {
          "name": "name_pasture_blanket_armored",
          "icon": "pasture_blanket/name_pasture_blanket_armored_icon.png",
          "type": "pasture_blanket",
          "data": {
              "color": [255, 190, 0],
              "is_armored": true
          },
          "textures": {
              "horse": {
                  "legacy": {
                      "pasture_blanket": "pasture_blanket/name_pasture_blanket_armored_legacy.png"
                  }
              },
              "rack": {
                  "pasture_blanket_long_5": "pasture_blanket/rack_pasture_blanket_long_5_name.png",
                  "pasture_blanket_short_3": "pasture_blanket/rack_pasture_blanket_short_3_name.png"
              }
          }
       }
    }

      STEP FIVE:   TEST YOUR COMMUNITY PACK

      1. Paste the community pack file in in config > swem > community-packs
        → Read here if this is your first time installing a community pack.
      2. Load the game
      3. Open a test world with cheats enabled
      4. Place an EQ Shop Block
      5. Give yourself some tokens tokens 
        → Choose a type that is a valid currency for your tack (as specified in .json)
      6. Place the tokens into the input slot
      7. Check your tack items display and can be purchased
      8. Check the tack item has the correct inventory icon
      9. Check the tack can be equipped and:
        → The tack has the expected texture
        → The tack has the expected features (ie supports armor if it should, armor tier, wings etc)
      10. Check the tack can be placed on supported racks (if relevant) and displays the correct texture
    [EXPAND] Troubleshooting Errors

         COMMUNITY PACK TROUBLESHOOTING TROUBLESHOOTING    
    FOLLOW EACH STEP CAREFULLY + NOTE ISSUES AS YOU GO. ONLY REQUEST HELP AFTER USING THIS!

      COMING SOON SOON 


    Adding Custom Animations

    This guide will not cover how to create tack, for information please read our  [RESOURCES]  on Discord.

    1. Create your custom animations in blockbench
    2. Create an animation resource pack
      → Replace assets > swem > animations > swem_horse.json with a custom animation file
      → This must include all the existing animations and any new animations
    3. Install the resource pack in the resourcepack folder 
    4. Use /swem rrp anim <Animation Name> to trigger the animation

    Additional information:

    • Animations cannot be triggered via keys (like gaits) but must use a command.
      → Default animations can still be replaced if you want to override gaits
    • Animations will loop until the command is re-run to stop it.
    • All clients (players) must install the resource pack to view triggered animations
    •  TBC  Multiplayer Servers

    Resources

      COMING SOON SOON 


    Credits

    Thanks to the following contributors:

    • Quarris for their template dev pack and feature documentation
    • Jenny & Neehra for input on creating tack (resources coming soon)