Permissions

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

Permission Nodes

Permission	Default	Description
`ks.seasonpass.user.use`	✅ allowed	Every `/ksseasonpass` subcommand (`open`, `info`, `buy`)
`ks.seasonpass.admin`	❌ staff only	Every `/ksseasonpassadmin` subcommand + admin panel

Player Commands

Command	Permission	Description
`/ksseasonpass open`	`ks.seasonpass.user.use`	Open the season pass UI
`/ksseasonpass info`	`ks.seasonpass.user.use`	Show season info
`/ksseasonpass buy`	`ks.seasonpass.user.use`	Purchase premium pass

Aliases: /sp, /seasonpass, /battlepass.

Admin Commands

All admin subcommands gate on ks.seasonpass.admin. Console execution bypasses the check.

Command	Description
`/ksseasonpassadmin panel`	Open the admin panel UI
`/ksseasonpassadmin start <seasonId>`	Start a season
`/ksseasonpassadmin end`	End the current season
`/ksseasonpassadmin pause`	Pause progress accrual
`/ksseasonpassadmin resume`	Resume progress accrual
`/ksseasonpassadmin reload`	Reload season configs
`/ksseasonpassadmin info`	Show season info
`/ksseasonpassadmin grantxp <player> <amount>`	Grant XP
`/ksseasonpassadmin setxp <player> <amount>`	Set XP
`/ksseasonpassadmin granttokens <player> <amount>`	Grant tokens
`/ksseasonpassadmin grantpremium <player>`	Grant premium pass
`/ksseasonpassadmin revokepremium <player>`	Revoke premium pass
`/ksseasonpassadmin settier <player> <tier>`	Set player tier
`/ksseasonpassadmin resetplayer <player>`	Reset player progress
`/ksseasonpassadmin grantbooster <player> <multiplier> <minutes>`	Grant XP booster
`/ksseasonpassadmin doublexp <minutes> [multiplier]`	Global XP boost event
`/ksseasonpassadmin stopdoublexp`	End global XP boost
`/ksseasonpassadmin setprestige <player> <level>`	Set prestige level

Alias: /spadmin.

Admin Panel

/ksseasonpassadmin panel performs its own ks.seasonpass.admin check before opening. All in-panel actions (save settings, manage players, edit content) inherit the same gate.

Showcase Guard

In addition to ks.seasonpass.admin, write operations also check ShowcaseCompat.isShowcaseBlocked(playerRef). On demo servers, these actions refuse to run even for admins:

Season lifecycle: start, end, pause, resume
Player management: grantxp, setxp, granttokens, grantpremium, revokepremium, settier, resetplayer, grantbooster, setprestige
Global events: doublexp, stopdoublexp
Config: reload
All save operations from the admin panel

Console execution bypasses the showcase check.

LuckPerms Examples

# Grant admin
/lp user Steve permission set ks.seasonpass.admin true
/lp group staff permission set ks.seasonpass.admin true

# Revoke default user access from a group
/lp group spectator permission set ks.seasonpass.user.use false

Migration from Legacy Nodes

The old seasonpass.admin node is no longer checked. Grant ks.seasonpass.admin.