BattlePass
A season pass plugin for Paper servers, from 1.21.x all the way up to 26.2.
Features
Progression and rewards
- 50 tiers per season by default (configurable), with a free track for everyone and a premium track for pass holders
- Rewards can be items, console commands, or money through Vault
- Custom items from Oraxen and ItemsAdder work out of the box. Enchants, lore, attributes and NBT are kept intact.
- Seasons rotate on their own schedule, and you pick how long each one lasts
Quests
Players earn XP by doing things they already do on your server: mining and placing blocks, killing mobs and players, crafting, fishing, enchanting, breeding animals and trading with villagers. On top of that you can make quests repeatable, or write fully custom ones.
Admin tools
- An in-game tier editor. Hold an item and add it straight to a tier, custom items included.
- Set a player's XP or tier, and grant or remove premium, all from commands
/bpadmin statsshows cache and save health at a glance- Reload configs without restarting the server
Installation
- Drop the
.jarinto yourpluginsfolder - Start (or restart) the server
- Tweak
config.yml,quests.ymlandrewards.ymlto your liking - Run
/bpadmin reloadand you're good to go
Commands
Player commands
| Command | What it does |
|---|---|
/bp or /battlepass |
Opens the BattlePass menu |
/bp quests |
Shows your active quests |
/bp info |
Shows your progress and stats |
Admin commands
| Command | What it does |
|---|---|
/bpadmin reload |
Reloads all config files |
/bpadmin setexp <player> <amount> |
Sets a player's XP |
/bpadmin settier <player> <tier> |
Sets a player's tier |
/bpadmin givepremium <player> |
Gives premium access |
/bpadmin removepremium <player> |
Removes premium access |
/bpadmin editor [tier] |
Opens the tier editor |
/bpadmin stats |
Shows cache and performance stats |
/bpadmin forcesave |
Saves all pending data right now |
Permissions
| Permission | Description | Default |
|---|---|---|
battlepass.use |
Use the BattlePass | everyone |
battlepass.admin |
Admin commands | op |
battlepass.premium |
Access to premium rewards | nobody |
Configuration
Everything is split across three files so it stays easy to find:
config.yml: season settings, XP per tier, messagesquests.yml: quests, their requirements and XP rewardsrewards.yml: what each tier gives out
Example season setup
season:
name: "Season 1 - Autumn 2026"
max-tier: 50
exp-per-tier: 1000
Compatibility
- Server: Paper 1.21.x – 26.2 (Paper forks like Purpur should work too)
- Java: 21+ for 1.21.x, Java 25 for 26.x
- Optional: Oraxen, ItemsAdder, Vault
Bug reports
Please make a ticket on discord and include:
- Your server software and version (e.g. Paper 26.2)
- The BattlePass version you're on
- What you did and what happened
- Any errors from the console
The more detail you give me, the faster I can fix it.
Made by ResistanceCore. If BattlePass is useful on your server, a follow or a share with other server owners helps a lot. Thanks!
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
BattlePass 1.3.0 1.3.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2
|
paper
|
Download |
|
BattlePass 1.0.1 1.0.1 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
paper
|
Download |
|
BattlePass 1.0.1 1.0.0-fix |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
|
paper
|
Download |
|
BattlePass 1.0.0 1.0.0 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10
|
paper
|
Download |