Sueta

BattlePass

1.3.0

BattlePass brings a modern, engaging progression system to your Minecraft server with a polished GUI, quest system, and flexible reward structure. Perfect for keeping players engaged with seasonal con

·Plugin

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 stats shows cache and save health at a glance
  • Reload configs without restarting the server

Installation

  1. Drop the .jar into your plugins folder
  2. Start (or restart) the server
  3. Tweak config.yml, quests.yml and rewards.yml to your liking
  4. Run /bpadmin reload and you're good to go

Commands

Player commands

CommandWhat it does
/bp or /battlepassOpens the BattlePass menu
/bp questsShows your active quests
/bp infoShows your progress and stats

Admin commands

CommandWhat it does
/bpadmin reloadReloads 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 statsShows cache and performance stats
/bpadmin forcesaveSaves all pending data right now

Permissions

PermissionDescriptionDefault
battlepass.useUse the BattlePasseveryone
battlepass.adminAdmin commandsop
battlepass.premiumAccess to premium rewardsnobody

Configuration

Everything is split across three files so it stays easy to find:

  • config.yml: season settings, XP per tier, messages
  • quests.yml: quests, their requirements and XP rewards
  • rewards.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!

Similar projects

Plugin →