Loot Chest

Overview

Loot Chest Plugin brings an exciting reward system to your Hytale server! Players can open virtual loot chests with a satisfying casino-style roulette animation that scrolls through potential rewards before landing on their prize.

Server administrators have full control over:

Which items appear in each rarity tier

How many chests each player can open

Drop chances for every reward

Perfect for minigames, survival servers, reward systems, or any server looking to add an engaging loot mechanic!

Features

Roulette Animation

Smooth scrolling animation showing 9 item slots

Items gradually slow down before stopping on the final reward

Satisfying sound effects during the spin

Clean custom UI that doesn't interfere with gameplay

Five Rarity Tiers

Each tier has its own separate loot table with customizable rewards:

Tier Color Description

Common Gray Basic items, higher drop rates

Uncommon Green Intermediate items

Rare Blue Less common items

Epic Purple Valuable items

Legendary Gold The rarest and most valuable rewards

Player Balance System

Each player has a personal balance of loot chests per rarity

Balances persist across server restarts

Admins can give or remove chests from players

Players can check their own balance anytime

Admin Panel

Beautiful in-game UI for configuring loot tables

Add, edit, or remove rewards with a few clicks

Search through all available items with the built-in search bar

Set precise drop chances (percentage-based system)

View all player balances in a dedicated admin panel

Persistent Storage

All configurations saved to JSON files

Player balances saved per-player (UUID-based)

Automatic saving on server shutdown

Easy to backup and transfer between servers

Commands

Player Commands

Command Description

/lootchest <rarity> Opens a loot chest of the specified rarity

/lc <rarity> Alias for /lootchest

/lootbalance Shows your loot chest balance for all rarities

/lb Alias for /lootbalance

Admin Commands

Command Permission Description

/lootgive <player> <rarity> <amount> lootchest.admin Give loot chests to a player

/lg <player> <rarity> <amount> lootchest.admin Alias for /lootgive

/lootadmin <rarity> lootchest.admin Open the loot table configuration UI

/lootbalances lootchest.admin View all player balances in a UI

/lbs lootchest.admin Alias for /lootbalances

/lootbalance <player> lootchest.admin View another player's balance

Permissions

Permission Description

lootchest.admin Access to all admin commands (give chests, configure loot tables, view all balances)

Note: Opening loot chests (/lootchest) requires no permission - players just need to have chests in their balance.

Configuration

Loot Table Files

Located in plugins/LootChestPlugin/:

lootchest_common.json lootchest_uncommon.json lootchest_rare.json lootchest_epic.json lootchest_legendary.json

Loot Table Format

{ "rewards": [ { "itemId": "Food_Bread", "minQuantity": 1, "maxQuantity": 5, "chance": 15.0 }, { "itemId": "Ore_Iron", "minQuantity": 1, "maxQuantity": 3, "chance": 10.0 } ] }

Player Balance Files

Located in plugins/LootChestPlugin/balances/:

<player-uuid>.json

Each file stores the player's username and their chest count per rarity.

Installation

Download the plugin JAR file

Place it in your Hytale server's plugins folder

Start/restart your server

Configure loot tables using /lootadmin <rarity> or edit the JSON files directly

Give players chests using /lootgive <player> <rarity> <amount>

Usage Example

As an admin:

/lootgive Steve common 10 → Gives Steve 10 Common loot chests /lootgive Steve legendary 1 → Gives Steve 1 Legendary loot chest /lootadmin rare → Opens the Rare tier configuration UI /lootbalances → View all player balances

As a player:

/lootbalance → Check your chest balance /lootchest common → Open a Common loot chest /lc legendary → Open a Legendary loot chest

Bug Reports & Suggestions

Found a bug or have a suggestion? Feel free to reach out!