Permissions

The Lootbags mod uses the unified ks.<mod>.<scope>.<action> scheme. Player nodes default-allowed, admin nodes default-deny.

Permission Nodes

Permission	Default	Description
`ks.lootbag.user.use`	✅ allowed	`/kslootbags` and right-click-to-open interactions
`ks.lootbag.admin`	❌ staff only	Every `/kslootbagadmin` subcommand

Player Commands

Command	Permission	Description
`/kslootbags`	`ks.lootbag.user.use`	Show help message
`/kslootbags stats`	`ks.lootbag.user.use`	View personal lootbag statistics
`/kslootbags settings animation on\|off`	`ks.lootbag.user.use`	Toggle reveal page animation
Right-click lootbag item	`ks.lootbag.user.use`	Open a lootbag
Sneak + Right-click lootbag	`ks.lootbag.user.use`	Place lootbag as decorative block

The open interaction is still gated by the mod-enabled flag and the per-item open cooldown — permission passes don’t override those guards.

Admin Commands

All admin subcommands gate on ks.lootbag.admin (parent collection requires it; subcommand-level nodes are not auto-generated).

Command	Description
`/kslootbagadmin`	Show admin help
`/kslootbagadmin panel`	Open the admin panel UI
`/kslootbagadmin give <id> [amount]`	Give a lootbag to yourself
`/kslootbagadmin edit <id> <prop> <val>`	Edit a lootbag definition
`/kslootbagadmin reload`	Reload all configurations
`/kslootbagadmin list`	List all registered lootbags
`/kslootbagadmin preview <id>`	Preview lootbag contents
`/kslootbagadmin lang <code>`	Set language override

LuckPerms Examples

# Staff admin
/lp user Steve permission set ks.lootbag.admin true

# Revoke player access from a specific group
/lp group spectator permission set ks.lootbag.user.use false

Integration

Integration	Access Control
Core Admin Menu	Gated by Core’s `ks.admin` node (see Core permissions)
Showcase NPC	`CoreAPI.registerNpcPageOpener("showcase_lootbag", ...)` — any player who interacts with the configured NPC
DynamicTooltips	No permission required — tooltips auto-display for all players

Migration from Legacy Nodes

The old auto-generated kslootbagsadmin command permission is no longer checked. Grant ks.lootbag.admin (note: lootbag singular, admin not kslootbagsadmin).