Skip to main content
The Battle Pass Extension allows you to implement seasonal progression systems. Players can earn XP, level up, and unlock rewards through a configurable pass interface.

📚 Entry Library

⚙️ Configuration

Main setting files for the Battle Pass.

📖 Definitions

Core definitions for the Battle Pass structure.

📦 Artifacts

Data storage and persisted information.

Facts

Commands

CommandPermissionDescription
/battlepass pass <id> xp add <amount> [player]typewriter.battlepassAdd XP to a player’s battle pass.
/battlepass pass <id> xp remove <amount> [player]typewriter.battlepassRemove XP from a player’s battle pass.
/battlepass pass <id> xp set <amount> [player]typewriter.battlepassSet a player’s battle pass XP.
/battlepass pass <id> level add <amount> [player]typewriter.battlepassAdd levels to a player’s battle pass.
/battlepass pass <id> level remove <amount> [player]typewriter.battlepassRemove levels from a player’s battle pass.
/battlepass pass <id> level set <amount> [player]typewriter.battlepassSet a player’s battle pass level.
/battlepass pass <id> info [player]typewriter.battlepassView battle pass progress info.

Placeholders

PlaceholderDescription
%battlepass:<id>:name%The name of the battle pass.
%battlepass:<id>:active%1 if the battle pass is active, 0 otherwise.
%battlepass:<id>:level%The player’s current level.
%battlepass:<id>:xp%The player’s current XP.
%battlepass:<id>:xp:max%The max XP for the current level (or total max).
%battlepass:<id>:xp:next%The XP required for the next level.
%battlepass:<id>:xp:remaining%The XP remaining until the next level.
%battlepass:<id>:rewards:total%Total number of rewards.
%battlepass:<id>:rewards:claimed%Number of claimed rewards.
%battlepass:<id>:rewards:available%Number of available rewards.
%battlepass:<id>:rewards:unclaimed%Number of unclaimed rewards (available - claimed).
%battlepass:<id>:week:<number>:state%The state of the week (LOCKED, AVAILABLE, COMPLETED).
%battlepass:<id>:week:<number>:active%1 if the week is active/available, 0 otherwise.
%battlepass:<id>:week:<number>:title%The title of the week.
%battlepass:<id>:week:<number>:description%The description of the week.