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:

═══ Season Pass ═══
Season: Season 1: Explorer
Tier: 12 / 40
XP: 2,340 / 2,518 (next tier)
Tokens: 87
Premium: Yes
Days remaining: 18

buy

Purchase the premium pass using server currency.

/sp buy

• Requires sufficient currency (configured in season definition)
• Opens confirmation if premium is enabled
• Blocked if premiumEnabled is false in the season config
• Retroactively unlocks all earned premium tier rewards

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

Permission Required

All admin commands require seasonpass.admin permission.

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:

═══ Season Admin ═══
Active Season: season_1 (Season 1: Explorer)
Status: Active
Duration: 30 days (18 remaining)
Online Players: 5
Paused: No

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

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

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)