Lootbags

Lootbags (Standalone Mod)

kyuubisoft

A standalone lootbag mod 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 in-game admin panel with definition editor.

:::info Not to be confused with Core Lootbag Templates This is the standalone KyuubiSoft Lootbags mod (KyuubiSoftLootbag.jar) — a full mod with 120 droppable items, NPC/block drop tables, and a reveal animation UI.

KyuubiSoft Core also has a built-in lootbag template system used as reward containers for Achievements and Quests. Those are simpler reward definitions without the drop system, themed families, or reveal page. See Achievement Lootbag Templates for that system. :::

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), Bear_* (all bears), or exact role names
Drop Rate Multiplier: Global dropMultiplier setting for events (e.g. 2.0 = double drop weekend)
Mob drops spawn on the ground at the mob’s death position
Block drops spawn at the broken block’s position

Opening Cooldown

Configurable cooldown between openings (openCooldownMs, default: 1000ms)
Prevents spam-opening of lootbags

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, and click-to-edit detail view with item table, rarity cycle, dupes toggle, and save to `custom_lootbags.json`
Give	Give lootbags to yourself or other players by ID and amount, with bulk rarity give
Drops	Add, edit, and delete drop rules with search filter, edit/update pattern, auto-save on every change
Statistics	Server-wide and per-player stats (total opened, items received, rarity distribution, top 5 lootbags opened)
Settings	Toggle mod enabled, reveal page, mob/block drops; reload and save configs

Catalog Editor (Detail View)

When clicking a lootbag in the Catalog tab, a detail editor opens:

Item Table: Paginated list of all guaranteed and pool items with edit and delete buttons
Add Items: Type toggle (Guaranteed/Pool) + Item-ID, Amount, Weight fields
Edit Items: Click “Edit” to load values into the form, then “Update” to apply changes
Rarity Cycle: Button cycles through Common → Uncommon → Rare → Epic → Legendary
Dupes Toggle: Enable/disable duplicate pool picks
Name & PickCount: Editable text fields
Save: Persists changes to custom/custom_lootbags.json (standard definitions remain unchanged)

Dynamic Tooltips

Rarity-colored tooltips on all lootbag items
Shows rarity label, description, content info, and “Right-click to open” hint

Integrations

Showcase: NPC page opener (showcase_lootbag) with catalog view for showcase servers
Core Admin Menu: Registered in ModMenuRegistry for quick access
DynamicTooltipsLib: Optional integration for enhanced item tooltips

Localization

Full i18n support for all UI labels, status messages, admin commands, and tooltips
Languages: English (en-US), German (de-DE)
Language Detection: Automatic via client language or Core language settings
Manual Override: /lbadmin lang <code> per player (without Core dependency)
Custom language files can be added to the localization/ folder

Commands

Command	Alias	Description
`/kslootbags stats`	`/lb stats`	View your lootbag statistics
`/kslootbags settings animation on\|off`	—	Toggle reveal animation
`/kslootbagsadmin panel`	`/lbadmin panel`	Open the admin panel
`/kslootbagsadmin give <id> [amount]`	`/lbadmin give`	Give a lootbag item
`/kslootbagsadmin edit <id> <prop> <val>`	`/lbadmin edit`	Edit a lootbag definition
`/kslootbagsadmin reload`	`/lbadmin reload`	Reload all configurations
`/kslootbagsadmin list`	`/lbadmin list`	List all registered lootbags
`/kslootbagsadmin preview <id>`	`/lbadmin preview`	Preview lootbag contents
`/kslootbagsadmin lang <code>`	`/lbadmin lang`	Set language (or `auto` to reset)

Requirements

Hytale Server with plugin support
KyuubiSoft Core (optional — for admin menu, language settings, showcase integration)
DynamicTooltipsLib (optional — for enhanced item tooltips)

Configuration

File	Description
`config.json`	Global toggles (enabled, revealPage, drops, cooldown, dropMultiplier)
`configs/lootbags.json`	Standard lootbag definitions (120 items, versioned, never overwritten)
`custom/custom_lootbags.json`	User overrides and edits (merged at load, auto-saved from editor)
`configs/drop_tables.json`	Mob and block drop rules with wildcard patterns
`localization/*.json`	Language files (en-US, de-DE, extensible)
`data/players/*.json`	Per-player statistics (auto-saved)