⚔️ BattlePass - Ultimate Progression Plugin for Minecraft (1.21+)

The most advanced, feature-rich Battle Pass system for Spigot & Paper servers. Engage your players with Daily Missions, Tiered Rewards, and a custom Currency Shop. No config editing required — manage everything via In-Game GUI!

Unlike other plugins, BattlePass focuses on ease of use for admins and engagement for players. It includes a powerful In-Game Editor, robust MySQL Database support for networks, and deep integrations with popular plugins like MythicMobs.

• 🏆 Seasonal Progression System

  • Fully customizable tier system (default 54 levels).
  • Dual Reward Tracks: Free Pass (for everyone) and Premium Pass (VIP/Paid).
  • Automatic season reset options (Monthly or Duration-based).
  • Season Rotation: automatically cycle through multiple reward sets stored in the seasons/ folder, each season with its own Free and Premium rewards.

• 🛠️ In-Game GUI Editor (No YAML needed!)

  • Mission Editor: Create, edit, or delete daily missions directly inside the game.
  • Rewards Editor: Drag-and-drop items from your inventory to set rewards for any level.
  • Season Editing: Edit the rewards of any season in the rotation, even while another season is active.

• 💾 Database & Sync Support

  • SQLite (Default): Plug and play for single servers.
  • MySQL: Full support for syncing player progress, XP, and rewards across a BungeeCord/Velocity network.

• 📜 Dynamic Missions

  • 7 Daily Missions generated randomly every day (count configurable).
  • Mission Types: Mining, Crafting, Fishing, Farming, Killing Mobs, Playtime, Walking Distance, Dealing/Taking Damage, Trading with Villagers, Enchanting, and more.
  • Additional Targets: one mission can accept multiple materials, mobs, or professions (e.g. "mine iron" also counts deepslate iron ore).
  • World Blacklist: Disable mission progress in selected worlds (missions.disabled-worlds).
  • Configurable actionbar: Set how long mission progress messages stay visible.

• 💰 Battle Coins & Shop

  • Players earn Battle Coins by ranking in the daily leaderboard.
  • Spend coins in the customizable Shop GUI for exclusive items, XP boosts, or commands.
  • Top 10 payouts, delivery interval, and rewards are fully configurable.

• Custom Items & XP Events

  • Premium Voucher, Battle Coin Token, Experience Elixir and XP Event Beacon items, obtainable via /bp giveitem or as rewards.
  • Server-wide XP events (/bp event 2x 1h) with a live bossbar countdown for all players.

• Daily Rewards

  • Players claim a free XP bonus once per day from the Battle Pass menu.

• Fully Translatable

  • Every message, menu text, and GUI line is configurable in messages.yml, including the season display.

• Developer API

  • BattlePassXPGainEvent: listen to, modify, or cancel Battle Pass XP gains to integrate your own multipliers or systems.

• GUI Customization

  • Change every menu material in config.yml, with support for custom model data for resource packs.

• 🔌 Powerful Integrations

  • PlaceholderAPI: Full support for scoreboards, tabs, and chat.
  • MythicMobs: Create missions to kill specific custom bosses or mobs.

1. Download BattlePass.jar.
2. Drop it into your server's /plugins/ folder.
3. (Optional) Install PlaceholderAPI for placeholders.
4. Restart your server.
5. Enjoy! Config files (config.yml, missions.yml, shop.yml) will generate automatically.

Add these to your scoreboard or tablist!

• %battlepass_level% - Player's current tier.
• %battlepass_xp_progress% - Formatted XP (e.g., 50/200).
• %battlepass_premium_status% - Returns "Active" or "Inactive".
• %battlepass_season_time% - Time remaining in the current season.
• %battlepass_coins% - Current Battle Coins balance.
• %battlepass_daily_reward_available% - Check if daily reward is ready ("Yes"/"No").
• %battlepass_current_season% - Current season number (season rotation).
• %battlepass_xp_event_multiplier% - Active XP event multiplier (e.g., "2x").

(See Placeholders.md for the full list)