Lootbags
A lootbag system for Hytale servers featuring 120 collectible lootbag items across 24 themed families and 5 rarities, with configurable mob and block drop tables, an animated reveal page, and a full admin panel.
Features
120 Lootbag Items
- 24 Themed Families: Default (Starter), Linen, Leather, Canvas, Silk, Velvet (Crafting), Copper, Sandstone, Golden, Emerald, Crystal (Mining), Bone, Crimson, Shadow (Combat), Mossy, Sakura (Nature), Frost (Survival), Ocean (Aquatic), Royal, Enchanted (Magic), Volcanic, Ancient (Fire/Antique), Void, Celestial (Endgame)
- 5 Rarities: Common, Uncommon, Rare, Epic, Legendary
- Each family x rarity combination is a unique lootbag item with scaled rewards
Loot Scaling
Each rarity tier builds on the previous with more guaranteed and pool items:
| Rarity | Guaranteed Items | Pool Picks | Pool Size |
|---|---|---|---|
| Common | 1 | 1 | 3 |
| Uncommon | 2 | 2 | 4 |
| Rare | 3 | 3 | 5 |
| Epic | 4 | 3 | 6 |
| Legendary | 5 | 4 | 7 |
Drop System
- Configurable drop tables for both mob kills and block breaks
- Wildcard pattern support:
*(all),Ore_*(all ores), or exact item/mob IDs - Per-world configuration overrides via
worlds/<name>/folder - Drop chance as percentage per rule
Animated Reveal Page
- Hytale-native DecoratedContainer UI shows received items with animation
- Direct Mode available as player setting — skips animation, items go straight to inventory with chat summary
- Rarity-colored glow effect on placed lootbag blocks (Uncommon=green, Rare=blue, Epic=purple, Legendary=gold)
Custom Interaction
- Right-click to open a lootbag
- Sneak + Right-click to place it as a decorative block
- Placed lootbags retain their rarity glow
Admin Panel
A full in-game admin interface with multiple tabs:
| Tab | Description |
|---|---|
| Catalog | Browse all lootbags with rarity filter, pagination (10/page), and detail view showing item contents with drop weights and percentages |
| Give | Give lootbags to yourself or other players by ID and amount, with validation |
| Drops | Add, edit, and delete drop rules (mob/block, pattern, lootbag ID, chance); save with backup |
| Statistics | Server-wide and per-player stats (total opened, items received, rarity distribution, top 5 lootbags) |
| Settings | Toggle mod enabled, reveal page, mob/block drops; shows loaded lootbag and rule counts |
Dynamic Tooltips
- Rarity-colored tooltips on all lootbag items
- Tooltip content reflects the lootbag's theme and rarity
Integrations
- Showcase: NPC page opener (
showcase_lootbox) with catalog view - ks-Editor: Lootbox definitions and drop tables editable in the web editor
Localization
- Full i18n support with per-player language selection
- All UI labels, notifications, and admin panel text localized
Commands
| Command | Alias | Description |
|---|---|---|
/kslootbox settings animation on/off | — | Toggle reveal animation |
/kslootbox stats | — | View your lootbag statistics |
/kslootboxadmin give <itemId> [amount] | lb give | Give a lootbag item |
/kslootboxadmin reload | lb reload | Reload all configurations |
/kslootboxadmin list | lb list | List all registered lootboxes |
/kslootboxadmin preview <itemId> | lb preview | Preview lootbag contents |
Requirements
- Hytale Server with plugin support
- KyuubiSoft Core (for TrackingService, DynamicTooltips, ModMenuRegistry)
Configuration
lootboxes.json— Lootbag definitions (items, pools, weights)drop_tables.json— Mob and block drop rules with patterns and chancesworlds/<name>/— Per-world overrides for both config filescustom/— Additional lootbag definitions merged at load time