# Creating and Editing Crates MiguelCrates uses JSON configuration files to define crates. This allows you to easily create new crates or modify existing ones without changing the mod code. ## Location Crate configuration files are located in the `config/migueleconomy/crates/` directory of your Minecraft instance. - **Server/Client**: `config/migueleconomy/crates/` Each crate is a separate `.json` file. The file name determines the unique ID of the crate (e.g., `common.json` -> `common`). ## Crate Structure The basic structure of a crate JSON file is as follows:

{
  "display_name": "My Custom Crate",
  "description": "A description of what's inside.",
  "icon": "minecraft:chest",
  "texture": "miguelcrates:block/common_crate",
  "rewards": [
    ...
  ],
  "obtain": {
    "sources": [
      ...
    ]
  }
}

### Fields | Field | Type | Description | | :--- | :--- | :--- | | `display_name` | String | The name shown in GUIs and items. | | `description` | String | Description text shown in tooltips. | | `icon` | String | The Item ID used to represent the crate (e.g., `minecraft:chest`). | | `texture` | String | Path to the texture for the custom renderer (usually `miguelcrates:block/<name>`). | | `rewards` | List | A list of possible rewards (see below). | | `obtain` | Object | (Optional) Defines how players can get this crate (see below). | ### Simplified Enchantments (Recommended) Instead of using complex NBT strings, you can use the `enchantments` block to add enchantments to an item. This works for both books and tools.

{
    "item": "minecraft:enchanted_book",
    "quantity": 1,
    "enchantments": {
        "minecraft:sharpness": 5,
        "minecraft:unbreaking": 3
    },
    "weight": 10
}

### Advanced NBT For more complex data (attributes, names, etc.), you can still use the `nbt` field.

{
    "item": "minecraft:diamond_sword",
    "nbt": "{display:{Name:'{\"text\":\"Excalibur\"}'}}",
    "weight": 5
}

## Rewards The `rewards` list contains objects defining what players can win.

"rewards": [
  {
    "item": "minecraft:diamond",
    "quantity": 2,
    "weight": 10
  },
  {
    "command": "give @p minecraft:stone 64",
    "weight": 50
  },
  {
    "item": "minecraft:experience_bottle",
    "command": "xp add @p 5 levels",
    "weight": 10
  },
  {
    "item": "migueleconomy:money",
    "nbt": "{MoneyValue:100L}",
    "weight": 20
  }
]

- **`item`**: Resource location of the item (e.g., `minecraft:iron_sword`). If used with `command`, it acts as the icon. - **`command`**: Command to execute. Use `@p` for the player opening the crate. - **`name`**: (Optional) Custom display name for the reward (e.g. "5 Levels of XP"). - **`quantity`**: (Optional, default 1) Number of items to give. - **`nbt`**: (Optional) NBT data string for the item. - **`weight`**: The chance weight. Higher weight = higher chance. - Probability = `weight / total_weight_of_all_rewards` ## Obtain Methods The `obtain` section defines how crates are generated in the world. It contains a list of `sources`. ### 1. Crafting (`craft`) Allows players to craft the crate in a crafting table.

{
  "type": "craft",
  "recipe": {
    "type": "minecraft:crafting_shaped",
    "category": "misc",
    "pattern": [
      "AAA",
      "ABA",
      "AAA"
    ],
    "key": {
      "A": { "item": "minecraft:planks" },
      "B": { "item": "minecraft:chest" }
    },
    "result": {
      "id": "miguelcrates:crate",
      "count": 1,
      "components": {
        "minecraft:custom_data": { "CrateId": "your_crate_id" }
      }
    }
  }
}

### 2. Mob Drops (`kill`) Drops when a specific entity is killed.

{
  "type": "kill",
  "entity": "minecraft:zombie",
  "chance": 0.05
}

- **`entity`**: Entity ID (e.g., `minecraft:creeper`, `minecraft:ender_dragon`). - **`chance`**: Probability from 0.0 to 1.0 (0.05 = 5%). ### 3. Loot Tables (`loot_table`) Injects the crate into vanilla loot tables (chests).

{
  "type": "loot_table",
  "id": "minecraft:chests/simple_dungeon",
  "chance": 0.1
}

- **`id`**: The Loot Table ID to inject into. - **`chance`**: Probability the crate will appear in the chest. ## Example File (`example.json`)

{
  "display_name": "Example Crate",
  "description": "An example configuration.",
  "icon": "minecraft:barrel",
  "texture": "miguelcrates:block/common_crate",
  "rewards": [
    {
      "item": "minecraft:apple",
      "quantity": 5,
      "weight": 50
    },
    {
      "item": "minecraft:golden_apple",
      "weight": 10
    }
  ],
  "obtain": {
    "sources": [
      {
        "type": "kill",
        "entity": "minecraft:skeleton",
        "chance": 0.02
      }
    ]
  }
}