Creating A Community Pack [HIDDEN]

• You MUST NOT sell or trade for profit any assets created and owned by SWEM
  → 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
  → Shading layers
  → Free materials: template resource packs, template community packs, json files (not in a working community pack)
  
  
• You can provide FREE content that accepts an OPTIONAL donation
  → Includes modified horse models (ie resource pack override to add-on "breeds")
  → Does not include default coat modifications without explicit permission
  
  
• You MUST NOT modify, re-upload, or sell the work of creators without consent / allowed by TOU.
  → Includes the Official Community Pack (free) featuring donated works from community artists
  
  
• 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 blocks or items
  → Animations 
   * 90% accounts for the 10% which can be accredited to fair inspiration, reference or color picking.
  
  
• You MUST NOT sell, promote or feature SWEM in any custom content or media that includes:
  → Extreme violence or gore
  → 18+ content or mature themes

Star Worm Equestrian is and always will be age appropriate to all users (PG13).
Any content or creators that modify it to be otherwise do so outside the terms of use of this project.

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 not falsely claim.

Avoid 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 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 can/not be used publicly in multiplayer.
  → This creation can/not be used in reasonable commercial 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 creation can/not be reuploaded with/without consent and/or 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 can/not be altered with/without consent and with/without credits for public/private use.
      ✅🚫 Texture
      ✅🚫 Information (json: name, description, color tags etc)
      ✅🚫 Other conditions 

Tokens are a form of currency to exchange for tack pieces. This is so every item does not need a crafting recipe.

• Tokens are redeemed at an EQ Shop block - this displays all purchases possible for the given token.
• You must set a crafting recipe to create tokens at a crafting table.
• You can set a yield of 1-64 tokens per crafting.
• You must create at least one Token Example Creatorname Coin
• You can name them whatever you want; tokens coins, credits etc.
• You can create multiple themed or tiered tokens Example Basic Token Valuable Token
• You can set custom pricing for your items in their individual .json files Example Saddles cost 5 Creator Coins
  

RECOMMENDATIONS
→ Keep tokens to a minimum; each one is a new item added to the game.
→ Set a unique name that is unlikely to be duplicated (confusing to players) such as Yourname Token or Packname Coin
→ Set a recipe that is unlikely to be duplicated with Minecraft recipes or tokens for other creators.
→ Use Content Packs or individual files to 'add-on' to a core pack, rather than creating many individual packs + tokens.

WARNING TO CREATORS (+ SURVIVAL SP / SERVERS THAT USE COMMUNITY PACKS)
→ Removing or renaming tokens will void any currently in game - players that crafted them will lose them!
→ This is why is is recommended to think carefully about what tokens you add and support them long term.

{
  "name": "Example Coin",
  "tokens": {
    "token_1": {
      "texture": "tokens/example_coin.png",
      "recipe": {
        "count": 4,
        "pattern": [
          " R ",
          "ODO",
          " G "
        ],
        "key": {
          "R": {
            "item": "minecraft:redstone"
          },
          "O": {
            "item": "minecraft:obsidian"
          },
          "D": {
            "item": "minecraft:diamond"
          },
          "G": {
            "item": "minecraft:gold_ingot"
          }
        }
      }
    }

pattern refers to the 9 slots in a crafting grid, with each slot being a potential space to place one item.

"pattern": [
          " R ",
          "ODO",
          " G "

Shown above is an example where 5 items are placed in a crafting grid; one slot in top row, three in middle and one bottom row.
Each occupied slot has a letter or symbol that is later defined under key - this says which item that will be.

• The letters you choose do not matter, but they can only specify ONE type of item.
• If a slot is unused, it is recommended to use a space (no letter or symbol)
  → Example: Empty row ✅ " " 
  

"key": {
          "R": {
            "item": "minecraft:redstone"
          },
          "O": {
            "item": "minecraft:obsidian"
          },
          "D": {
            "item": "minecraft:diamond"
          },
          "G": {
            "item": "minecraft:gold_ingot"
          }
        }

Shown above is the  key section which defines those letters; R for redstone, O for obsidian, D for diamond, G for gold ingot.

• Note that each item comes in it's own little code section which is correctly indented (positioned)
• Each letter is defined as ONE specific item, and that item includes the ID minecraft:item_name 
• This would allow you to specify IDs of other mods such as swem:item_name
  → The recipe will not work if it specifies an item the player does not have the mod for, or cannot obtain.
  

Shown: Overlay of json information vs in-game crafting.

"pattern": [
          " / ",
          "# #",
          " / "
        ],
        "key": {
          "/": {
            "item": "minecraft:blaze_rod"
          },
          "#": {
            "item": "minecraft:gold_ingot"
          }
        }

Shown above is another example with four items in the crafting grid; top row middle, middle row left + right, bottom row middle.
This example uses symbols instead of letters, which are less clear but work fine.
The key section states two items, / for blaze rod and # for gold ingot.

  HELPFUL RESOURCES  

JSON files require correct formatting, including indentation (position on the page). If this is confusing, try:

• Editing the example template file provided [DISCORD LINK] 
• Using a recipe generator for datapacks HERE 
  → Search for and drag your items into the crafting grid
  → Scroll down and copy the relevant sections (pattern and key)
  → Recommendation: Copy from "pattern" to the last " for crafting items, such as "minecraft:gold_ingot" 
  → Open your tokens file, select the same points ("pattern" to ") and paste