Commands

Complete reference for all Season Pass commands.

Player Commands

/ksseasonpass

Main player command for the Season Pass system.

/ksseasonpass [subcommand]
/sp [subcommand]              # Alias
/seasonpass [subcommand]      # Alias
/battlepass [subcommand]      # Alias

Permission: None (available to all players)

open

Opens the Season Pass UI. This is the default subcommand.

/sp              # Opens the Season Pass UI
/sp open         # Same as above

info

Displays current season info in chat.

/sp info

Output example:

Season: Season 1: Explorer | Tier: 12/40 | XP: 2340/2518 | Tokens: 87
PREMIUM
Season ends in 18 days

The output format is defined by the seasonpass.cmd.season_info localization key and uses the pattern: Season: {0} | Tier: {1}/{2} | XP: {3}/{4} | Tokens: {5}.

buy

Purchase the premium pass using server currency.

/sp buy

Requires sufficient currency (configured in season definition)
Blocked if premiumEnabled is false in the season config
Blocked if premiumCommandOnly is true (premium only via admin command)
Returns a message if the player already has premium
Retroactively unlocks all earned premium tier rewards on purchase

:::note Currency Integration Premium purchases use the Core mod’s ShopService currency system. The currency ID and cost are configured per season (default: 1000 gold). :::

Admin Commands

/ksseasonpassadmin

Base command for all admin operations.

/ksseasonpassadmin <subcommand> [args]
/spadmin <subcommand> [args]              # Alias

:::warning Permission Required All admin commands require seasonpass.admin permission. :::

panel

Opens the full admin panel UI with 11 tabs for in-game configuration, content editing, and season management.

/spadmin panel

CONFIG tabs: General, Season, Currency, Premium, XP Sources, Prestige
CONTENT tabs: Tiers, Challenges, Shop
MANAGEMENT tabs: Player management, Events (Double XP, season lifecycle)
All changes take effect immediately without server restart

start

Start a new season.

/spadmin start <seasonId>

Argument	Type	Description
`seasonId`	string	Season definition ID (e.g., `season_1`)

Only one season can be active at a time
Sets activeSeasonId in config and saves
Resets all online players’ season data for the new season

Example:

/spadmin start season_1

end

End the current season.

/spadmin end

Archives all online players’ season data
Auto-claims any unclaimed rewards for online players
Clears activeSeasonId in config

pause

Pause the current season.

/spadmin pause

XP gain is disabled while paused
Challenge progress is frozen
Players are notified of the pause

resume

Resume a paused season.

/spadmin resume

reload

Reload all configuration files.

/spadmin reload

Reloads config.json, all season definitions in seasons/, and localization files. No restart required.

info

Show current season status.

/spadmin info

Output example:

Season: season_1 | Status: Active | Players: 5

The output format is defined by the seasonpass.admin.info localization key and uses the pattern: Season: {0} | Status: {1} | Players: {2}.

grantxp

Grant XP to a player.

/spadmin grantxp <player> <amount>

Argument	Type	Description
`player`	string	Target player name
`amount`	int	XP amount to grant

Triggers tier-up if XP threshold is crossed
Does not respect daily XP caps

Example:

/spadmin grantxp Steve 5000

setxp

Set a player’s XP to an exact value.

/spadmin setxp <player> <amount>

Argument	Type	Description
`player`	string	Target player name
`amount`	int	New XP value

granttokens

Grant Season Tokens to a player.

/spadmin granttokens <player> <amount>

Argument	Type	Description
`player`	string	Target player name
`amount`	int	Token amount to grant

grantpremium

Grant the premium pass to a player for free.

/spadmin grantpremium <player>

Argument	Type	Description
`player`	string	Target player name

revokepremium

Revoke a player’s premium pass.

/spadmin revokepremium <player>

Argument	Type	Description
`player`	string	Target player name

:::note Already Claimed Rewards Revoking premium does not reclaim already-granted premium rewards. It only prevents future premium reward claims. :::

settier

Set a player’s tier to a specific value.

/spadmin settier <player> <tier>

Argument	Type	Description
`player`	string	Target player name
`tier`	int	Tier number (1-40)

resetplayer

Reset all season data for a player.

/spadmin resetplayer <player>

Argument	Type	Description
`player`	string	Target player name

Archives current season progress to history
Resets tier, XP, tokens, claims, and challenges
Cannot be undone

:::warning Destructive Action This permanently resets the player’s season progress. The old data is archived in their history but cannot be restored as active progress. :::

grantbooster

Grant a personal XP booster to a player.

/spadmin grantbooster <player> <multiplier> <minutes>

Argument	Type	Description
`player`	string	Target player name
`multiplier`	double	XP multiplier (e.g., `2.0` for double XP)
`minutes`	int	Booster duration in minutes

Example:

/spadmin grantbooster Steve 2.0 60    # 2x XP for 1 hour

doublexp

Start a server-wide Double XP event.

/spadmin doublexp <minutes> [multiplier]

Argument	Type	Default	Description
`minutes`	int	—	Event duration in minutes
`multiplier`	double	`2.0`	XP multiplier for the event

Affects all online and joining players
Stacks with personal boosters and premium XP boost
Broadcast notification sent to all players

Example:

/spadmin doublexp 120           # 2x XP for 2 hours
/spadmin doublexp 60 3.0        # 3x XP for 1 hour

stopdoublexp

Stop the current Double XP event.

/spadmin stopdoublexp

Immediately ends the active Double XP event
Broadcast notification sent to all players

setprestige

Set a player’s prestige level.

/spadmin setprestige <player> <level>

Argument	Type	Description
`player`	string	Target player name
`level`	int	Prestige level (0 to `maxPrestigeLevel`)

Setting to 0 removes all prestige bonuses
Requires prestigeEnabled to be true in the season config

Example:

/spadmin setprestige Steve 3    # Set to prestige 3 (15% XP boost with default settings)