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?
Community Packs could share a generic name like free_coats or kofi_coats.
Generally, this is not an issue, but you should be aware:

• Folders will merge into one that includes the files of each
• File will not override or replace unless they have an identical name
  This is unlikely if Creators use the recommended format of coatname_artist
  This 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 includes 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 property of 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 well as 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 Creator's Terms Of Use (TOU) significant non-private alterations or reupload may be prohibited!