?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
BattlePass

BattlePass

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 content!

1.5Kdownloads
3followers
1.5Kdownloads
3followers

Compatibility

Minecraft: Java Edition

26.2
26.1.x
1.21.x

Platforms

Links

Join Discord server
Donate on PayPal

Tags

Creators

Details

Licensed ARR
Published 9 months ago
Updated 6 days ago

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

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, 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!