Coats [WIP]

⮞ WHAT IS A COMMUNITY PACK?
Community Packs are folders that include all the files necessary to add NEW assets such as custom coats to SWEM.

⮞ WHAT IS A CONTENT PACK?
Content Packs is another name for a Community Pack. Content Packs generally have less content, or even a single file. On pasting, it will merge into any Community Pack with the same name. 

• Creators can use a single (or multiple) consistent pack names
• Creators can provide updates and fixes to their pack for select or individual files
• Players require fewer overall Community Packs
• Players can easily search in-game by Creator Example: arishant_kofi:
• [OR] Players can easily search in-game by Theme Example: fantasy_mounts: or bays:

⮞ HOW DO I KNOW IF A PACK IS PREMADE (READY TO USE)?
Community Packs should clearly state if they are a ready to use folder, or individual files. If that is not the case:

• Look at the file contents (unzip the file if it comes zipped)
  
  ✅ Must be a folder with a lowercase name. Example: arishant_kofi
  ✅ Must have two folders inside it: json and textures
  ✅ Must have coats inside json and coats > legacy inside textures
  ✅ Must have at least one file inside each folder - only jsons (text file) and png (texture file) in relevant folders
  
  ❌ Individual files in a single folder
  ❌ PNG files in json > coats or JSON files in textures > coats > legacy 
  ❌ Files or folders with spaces, symbols or capital letters

There can still be other errors that prevent a pack working, but this criteria means the pack is set up correctly!

⮞ WHAT IF PACKS HAVE AN IDENTICAL NAME?
It is possible Community Packs mightcould share a generic name like free_coats or kofi_coats.
Generally, this is nonot an issue, but you should be aware:

• The foldersFolders will merge into one that includes the files of each
• The filesFile will not override othersor replace unless they have an identical name
  This is unlikely if Creators use the recommended format of coatname_artist
  Packs with outdated filesThis could replace updated (fixed) files with outdated ones that share the same name
  This could replace optional variant files with alternatives (ie coat with shoes vs coat without

Always check that merged files maintain the correct folder structure and file names are valid (ie not coat_name_copy)

⮞ WHAT IF IT ASKS ME TO REPLACE FILES?
There is no correct answer to this:

• Replacing existing files to update a texture error is usually fine.
• Replacing existing files to update coat info for breeding tags, inspiration info is usually fine.
• Replacing existing files with outdated files could revert changes (replace with pre-fix version)
  If you replace a file with a broken texture or non-functional json, you will need to fix it or re-download the original!

Always read the Creator's Terms Of Use (TOU) as significant non-private alterations or reupload may be prohibited!

⮞ CAN I UPLOAD A COMMUNITY PACK +/- MODIFIED?
PNG FILES The Creator has the right to set and enforce appropriate use of their content.

• You should not modify, distribute or monetize their work without explicit consent
• This willincludes uploading their work in any public platform (ie Discord, for use by a MP server) 

JSON FILES These files are an asset under SWEM and not the sameproperty wayof Creator(s).

• You can re-upload them for free.
  
• You can provide JSON override packs.
  This excludes any modification with false credits, removed credits or unreasonable modification to inspiration.
  This excludes any uploads that includes PNG files without Creator' consent.
  This must comply with any platform or community guidelines (ie no unapproved uploads).

⮞ CAN I RENAME A PACK?
 Multiplayer  No. This may prevent you from seeing any custom coats, even if you have all the correct files.

 Singleplayer  Yes, this can be useful to organize your custom content or use simpler in-game pack IDs. 
You must set a unique lowercase name with no spaces or symbols for the pack to remain valid.

⮞ CAN I RENAME A COAT?
 Multiplayer  No. This may prevent you from seeing any custom coats, even if you have all the correct files.

 Singleplayer  Yes, though this is not recommended.

• Changes must be updated for json and png file, as awell contentas the json texture path.
• The coat will appear white on reload unless provided with alternative files for the previous ID + name.
  

You should continue to use standard naming format coatname_artist with appropriate artist credit by name!

⮞ CAN I EDIT COAT INFORMATION (JSON)?
 Multiplayer  Yes, however:

• Client-side edits will only apply to singleplayer worlds.
• Server-side edits will apply to all players, regardless of their individual pack settings.
  Texture Path Players must replicate this to avoid seeing black horses (missing texture)
  

 Singleplayer  Yes, it is generally safe to modify coat info.

You should not remove or modify Artist credits +/- reference and inspiration comments.

Always read the filesCreator's willTerms mergeOf intoUse one(TOU) pack.significant Thisnon-private isalterations notor areupload problem unless coats have an identical name, but couldmay be annoying when it prohibited!

[?]

FAQs

⮞ PRE-MADE VS INDIVIDUAL FILES
Creators should ideally check their packs and clearly state if it is ready to use. If not, look at the file contents and check it has the correct structure and contents. 
✅ pack_name > json ( > coats) / textures ( > coats > legacy)
❌ Individual files in a single folder
❌ Files or folder names that have spaces, symbols or capital letters

⮞ COMMUNITY PACK VS CONTENT PACK?
These are the same thing, but Content Pack is a term that might be used if it is an 'add-on' to or update an existing pack.

Example: A coat artist uploads all files under a pre-made pack called ArtistName_Kofi. If you download ONE coat, you can install it and play immediately. If you download another coat from the same artist, the files will merge under ArtistName_Kofi so you have TWO coats in one pack. 

If an artist gives every pack a unique name, you will get lots of individual packs instead or one consolidated pack!

If multiple artists use the same pack name (ie kofi_coats) files will merge under one pack unless you rename it first.

⮞ DUPLICATE FILES - REPLACE OR NOT?
There is no correct answer to this, because replacing files can be good or very bad! 

• If a content pack is intended to update coat info or fix a coat error - replacing the original file(s) is expected!
  This could still cause issues for any horse currently using that coat, though same name + info is generally safe.
• If a content pack has an updated (fixed) coat - merging it with an outdated pack may override the fixed version
  

⮞ CAN I RENAME COATS?
Coat names do not display in game, so there is not many reasons to do this, but it is possible. Any changes must be made to both png (coat texture) and json (coat info) as well as texture path. If the coat was in use, it will turn white unless an alternative texture using the original name is available.

Always read the Terms Of Use (TOU) from Creator's as altering coats might fall outside appropriate use for content.