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

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!