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,

🎁 Multi 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 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: 5.1.0