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,

🎁 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 Shop
Command: /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: none
Description: Open the player inventory
Example: /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.buy
Description: Open the lootbox key shop
Example: /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: 2.0.0