# 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.

## 🐛 Bug Fix ### Fixed: Premium rewards inaccessible via `battlepass.premium` permission Players with the `battlepass.premium` permission 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`.

## V1.0.1 - SMALL FIX: color code used in the header configuration is incorrect

# 🎮 BattlePass - Advanced Season Pass Plugin **A feature-rich, performance-optimized BattlePass plugin for Minecraft servers running Paper/Spigot 1.21+** --- ## 📋 Overview 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! --- ## ✨ Key Features ### 🎯 **Core Systems** - **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 duration ### 🔧 **Admin Tools** - **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 restarting ### ⚡ **Performance Optimized** - **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 restarts ### 🎁 **Flexible Rewards** - **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 rewards ### 🎨 **Quest Variety** ``` ✓ Break/Place Blocks ✓ Kill Mobs/Players ✓ Craft Items ✓ Fish ✓ Enchant Items ✓ Breed Animals ✓ Trade with Villagers ✓ Repeatable Quests ✓ Custom Quests ``` --- ## 📦 Installation 1. Download the latest `.jar` file 2. Place in your server's `plugins` folder 3. Restart your server 4. Configure `config.yml`, `quests.yml`, and `rewards.yml` 5. Reload with `/bpadmin reload` --- ## 🎮 Commands ### **Player Commands** - `/bp` or `/battlepass` - Open BattlePass GUI - `/bp quests` - View active quests - `/bp info` - View your statistics ### **Admin 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) --- ## ⚙️ Configuration **Highly customizable with 3 config files:** - `config.yml` - Season settings, XP requirements, messages - `quests.yml` - Quest definitions, rewards, requirements - `rewards.yml` - Tier rewards, items, commands **Example Season Setup:** ```yaml season: name: "Season 1 - Winter 2024" max-tier: 50 exp-per-tier: 1000 ``` --- ## 🤝 Compatibility - **Minecraft Version**: 1.21+ (Paper/Spigot) - **Java Version**: 21+ - **Optional Dependencies**: - Oraxen (custom items) - ItemsAdder (custom items) - Vault (economy rewards) --- ## 📊 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 --- ## 🐛 Support & Feedback 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!*