Lootbag Commands

The Lootbags plugin provides two commands: one for players and one for admins.

---

Player Command

/kslootbags

Aliases: /lb, /lootbag

Shows the help message listing available subcommands. No permission required.

/kslootbags stats

View your personal lootbag statistics. Displays:

• Total lootbags opened
• Breakdown by rarity (Common, Uncommon, Rare, Epic, Legendary)
• Total items received
• Top 10 most frequently opened lootbag types

Example output:

--- Lootbag Stats ---
Gesamt geoeffnet: 42
  Common: 20
  Uncommon: 12
  Rare: 6
  Epic: 3
  Legendary: 1
Items erhalten: 156
--- Top Lootbags ---
  Default_Common: 8x
  Golden_Uncommon: 5x
  Shadow_Rare: 3x

/kslootbags settings animation on|off

Toggle the lootbag reveal page animation.

Argument	Value	Description
animation	on / true	Enable the animated reveal page when opening lootbags
animation	off / false	Disable animation — items go directly to inventory with a chat summary

Example:

/kslootbags settings animation off

---

Admin Command

/kslootbagsadmin

Alias: /lbadmin

Shows the admin help message. Requires admin permissions.

/kslootbagsadmin panel

Opens the in-game admin panel UI with tabs for Catalog, Give, Drops, Statistics, and Settings.

/kslootbagsadmin give <itemId> [amount]

Give a lootbag item to yourself.

Argument	Type	Required	Description
itemId	String	Yes	The lootbag item ID (e.g. Default_Common, Golden_Legendary)
amount	Integer	No	Stack size. Defaults to 1.

The item is added to your hotbar/inventory. If your inventory is full, the command will report an error.

Example:

/lbadmin give Golden_Legendary
/lbadmin give Shadow_Epic 5

/kslootbagsadmin reload

Reload all lootbag configurations from disk. This reloads:

• configs/lootbags.json — standard lootbag definitions
• custom/custom_lootbags.json — custom overrides
• configs/drop_tables.json — mob and block drop tables

Reports the number of definitions loaded after reload.

/kslootbagsadmin list

List all registered lootbag definitions. Each entry shows:

• Item ID
• Rarity (color-coded)
• Display name

Example output:

--- Lootbags (120) ---
  Default_Common [COMMON] - Default Lootbag
  Default_Uncommon [UNCOMMON] - Default Lootbag
  Golden_Legendary [LEGENDARY] - Golden Lootbag

/kslootbagsadmin preview <itemId>

Preview the contents of a lootbag definition. Shows:

• Rarity
• Type (Fixed, Random Pool, or Hybrid)
• A simulated opening with the resolved items and amounts

Argument	Type	Required	Description
itemId	String	Yes	The lootbag item ID to preview

Example:

/lbadmin preview Golden_Rare

Example output:

--- Preview: Golden Lootbag ---
Rarity: rare
Type: Hybrid
Simulated contents (6 items):
  10x Gold Ingot
  5x Gold Nugget
  3x Emerald
  1x Diamond
  2x Ruby
  1x Ancient Coin

info

The preview performs a simulated roll. Random pool results will vary each time.

---

Command Summary

Command	Alias	Permission	Description
/kslootbags	/lb, /lootbag	None	Show help
/kslootbags stats	—	None	View personal stats
/kslootbags settings animation on|off	—	None	Toggle reveal animation
/kslootbagsadmin panel	/lbadmin panel	Admin	Open admin panel
/kslootbagsadmin give <id> [amt]	/lbadmin give	Admin	Give lootbag to self
/kslootbagsadmin reload	/lbadmin reload	Admin	Reload configs
/kslootbagsadmin list	/lbadmin list	Admin	List all lootbags
/kslootbagsadmin preview <id>	/lbadmin preview	Admin	Preview contents