BattlePass
1.3.0BattlePass 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
1.3.0latestBattlePass 1.3.0Sep 21, 2026 BattlePass 1.3.0
A fix release. One reward duplication path is closed, two quest-farming exploits are closed, and the data layer has been rewritten so progress survives a busy server. Heads up: _this release changes behaviour. The anti-farm work and the craft counting fix both change how fast players progress. Read "Behaviour changes" below before updating._ 1. Reward duplication (critical) Rewards could be claimed twice across a server restart. The chain: while one async save was in flight, the next save request was silently dropped; the claim path never marked the player dirty either, and shutdown only wrote players that were marked dirty. A reward claimed inside that window never reached disk, so the player could claim it again after a restart. Players are now marked dirty before a snapshot is taken and only cleared once the write has actually landed, a save requested while another is running is queued instead of discarded, and shutdown writes every cached player. 2. Quest progress exploits - Unlimited block farming. Breaking a block you had just placed still counted toward BREAK_BLOCKS, so a single stack of stone was enough to climb tiers forever. Player-placed blocks no longer pay out when broken, and PLACE_BLOCKS only pays once per location, so both halves of the loop are closed. Mining natural blocks is unaffected. - PvP alt farming. Kills from the same connection no longer count, and repeat kills of the same victim only count once every 5 minutes. - Progress from cancelled events. Every quest handler now respects ignoreCancelled. Previously, breaking blocks inside a WorldGuard or GriefPrevention claim still added progress even though the block was never destroyed. 3. Craft counting Shift-click crafting always counted as one batch no matter how much was actually made, so CRAFT_ITEMS quests barely moved for anyone crafting normally. The number credited is now what the player genuinely received, measured from the change in their inventory. If the inventory fills up partway through and vanilla stops crafting early, the count stops with it. No more, no less. 4. Stability and data integrity - The player data cache was read from the save threads with no synchronisation at all, even though it is access-ordered, which means a read mutates it. Every access now goes through a single lock, and the collections inside PlayerData were swapped for concurrent ones. - A full cache could evict a player who was still online, rolling their progress back to whatever was on disk, including their list of claimed rewards. Online players are no longer evicted. - Player data files were read on the main thread from inside a click handler. Data is now loaded asynchronously when the player joins. - An editor session abandoned by disconnecting left the player flagged as awaiting chat input, so their first message after reconnecting was swallowed by the editor. That state is cleared on quit. 5. GUI - Clicking your own inventory in slots 19 to 34 triggered a reward claim, because the slot index was read in a numbering that does not distinguish the top inventory from the bottom one. Only clicks inside the GUI are handled now. - A renamed item in a player's inventory could drive GUI navigation. A stone block named "Next Tier" would change tiers when clicked. Closed by the same fix. - Colour codes in reward and quest names, descriptions and lore were never translated, so the GUI showed raw text such as "&aWarrior Kit". They render correctly now. Compatibility - Minecraft 1.21 to 26.2, one jar for all of them. - Paper, Purpur, Spigot, Bukkit. Folia is not supported yet. - Java 21. - The player data format is unchanged. No migration, just swap the jar and restart.1.0.1BattlePass 1.0.1Mar 24, 2026 Bug Fix
Fixed: Premium rewards inaccessible via
Players with thebattlepass.premiumpermissionbattlepass.premiumpermission node assigned through LuckPerms (or any permission plugin) were unable to claim premium rewards or see them as available in the GUI. Premium access was only recognized if granted via/bpadmin givepremium.1.0.0-fixBattlePass 1.0.1Jan 1, 2026 V1.0.1 - SMALL FIX:
color code used in the header configuration is incorrect1.0.0BattlePass 1.0.0Dec 9, 2025
A feature-rich, performance-optimized BattlePass plugin for Minecraft servers running Paper/Spigot 1.21+ ---BattlePass - Advanced Season Pass Plugin
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! ---Overview
Key Features
- 50-Tier Progression System - Configurable season-based battle pass - Dual Reward Tracks - FREE rewards for all players, PREMIUM rewards for pass holders - Quest System - 12+ quest types including mining, crafting, PvP, fishing, and more - Interactive GUIs - Beautiful, intuitive interfaces for players and admins - Season Management - Easy season rotation with customizable durationCore Systems
- In-Game Tier Editor - Manage rewards without editing configs - Add Items from Hand - Supports vanilla, Oraxen, and ItemsAdder items with full NBT - Player Management - Set XP, tiers, grant/remove premium access - Performance Monitoring - Built-in cache statistics and health indicators - Live Reload - Update configs without restartingAdmin Tools
- Async Save System - Non-blocking saves prevent TPS drops - LRU Cache - Efficient memory management for 500+ players - Batch Processing - Reduces disk I/O by 90% - Rate Limiting - Prevents spam and exploits - Graceful Shutdown - Safe data handling during restartsPerformance Optimized
- Multiple Reward Types: Items, commands, money (Vault compatible) - Custom Item Support: Full compatibility with Oraxen and ItemsAdder - NBT Preservation: Custom enchants, lore, and attributes preserved - Command Execution: Run any console command as rewardsFlexible Rewards
Quest Variety
---✓ Break/Place Blocks ✓ Kill Mobs/Players ✓ Craft Items ✓ Fish ✓ Enchant Items ✓ Breed Animals ✓ Trade with Villagers ✓ Repeatable Quests ✓ Custom Quests
1. Download the latestInstallation
.jarfile 2. Place in your server'spluginsfolder 3. Restart your server 4. Configureconfig.yml,quests.yml, andrewards.yml5. Reload with/bpadmin reload---Commands
Player Commands
-/bpor/battlepass- Open BattlePass GUI -/bp quests- View active quests -/bp info- View your statisticsAdmin Commands
-/bpadmin reload- Reload all configs -/bpadmin setexp <player> <amount>- Set player XP -/bpadmin settier <player> <tier>- Set player tier -/bpadmin givepremium <player>- Grant premium pass -/bpadmin removepremium <player>- Remove premium pass -/bpadmin editor [tier]- Open tier editor GUI -/bpadmin stats- View cache and performance stats -/bpadmin forcesave- Force save all dirty data ---
-Permissions
battlepass.use- Access BattlePass (default: true) -battlepass.admin- Admin commands (default: op) -battlepass.premium- Premium reward access (default: false) ---
Highly customizable with 3 config files: -Configuration
config.yml- Season settings, XP requirements, messages -quests.yml- Quest definitions, rewards, requirements -rewards.yml- Tier rewards, items, commands Example Season Setup:
---season: name: "Season 1 - Winter 2024" max-tier: 50 exp-per-tier: 1000
- Minecraft Version: 1.21+ (Paper/Spigot) - Java Version: 21+ - Optional Dependencies: - Oraxen (custom items) - ItemsAdder (custom items) - Vault (economy rewards) ---Compatibility
-Performance Stats
Handles 200+ concurrent players smoothly -
<1ms reward claim time (async saves) -
90% reduction in disk I/O vs immediate saves -
Zero TPS impact during auto-save cycles -
500-player LRU cache with smart eviction ---
Found a bug or have a suggestion? Please report issues with: - Server version (e.g., Paper 1.21) - Plugin version - Steps to reproduce - Console errors (if any) --- Made with ❤️ by ResistanceCore If you enjoy this plugin, please leave a ❤️ Love and share with other server owners!Support & Feedback
Similar projects
Plugin →VeinMiner
Mine the whole vein on mining a single ore/block. Make the tedious mining experience to something satisfying and fun! FTB Ultimine alternative
99.3MSueta
Simple Voice Chat
A working voice chat in Minecraft!
76.8MSueta
Chunky
Pre-generates chunks, quickly and efficiently
18.4MSueta
VeinMiner Enchantment
Veinminer Addon - Adds vineminer enchantment to enchanting tables. Only tools with the enchantment can veinmine
18MSueta
JourneyMap
Real-time map used for mapping in-game or your browser as you explore.
14.7MSueta
WorldEdit
A Minecraft Map Editor... that runs in-game! With selections, schematics, copy and paste, brushes, and scripting. Use it in creative, or use it temporarily in survival.
11.6MSueta