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:

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

Admin Commands

Permissions

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

1. Download the plugin JAR file
2. Place it in your Hytale server's plugins folder
3. Start/restart your server
4. Configure loot tables using /lootadmin <rarity> or edit the JSON files directly
5. 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!