Changelog

Lootbags Changelog

A summary of all notable changes, organized by version.

v1.2.0 (2026-03-20)

Bugfixes

Mob drops were not working — three root causes fixed: wrong ECS archetype query, wrong NPC identifier (getNPCTypeId → getRoleName), and incorrect item spawn method
Drop editor created duplicates — edit now properly removes old entry before adding updated one
Drop editor accepted invalid lootbag IDs — registry validation added
Player lookup used manipulable getDisplayName() — switched to getUsername() for security
.ui crash from duplicate element IDs — orphaned elements removed from LootbagAdmin.ui

Catalog Editor

Click a lootbag in the Catalog tab to open a detail editor
Item table with pagination, edit and delete buttons per item
Add items: Guaranteed/Pool toggle + Item-ID, Amount, Weight fields
Edit items: loads values into form, “Add” becomes “Update”
Rarity cycle button (Common → Uncommon → … → Legendary)
Dupes toggle button
Name & PickCount editable text fields
Save persists changes to custom/custom_lootbags.json

Drops Tab Improvements

Search field — filter drop rules by pattern, lootbag ID, or type
Edit → Update — no more duplicates when editing existing rules
Cancel button for aborting edits
Auto-save — every change saves automatically (manual save button removed)

New Features

Opening cooldown — openCooldownMs config (default: 1000ms)
Drop rate multiplier — dropMultiplier config (default: 1.0) for events
/lbadmin edit command — edit lootbag definitions via command (rarity, dupes, name, picks, gadd, padd, gdel, pdel)
/lbadmin lang command — set language per player without Core dependency

i18n

Complete i18n overhaul — all ~150 hardcoded strings replaced with localization keys
Localization version 3 — auto-updates deployed language files
Language auto-detection from client language as fallback when Core is not installed
Manual language override via /lbadmin lang <code>

v1.1.0 — 2026-03-15

Admin Panel Improvements

Catalog Tab

Rarity Filter — Buttons for All/Common/Uncommon/Rare/Epic/Legendary with instant list filtering
Pagination — 10 items per page with back/forward navigation and page indicator
Detail View — Info button per lootbag shows type (Fixed/Random/Hybrid), items with amounts, pool entries with weights and percentages
Slot-based architecture with pre-created UI slots for stable bindings during filter/page changes

Statistics Tab

Server Statistics — Aggregated values across all online players (total opened, items received, rarity distribution)
Items Received — Total count of received items (personal + server)
Top Lootbags — The 5 most frequently opened lootbag types per player

Give Tab

Single Give — TextField-based input for lootbag ID, player name (optional), and amount
Player Targeting — Leave empty for self, enter a name to give to another online player
Validation — Registry check on lootbag ID, amount 1-64, player search with feedback
Enter Submit — Enter key in the ID field or button click triggers the give action
Bulk Area — Rarity buttons in a separate section for quick bulk gives

Drops Tab

Drop Editor — Add new drop rules directly in the admin panel (mob/block toggle, pattern, lootbag ID, chance %)
Delete Buttons — Each drop rule has a remove button
Pagination — 12 rules per page with navigation
Save Button — Save drop tables as JSON with automatic backup
Enter Submit — Enter key in the pattern field triggers add

Settings Tab

CheckBox Toggles — Mod enabled, reveal page, mob/block drops as native toggles with instant effect
Info Line — Shows count of loaded lootbags and drop rules
Description Texts — Each setting row has an explanatory subtext

Technical

UI design system established with unified colors, styles, and layout patterns
All layout structures defined in .ui files; Java only uses ui.set() and event bindings
Index-based actions (kgive_0, kinfo_0) instead of ID-based for stable bindings during pagination
DropTableConfig extended with addMobDrop(), addBlockDrop(), removeDrop(), save(), getTotalEntryCount()

v1.0.0 — 2026-03-14

Initial Release

120 Lootbag Items — 24 visual themes x 5 rarity tiers (Common, Uncommon, Rare, Epic, Legendary)
Custom Interaction — Right-click to open, sneak+right-click to place as decorative block
Reveal Page — Hytale-native DecoratedContainer UI shows received items with animation
Direct Mode — Player setting to skip animation (items directly to inventory + chat summary)
Rarity Glow — Placed lootbags glow by rarity (Uncommon=green, Rare=blue, Epic=purple, Legendary=gold)
Drop System — Mob and block drops with wildcard support (*, Ore_*, exact match) and per-world config
Dynamic Tooltips — Rarity-colored tooltips on all lootbag items
Player Statistics — Opened lootboxes tracked per rarity, viewable via /kslootbox stats
Showcase Integration — NPC page opener (showcase_lootbox) with catalog view
ks-Editor Integration — Lootbox definitions and drop tables editable in the web editor

Loot Scaling

Common: 1 guaranteed + 1 pick from 3 pool
Uncommon: 2 guaranteed + 2 picks from 4 pool
Rare: 3 guaranteed + 3 picks from 5 pool
Epic: 4 guaranteed + 3 picks from 6 pool
Legendary: 5 guaranteed + 4 picks from 7 pool

24 Theme Families

Default, Linen, Leather, Canvas, Silk, Velvet, Copper, Sandstone, Golden, Emerald, Crystal, Bone, Crimson, Shadow, Mossy, Sakura, Frost, Ocean, Royal, Enchanted, Volcanic, Ancient, Void, Celestial

Commands

/kslootbox settings animation on|off — Toggle reveal animation
/kslootbox stats — View personal lootbox statistics
/kslootboxadmin give <itemId> [amount] — Give a lootbag item
/kslootboxadmin reload — Reload configurations
/kslootboxadmin list — List all registered lootboxes
/kslootboxadmin preview <itemId> — Preview lootbag contents