BattlePass

# 🎮 BattlePass - Advanced Season Pass Plugin **A feature-rich, performance-optimized BattlePass plugin for Minecraft servers running Paper/Spigot 1.21+** --- ## ✨ 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 ` - 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!*