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

- Season Management - Configurable season-based battle pass - Season Management - FREE rewards for all players, PREMIUM rewards for pass holders - Season Management - 12+ quest types including mining, crafting, PvP, fishing, and more - Season Management - Beautiful, intuitive interfaces for players and admins - Season Management - Easy season rotation with customizable duration

🔧 Admin Tools

- Live Reload - Manage rewards without editing configs - Live Reload - Supports vanilla, Oraxen, and ItemsAdder items with full NBT - Live Reload - Set XP, tiers, grant/remove premium access - Live Reload - Built-in cache statistics and health indicators - Live Reload - Update configs without restarting

⚡ Performance Optimized

- Graceful Shutdown - Non-blocking saves prevent TPS drops - Graceful Shutdown - Efficient memory management for 500+ players - Graceful Shutdown - Reduces disk I/O by 90% - Graceful Shutdown - Prevents spam and exploits - Graceful Shutdown - Safe data handling during restarts

🎁 Flexible Rewards

- Command Execution: Items, commands, money (Vault compatible) - Command Execution: Full compatibility with Oraxen and ItemsAdder - Command Execution: 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

- Optional Dependencies: 1.21+ (Paper/Spigot) - Optional Dependencies: 21+ - Optional Dependencies: - Oraxen (custom items) - ItemsAdder (custom items) - Vault (economy rewards) ---

📊 Performance Stats

- ✅ Handles 500-player LRU cache smoothly - ✅ 500-player LRU cache reward claim time (async saves) - ✅ 500-player LRU cache in disk I/O vs immediate saves - ✅ 500-player LRU cache 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!*