# MiguelCrates<\/p>\n
MiguelCrates turns simple item giving into an event. It adds fully animated, exciting lootboxes to your world that hook into your economy and keep players coming back for “just one more spin.”<\/p>\n
—<\/p>\n
## How to Create Your Own Custom Crate<\/p>\n
User the online Crate Builder : https:\/\/miguel-economy-builder.vercel.app\/crate-builder<\/p>\n
OR<\/p>\n
1. **Find the Folder:** Go to your server\u2019s config folder (`config\/migueleconomy\/crates`). # Creating and Editing Crates<\/p>\n 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.<\/p>\n ## Location<\/p>\n Crate configuration files are located in the `config\/migueleconomy\/crates\/` directory of your Minecraft instance.<\/p>\n – **Server\/Client**: `config\/migueleconomy\/crates\/`<\/p>\n Each crate is a separate `.json` file. The file name determines the unique ID of the crate (e.g., `common.json` -> `common`).<\/p>\n ## Crate Structure<\/p>\n The basic structure of a crate JSON file is as follows:<\/p>\n “`json ### Fields<\/p>\n | Field | Type | Description | ### Simplified Enchantments (Recommended) “`json ### Advanced NBT ## Rewards<\/p>\n The `rewards` list contains objects defining what players can win.<\/p>\n “`json – **`item`**: Resource location of the item (e.g., `minecraft:iron_sword`). If used with `command`, it acts as the icon. ## Obtain Methods<\/p>\n The `obtain` section defines how crates are generated in the world. It contains a list of `sources`.<\/p>\n ### 1. Crafting (`craft`)<\/p>\n Allows players to craft the crate in a crafting table.<\/p>\n “`json ### 2. Mob Drops (`kill`)<\/p>\n Drops when a specific entity is killed.<\/p>\n “`json – **`entity`**: Entity ID (e.g., `minecraft:creeper`, `minecraft:ender_dragon`). ### 3. Loot Tables (`loot_table`)<\/p>\n Injects the crate into vanilla loot tables (chests).<\/p>\n “`json – **`id`**: The Loot Table ID to inject into. ## Example File (`example.json`)<\/p>\n “`json —<\/p>\n ## In-Game Commands (Admin)<\/p>\n Use these commands to manage crates.<\/p>\n ### Give a Crate * **Example 1 (Give yourself a Rare Crate):** ### Restore Default Crates ### Reload Config ### Open Menu (Shortcuts) <\/p>\n","protected":false},"excerpt":{"rendered":" Inject excitement into MiguelEconomy with fully customizable, animated loot crates! creating a unique reward system for your server<\/p>\n","protected":false},"featured_media":101114,"template":"","meta":{"_minecraft_slug":"miguelcrates","_minecraft_project_id":"SwuBKi3b","_minecraft_author":"Monsieur-V","_minecraft_license":"MIT","_minecraft_downloads":332,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"miguelcrates.zip","_minecraft_size_bytes":1013195,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T17:09:29.596594Z","_minecraft_date_created":"2025-12-14T03:11:14.488601Z","_minecraft_date_modified":"2026-05-13T20:58:05.297976Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/miguelcrates","_minecraft_icon_attachment_id":101114,"_minecraft_imported_at":"2026-06-05T19:28:10+00:00","_minecraft_import_hash":"c34f81716cbfdfcb544555a8f30c8082","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[43,844,104,89,158,867,92],"mod_loader":[160],"minecraft_version":[36,37],"class_list":["post-101113","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-cursed","mod_category-economy","mod_category-forge","mod_category-game-mechanics","mod_category-neoforge","mod_category-social","mod_category-utility","mod_loader-neoforge","minecraft_version-1-20-1","minecraft_version-1-21-1"],"yoast_head":"\n
\n2. **Copy & Paste:** Take an existing file (like `common.json`) and copy it. Rename it to something like `vip_crate.json`.
\n3. **Edit the Details:** Open it with any text editor (like Notepad).
\n * Change the **Name** to “VIP Crate”.
\n * Pick a **Texture** (color) for how it looks.
\n * **List your Rewards:** Simply type in the items you want (e.g., `”minecraft:diamond”`), how many to give, and how rare they should be.
\n * *Tip: You can even make it run commands (with custom icons!) or give money.*
\n4. **Restart:** Restart your server, and your new crate is ready to be placed!<\/p>\nComple Crate Guide<\/summary>\n
\n{
\n “display_name”: “My Custom Crate”,
\n “description”: “A description of what’s inside.”,
\n “icon”: “minecraft:chest”,
\n “texture”: “miguelcrates:block\/common_crate”,
\n “rewards”: [
\n …
\n ],
\n “obtain”: {
\n “sources”: [
\n …
\n ]
\n }
\n}
\n“`<\/p>\n
\n| :— | :— | :— |
\n| `display_name` | String | The name shown in GUIs and items. |
\n| `description` | String | Description text shown in tooltips. |
\n| `icon` | String | The Item ID used to represent the crate (e.g., `minecraft:chest`). |
\n| `texture` | String | Path to the texture for the custom renderer (usually `miguelcrates:block\/
\n| `rewards` | List | A list of possible rewards (see below). |
\n| `obtain` | Object | (Optional) Defines how players can get this crate (see below). |<\/p>\n
\nInstead of using complex NBT strings, you can use the `enchantments` block to add enchantments to an item. This works for both books and tools.<\/p>\n
\n{
\n “item”: “minecraft:enchanted_book”,
\n “quantity”: 1,
\n “enchantments”: {
\n “minecraft:sharpness”: 5,
\n “minecraft:unbreaking”: 3
\n },
\n “weight”: 10
\n}
\n“`<\/p>\n
\nFor more complex data (attributes, names, etc.), you can still use the `nbt` field.
\n“`json
\n{
\n “item”: “minecraft:diamond_sword”,
\n “nbt”: “{display:{Name:'{“text”:”Excalibur”}’}}”,
\n “weight”: 5
\n}
\n“`<\/p>\n
\n“rewards”: [
\n {
\n “item”: “minecraft:diamond”,
\n “quantity”: 2,
\n “weight”: 10
\n },
\n {
\n “command”: “give @p minecraft:stone 64”,
\n “weight”: 50
\n },
\n {
\n “item”: “minecraft:experience_bottle”,
\n “command”: “xp add @p 5 levels”,
\n “weight”: 10
\n },
\n {
\n “item”: “migueleconomy:money”,
\n “nbt”: “{MoneyValue:100L}”,
\n “weight”: 20
\n }
\n]
\n“`<\/p>\n
\n– **`command`**: Command to execute. Use `@p` for the player opening the crate.
\n– **`name`**: (Optional) Custom display name for the reward (e.g. “5 Levels of XP”).
\n– **`quantity`**: (Optional, default 1) Number of items to give.
\n– **`nbt`**: (Optional) NBT data string for the item.
\n– **`weight`**: The chance weight. Higher weight = higher chance.
\n – Probability = `weight \/ total_weight_of_all_rewards`<\/p>\n
\n{
\n “type”: “craft”,
\n “recipe”: {
\n “type”: “minecraft:crafting_shaped”,
\n “category”: “misc”,
\n “pattern”: [
\n “AAA”,
\n “ABA”,
\n “AAA”
\n ],
\n “key”: {
\n “A”: { “item”: “minecraft:planks” },
\n “B”: { “item”: “minecraft:chest” }
\n },
\n “result”: {
\n “id”: “miguelcrates:crate”,
\n “count”: 1,
\n “components”: {
\n “minecraft:custom_data”: { “CrateId”: “your_crate_id” }
\n }
\n }
\n }
\n}
\n“`<\/p>\n
\n{
\n “type”: “kill”,
\n “entity”: “minecraft:zombie”,
\n “chance”: 0.05
\n}
\n“`<\/p>\n
\n– **`chance`**: Probability from 0.0 to 1.0 (0.05 = 5%).<\/p>\n
\n{
\n “type”: “loot_table”,
\n “id”: “minecraft:chests\/simple_dungeon”,
\n “chance”: 0.1
\n}
\n“`<\/p>\n
\n– **`chance`**: Probability the crate will appear in the chest.<\/p>\n
\n{
\n “display_name”: “Example Crate”,
\n “description”: “An example configuration.”,
\n “icon”: “minecraft:barrel”,
\n “texture”: “miguelcrates:block\/common_crate”,
\n “rewards”: [
\n {
\n “item”: “minecraft:apple”,
\n “quantity”: 5,
\n “weight”: 50
\n },
\n {
\n “item”: “minecraft:golden_apple”,
\n “weight”: 10
\n }
\n ],
\n “obtain”: {
\n “sources”: [
\n {
\n “type”: “kill”,
\n “entity”: “minecraft:skeleton”,
\n “chance”: 0.02
\n }
\n ]
\n }
\n}
\n“`<\/p>\n<\/details>\n
\n` \/miguelcrates give
\n `\/miguelcrates give @p rare`
\n* **Example 2 (Give a player 5 Common Crates):**
\n `\/miguelcrates give PlayerName common 5`<\/p>\n
\n`\/miguelcrates default
\n* **Restores missing or deleted default crates.**
\n* Example: `\/miguelcrates default all` (Restores all 20+ themed crates)
\n* Example: `\/miguelcrates default miner` (Restores just the Miner crate)<\/p>\n
\n`\/miguelcrates reload`
\n* Refreshes the mod if you edited the JSON files while the server was running.<\/p>\n
\n`\/crates`, `\/crate`, or `\/box`<\/p>\n