Coats [WIP]

⮞ CAN COMMUNITY PACKS ADD NEW FOAL VARIANTS?
No. The current system allows for 1 foal per color tag; support for additional foals will require an expanded breeding system.  

⮞ CAN COMMUNITY PACKS MODIFY DEFAULT SWEM COATS?
No. Information such as obtainable by breeding, color tags, lapis cycling is hard coded for default coats (included in SWEM).
You can use a resource pack to override any coat texture if you want to replace it.

⮞ CAN COMMUNITY PACKS ADD NEW MODELS?
No. It should continue to work with resource packs that override the SWEM model.
This feature will support the new Destrier model (and any others) when it is released in future.

⮞ CAN CUSTOM COATS APPEAR NATURALLY ON HORSES?
Yes. If the coat information (json) file allows breeding and cycling, it can occur when a horse is summoned or converted.

⮞ CAN CUSTOM COATS NATURALLY SPAWN?
No. Neither default nor custom coats naturally spawn in the wild (replace MC horses) unless you use a custom datapack.

This update has been modified to continue support for Ace's Datapack found found HERE in our Discord.

⮞ CAN CUSTOM COATS SUPPORT LAPIS / REDSTONE CYCLING?
Yes. This must be set to true for for lapis_cycling in the coat json file, and and allowCoatCycling in the server config file.

⮞ CAN CUSTOM COATS APPEAR FROM BREEDING DEFAULT +/- CUSTOM COATS?
Yes. This must be set to true for for obtainable_by_breeding in the coat json file. You must set at least one one base_colors tag - this will determine which color tags your horse can pass on if bred, as well as which foal color(s) can grow up into this coat.

⮞ CAN I MAKE A CUSTOM COAT 'SECRET'?
Yes, but not in the same way as special default coats. You can set   lapis_cycling and obtainable_by_breeding to false in the coat json file, which will prevent cycling and appearance by breeding or converting. The coat will only appear if summoned via command. If you have the right kind of knowledge, you could probably create a custom datapack or redstone system loop to check for and convert horses that meet 'secret coat criteria' (ie height and name), or other crafty ways to achieve this result.  

⮞ WHAT IS A COMMUNITY PACK?
Community Packs are folders that include all the files necessary to add NEW assets and are ready to play once installed.

⮞ WHAT IS A CONTENT PACK?
Content Packs is also a Community Pack, but usually with less content. It will merge into any Community Packs with the same name, like an 'expansion' pack or add-on.

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

 STEP⮞ ONE: [1] GENERATEMOD THEVERSION

FOLDERS
• Double (FIRSTcheck TIMEyou USINGare SWEMusing 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 Beta)and above only.
  

⮞ [2] OFFICIAL COMMUNITY PACK VERSION

• InstallSkip this step if you are not using the modofficial update.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

• LoadOpen the game and load into a world
• Type /swem summon LEGACY
  → Is the pack listed? 
  → Is 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 /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 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 latest.log file in Tech Help in our Discord with a description of the issue(s).
  


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

It is not recommended to modify packs from a 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 default pack (might need a fix or update).
❌ You should NOT expect Creator's to investigate issues you might have caused by altering their original files!

⮞ ISSUE [3]

• Check the community pack:
  → Pack is directly in config > swem > community-packs 
  → Pack is a folder and not a zip file!
  → Pack has a valid 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 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 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 menutemplate screen.and note any missing " , 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 ALL correct or changes did not work, paste your .json file in Tech Help in our Discord

⮞ ISSUE [5]

• Identify a coat with a black (missing) texture
• ExitCheck the game..json file for the coat
  → File 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
  
  

⮞ [6] OTHER OR NOTHING WORKED

[?]

Features