Skip to main content

Lootbags Changelog

A summary of all notable changes, organized by version.

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