🎁 Better Crates / LootBox – Animated Loot Boxes

Better Crates/LootBox adds fully configurable loot boxes to your Hytale server with multiple opening styles, rarity tiers, and real item rewards.

Designed to be immersive, customizable, and server-friendly, this plugin brings a complete loot box experience to your players.

---

✨ Key Features

🎬 Animated Openings

• Custom background animation when opening loot boxes
• Can be disabled in config.json:

"OpeningAnimation": false

---

🌍 Multi-Language Support

Supported languages:

• en-US
• fr-FR
• es-ES
• pt-BR
• ru-RU
• de-DE

Configured in config.yaml

---

🎁 Multiple Opening Styles

Choose from a wide variety of opening animations:

• 🎯 Roll (roll)
• 🔫 CSGO Roll (csgo)
• ⚡ Flash Grid (flash, grid)
• 🎡 Wheel / Roulette (wheel, roulette)
• 🎰 Slot Machine (slot, slots)
• 🔢 Guess The Number (number, guess)
• 🪜 Ladder / Tower (ladder, tower)
• 🕯️ Ritual
• 💥 Fracture
• 🔐 Decrypt
• ☄️ Meteor

---

🎨 Models

• 11 LootBox chest models
• 7 key models

---

🛠️ In-Game Editor

Edit everything directly in-game:

• Opening styles
• Tiers
• Rewards

Command:

/lootbox editor

---

🔑 Custom Key Items

Custom keys with unique IDs:

key1 → key7

Useful for security and tracking

---

🗝️ Full Rarity System

• Common → Unique tiers
• Custom backgrounds per rarity

---

📦 Real Item Rewards

Uses real Hytale item IDs for consistent and reliable loot tables.

---

⚙️ Fully Configurable

Define:

• Loot boxes
• Keys
• Tiers
• Rewards
• Drop weights
• Opening styles

Config file:

GilloDaby_BetterLootbox/config.json

---

🔒 Anti-Duplication System

Each key has a unique ID stored in:

GilloDaby_BetterLootbox/trackkey.yaml

Track:

• Who gave the key
• Unique ID
• LootBox ID
• Receiver
• Usage status

👉 A used key cannot be reused

---

📦 Key Storage System

• Each player has their own key inventory
• Prevents item loss when inventory is full

Command:

/lootbox inventory

---

👮 Admin Panel

• /lootbox admin
• /lootbox admininventory

Includes:

• Lootbox preview
• Lootbox shop

---

🛒 Lootbox Shop

Command:

/lootbox shop

Supported placeholders:

• %economy%
• {money}
• %balance%
• %coins%

---

💽 Database Support

• Sync lootboxes, keys, and inventories across servers
• Ideal for network setups

---

🔊 Effects & Sounds

• Sound effects when opening
• Firework animations at chest location

---

🚀 Performance

• Lightweight
• Optimized animations
• Minimal server impact

---

✅ Commands

Base command:

/lootbox

Player Commands

• /lootbox list → List all lootboxes
• /lootbox inventory → Open key inventory
• /lootbox open → Open a lootbox
• /lootbox preview → Preview rewards
• /lootbox shop → Open shop

---

Admin Commands

• `/lootbox editor