Commands

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

`/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

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. To give to other players, use the admin panel’s Give tab.

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

Example:

/lbadmin give Golden_Lootbag_Legendary
/lbadmin give Shadow_Lootbag_Epic 5

`/kslootbagsadmin edit <id> <property> <value>`

Edit a lootbag definition via command. Changes are auto-saved to custom/custom_lootbags.json.

Property	Value	Description
`rarity`	`common` / `uncommon` / `rare` / `epic` / `legendary`	Change the rarity tier
`dupes`	`true` / `false`	Allow duplicate pool picks
`name`	String (can contain spaces)	Change the display name
`picks`	Integer	Set the number of random pool picks
`gadd`	`<itemId> [amount]`	Add a guaranteed item
`padd`	`<itemId> [amount] [weight]`	Add a pool item (default weight: 10)
`gdel`	—	Remove the last guaranteed item
`pdel`	—	Remove the last pool item

Examples:

/lbadmin edit Default_Lootbag rarity rare
/lbadmin edit Default_Lootbag name My Custom Lootbag
/lbadmin edit Default_Lootbag picks 3
/lbadmin edit Default_Lootbag dupes true
/lbadmin edit Default_Lootbag gadd Food_Bread 5
/lbadmin edit Default_Lootbag padd Sword_Iron 1 25
/lbadmin edit Default_Lootbag gdel
/lbadmin edit Default_Lootbag pdel

`/kslootbagsadmin reload`

Reload all lootbag configurations from disk. This reloads:

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

`/kslootbagsadmin list`

List all registered lootbag definitions with rarity (color-coded) and display name.

`/kslootbagsadmin preview <itemId>`

Preview the contents of a lootbag definition. Shows rarity, type (Fixed/Random/Hybrid), and a simulated opening with resolved items.

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

`/kslootbagsadmin lang <code>`

Set the language for lootbag UI and messages. Works independently of Core.

Argument	Description
`en-US`	English
`de-DE`	German
`auto`	Reset to auto-detect (client language)

Without arguments, shows the current language and available options.

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 edit <id> <prop> <val>`	`/lbadmin edit`	Admin	Edit lootbag definition
`/kslootbagsadmin reload`	`/lbadmin reload`	Admin	Reload configs
`/kslootbagsadmin list`	`/lbadmin list`	Admin	List all lootbags
`/kslootbagsadmin preview <id>`	`/lbadmin preview`	Admin	Preview contents
`/kslootbagsadmin lang <code>`	`/lbadmin lang`	Admin	Set language