Better Crates/LootBox

Better Crates/LootBox – Animated Loot Boxes

Better Crates/LootBox adds configurable loot boxes with multiple opening styles (CSGO roll, flash grid, and wheel), full rarity tiers, and real item rewards. It’s designed to be immersive, customizable, and server-friendly.

---

KNOW ISSUE:

• SOME CHEST DON'T WANT TO BE BIND! Please destroy it than replace it!

---

---

✨ Key Features

✨ Custom background animation on opening!

Can be disabled here: Config,json "OpeningAnimation": false,

🎁 M ulti language support!

Supported languages: en-US, fr-FR, es-ES, pt-BR, ru-RU, de-DE

Configuration in Config.yaml

---

🎁 Multiple Opening Styles

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

---

• ✨11 LootBox Chests Models and 7 LootBox Key Models

---

🛠️ In-Game Editor
Edit loot boxes directly in the UI, including opening style, tiers, and rewards.

/lootbox editor

---

🎨 Custom Key Items made:
id: key1, key2, key3, key4, key5, key6, key7
Use them for security purpose!

---

🗝️ Full Rarity Support
Common → Unique tiers with custom backgrounds.

---

📦 Real Item Rewards
Uses real Hytale item IDs for consistent loot tables.

---

⚙️ Configurable Boxes
Define multiple loot boxes, keys, tiers, rewards, weights, and styles.4

GilloDaby_BetterLootbox/config.json

---

🔒 Anti Dupping System!
Each key have a unique ID that is save in trackkey.yaml!
You can track:
who give the key | the Unique ID | LootBoxID | Receiver | Used/NotUsed

GilloDaby_BetterLootbox/trackkey.yaml

A key used can not be used again!

---

🔒 Individual inventory stockage!

Each player has is own key inventory! In case that you are full and buy key it will be send there

/lootbox inventory

---

👮 Admin Panel

/lootbox admin and /lootbox admininventory

---

✨Lootbox Preview

---

✨Lootbox ShopCommand: /lootbox shop
Use in placeholder: %economy% or {money} or %balance% or %coins%

---

💽Database Support!

You can connect you lootbox configuration file to a database! Key, keyinventory, Crate are sync between server! Usefull for better management!

---

✨ Opening Sound and Effect
When a player open a chest a sound is played for the user also firework animation appear on the box location

---

🚀 Lightweight & Server-Friendly
Optimized animations with smooth timing and minimal overhead.

---

✅ Commands

Base command: /lootbox

/lootbox list

Permission: none
Description: Displays all existing lootboxes and their types.
Example: /lootbox list

Permission: noneDescription: Open the player inventoryExample: /lootbox inventory

/lootbox create <id> <random|preview|tier>

Permission: betterlootbox.admin
Description: Creates a new empty lootbox.
Example: /lootbox create starter random

/lootbox delete <id>

Permission: betterlootbox.admin
Description: Deletes an existing lootbox.
Example: /lootbox delete starter

/lootbox givekey <player> <box> <amount>/lootbox givekeyall <box> <amount>

Permission: betterlootbox.givekey
Description: Gives a lootbox key to a player.
Example: /lootbox givekey Steve roll 3

/lootbox givekeyinventory <player> <box> <amount>

Permission: betterlootbox.givekeyinventory
Description: Gives a lootbox key in a player key storage.
Example: /lootbox givekeyinventory Steve roll 3

/lootbox open <box>

Permission: betterlootbox.open.<boxId>
Description: Opens a lootbox if the player has a key.
Example: /lootbox open roll/lootbox shop

Permission: betterlootbox.buyDescription: Open the lootbox key shopExample: /lootbox shop

/lootbox preview <box>

Permission: none
Description: Previews lootbox rewards without consuming a key.
Example: /lootbox preview roll

/lootbox editor

Permission: betterlootbox.admin
Description: Opens the UI editor to manage lootboxes, tiers, rewards, and styles.
Example: /lootbox editor

/lootbox bind <box>

Permission: betterlootbox.admin
Description: Binds a lootbox to a world chest.
Example: /lootbox bind roll (then click the chest)

/lootbox unbind <box>

Permission: betterlootbox.admin
Description: Removes a lootbox chest binding.
Example: /lootbox unbind roll (then click the chest)

/lootbox reload

Permission: betterlootbox.admin
Description: Reloads the configuration without restarting the server.
Example: /lootbox reload

/lootbox save

Permission: betterlootbox.admin
Description: Give access to everything
Example: /lootbox (allcommand)

---

✅ Permissions

• betterlootbox.admin
  Create, delete, editor, bind/unbind, reload, save
• betterlootbox.givekey
  Give lootbox keys to players
• betterlootbox.open.<boxId>
  Give acces to the rank to open the box
• betterlootbox.open.*
  Give acces to the rank to open the all the box
• betterlootbox.buy
  Give acces to /lootbox shop

---

Customize opening background:
Replace the picture inside the jar in:

Roll: 520×260
Flash: 720×420
Wheel: 900×680
Slot: 700×360
Number: 560×320
Ladder: 900×480

---

🔑 Installation

• Drop BetterLootBox.jar into your server’s Mods folder
• Restart the server
• Configure your boxes in config.json or the in-game editor
• Configure your language in config.yaml!

---

ℹ️ Mod Information

Developer: GilloDaby
Compatibility: Hytale Server API (Java)
Version: 5.1.0