BattlePass

Give your players a reason to log in every day. BattlePass adds a fully configurable seasonal Battle Pass to your Paper server, with free and premium reward tracks, daily/weekly/seasonal quests and XP from normal gameplay.

No real-money features built in. The premium pass is granted by permission or admin command, so you decide how players get it.

✨ Features

• Seasons. Custom name, start/end date, any number of tiers and your own XP curve. Seasons can start and end automatically, and old seasons are kept as history.
• Free & premium rewards. Items (custom name, lore, enchantments, custom model data), vanilla XP, Battle Pass XP, console commands, permissions and money (Vault). You can give several rewards per tier.
• Quests. Daily, weekly and seasonal quests, randomly picked per player with difficulty weighting and optional time limits. Types include killing mobs, mining, collecting, crafting, smelting, fishing, travelling, visiting biomes, gaining experience and completing advancements.
• XP from gameplay. Mob kills, mining, farming, fishing, breeding, smelting, crafting and exploring, each with its own XP values and daily limits.
• Anti-exploit. Player-placed blocks and their drops, spawner and spawn-egg mobs, instant-break blocks, reversible crafting recipes, items dropped by other players and AFK or flying movement don't count.
• Clean GUI. Shows progress, rewards, quests and stats, with click-spam protection. Items can't be taken out of the menu and rewards can't be claimed twice.
• Safe rewards. If the inventory is full, items go to a reward stash, are dropped, or the claim is refused (your choice).
• Notifications. Chat, action bar, titles, sounds and particles, all configurable.
• Storage. SQLite (zero setup) or MySQL/MariaDB with a session lock for networks. Saving is async, so it won't cause lag.
• Fully translatable. Every message is editable, with MiniMessage and & colour code support.

📋 Commands

Every admin command has its own permission (battlepass.admin.*).

🔌 PlaceholderAPI

%battlepass_level%, %battlepass_xp%, %battlepass_xp_required%, %battlepass_progress%, %battlepass_season%, %battlepass_premium%, %battlepass_quests_completed%, %battlepass_claimable% and more.

⚙️ Requirements

• Paper (or forks like Purpur) 1.21 – 26.2
• Java 21 (1.21.x) / Java 25 (26.x)
• Optional: PlaceholderAPI, Vault (for money & permission rewards)

Spigot and Folia are not supported.

🚀 Quick start

1. Drop the jar into plugins/ and restart.
2. Edit seasons.yml (a 50-tier example season is included) and quests.yml.
3. Run /bpa startseason season-1, or let it start automatically from the date in seasons.yml.