🎖️ HyroBattlePass — Tiered Seasonal BattlePass Engine

HyroBattlePass is an advanced, highly customizable seasonal battle pass plugin designed specifically for modern Paper / Purpur (1.20 - 1.21.x) Minecraft servers. Boost player retention and playtime with an engaging 50-tier progression system, featuring Free & Premium tracks, playtime EXP earnings, and deep integrations across the entire Hyro plugin ecosystem!

---

✨ Features

🌟 1. Dual Track Progression (Free vs Premium)

• Free Track: Available to every player on the server out of the box, offering steady incentives and rewards.
• Premium Track: Unlocks an exclusive parallel row of amplified rewards, rare vouchers, and special cosmetics for VIPs or pass purchasers.
• Seamlessly grant access using LuckPerms or store packages via permission hyrobattlepass.premium.

📈 2. Multiple EXP Progression Vectors

Never restrict your players to grinding only one type of activity! Players gain BattlePass EXP through:

• 🎯 Quests: Integrated with HyroQuest daily, weekly, and milestone challenges.
• ⏳ Active Playtime: Passively earn +10 EXP every 15 minutes of active gameplay (with AFK detection).
• 📅 Daily Login: Kickstart the day with a +25 EXP bonus upon first login.

🎁 3. Deep Ecosystem Reward Payouts

Reward tiers can give players anything from vanilla loot to custom suite assets:

• Vault Economy & Vanilla EXP
• HyroTags Vouchers (Physical title tag vouchers)
• HyroCosmetics 3D Items (Custom hats, wings, backpacks, and balloons)
• Custom Console Commands (Crate keys, rank upgrades, and permissions)

🖥️ 4. Interactive 54-Slot GUI

• Clean and intuitive pagination to browse all 50 tiers.
• Color-coded progress indicators: Locked, Claimable, and Claimed.
• Instant [Claim All] button for hassle-free rewards collection.

---

⌨️ Commands & Permissions

Command	Permission	Description
/bp	hyrobattlepass.use	Opens the seasonal BattlePass GUI
/bp claim [tier]	hyrobattlepass.use	Claims pending tier rewards
/bp info	hyrobattlepass.use	Shows current level, EXP progress, and tier
/bp exp add <player> <amount>	hyrobattlepass.admin	Grants BattlePass EXP to a player
/bp setlevel <player> <level>	hyrobattlepass.admin	Sets a player's BattlePass level
/bp reload	hyrobattlepass.admin	Reloads configurations and reward tables

Aliases: /battlepass, /hbpass, /hbp, /pass

---

⚙️ Requirements & Installation

Requirements:

• Server Software: PaperMC or Purpur (1.20 - 1.21.x)
• Java Version: Java 21 or newer
• Required Dependency: HyroCore
• Optional Dependencies:
  • Vault (For monetary rewards)
  • LuckPerms (For Premium Pass permission management)
  • HyroQuest, HyroTags, HyroCosmetics (For cross-plugin rewards and quest EXP)

Quick Installation:

1. Ensure HyroCore.jar is installed in your server's plugins/ directory.
2. Download HyroBattlePass.jar and place it in the plugins/ folder.
3. Restart your server.
4. Open config.yml and tiers.yml to customize tier thresholds, rewards, and season durations!