🎮 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:

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!