# \ud83c\udfae BattlePass – Advanced Season Pass Plugin<\/p>\n
**A feature-rich, performance-optimized BattlePass plugin for Minecraft servers running Paper\/Spigot 1.21+**<\/p>\n
—
\n## \u2728 Key Features<\/p>\n
### \ud83c\udfaf **Core Systems**
\n– **50-Tier Progression System** – Configurable season-based battle pass
\n– **Dual Reward Tracks** – FREE rewards for all players, PREMIUM rewards for pass holders
\n– **Quest System** – 12+ quest types including mining, crafting, PvP, fishing, and more
\n– **Interactive GUIs** – Beautiful, intuitive interfaces for players and admins
\n– **Season Management** – Easy season rotation with customizable duration<\/p>\n
### \ud83d\udd27 **Admin Tools**
\n– **In-Game Tier Editor** – Manage rewards without editing configs
\n– **Add Items from Hand** – Supports vanilla, Oraxen, and ItemsAdder items with full NBT
\n– **Player Management** – Set XP, tiers, grant\/remove premium access
\n– **Performance Monitoring** – Built-in cache statistics and health indicators
\n– **Live Reload** – Update configs without restarting<\/p>\n
### \u26a1 **Performance Optimized**
\n– **Async Save System** – Non-blocking saves prevent TPS drops
\n– **LRU Cache** – Efficient memory management for 500+ players
\n– **Batch Processing** – Reduces disk I\/O by 90%
\n– **Rate Limiting** – Prevents spam and exploits
\n– **Graceful Shutdown** – Safe data handling during restarts<\/p>\n
### \ud83c\udf81 **Flexible Rewards**
\n– **Multiple Reward Types**: Items, commands, money (Vault compatible)
\n– **Custom Item Support**: Full compatibility with Oraxen and ItemsAdder
\n– **NBT Preservation**: Custom enchants, lore, and attributes preserved
\n– **Command Execution**: Run any console command as rewards<\/p>\n
### \ud83c\udfa8 **Quest Variety**
\n“`
\n\u2713 Break\/Place Blocks \u2713 Kill Mobs\/Players \u2713 Craft Items
\n\u2713 Fish \u2713 Enchant Items \u2713 Breed Animals
\n\u2713 Trade with Villagers \u2713 Repeatable Quests \u2713 Custom Quests
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download the latest `.jar` file
\n2. Place in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure `config.yml`, `quests.yml`, and `rewards.yml`
\n5. Reload with `\/bpadmin reload`<\/p>\n
—<\/p>\n
## \ud83c\udfae Commands<\/p>\n
### **Player Commands**
\n– `\/bp` or `\/battlepass` – Open BattlePass GUI
\n– `\/bp quests` – View active quests
\n– `\/bp info` – View your statistics<\/p>\n
### **Admin Commands** —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n – `battlepass.use` – Access BattlePass (default: true) —<\/p>\n ## \u2699\ufe0f Configuration<\/p>\n **Highly customizable with 3 config files:** **Example Season Setup:** —<\/p>\n ## \ud83e\udd1d Compatibility<\/p>\n – **Minecraft Version**: 1.21+ (Paper\/Spigot) ## \ud83d\udcca Performance Stats<\/p>\n – \u2705 Handles **200+ concurrent players** smoothly 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!<\/p>\n","protected":false},"featured_media":26379,"template":"","meta":{"_minecraft_slug":"battlepass","_minecraft_project_id":"5i4QwtMC","_minecraft_author":"ResistanceCore","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":662,"_minecraft_follows":3,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"battlepass.zip","_minecraft_size_bytes":236291,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T09:46:57.760511Z","_minecraft_date_created":"2025-12-14T01:21:31.722572Z","_minecraft_date_modified":"2026-03-24T07:56:30.308953Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/battlepass","_minecraft_icon_attachment_id":26379,"_minecraft_imported_at":"2026-06-01T09:50:08+00:00","_minecraft_import_hash":"b51588da6b0953ae185161d0fe1f8d32","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-26378","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/bpadmin reload` – Reload all configs
\n– `\/bpadmin setexp
\n– `\/bpadmin settier
\n– `\/bpadmin givepremium
\n– `\/bpadmin removepremium
\n– `\/bpadmin editor [tier]` – Open tier editor GUI
\n– `\/bpadmin stats` – View cache and performance stats
\n– `\/bpadmin forcesave` – Force save all dirty data<\/p>\n
\n– `battlepass.admin` – Admin commands (default: op)
\n– `battlepass.premium` – Premium reward access (default: false)<\/p>\n
\n– `config.yml` – Season settings, XP requirements, messages
\n– `quests.yml` – Quest definitions, rewards, requirements
\n– `rewards.yml` – Tier rewards, items, commands<\/p>\n
\n“`yaml
\nseason:
\n name: “Season 1 – Winter 2024”
\n max-tier: 50
\n exp-per-tier: 1000
\n“`<\/p>\n
\n– **Java Version**: 21+
\n– **Optional Dependencies**:
\n – Oraxen (custom items)
\n – ItemsAdder (custom items)
\n – Vault (economy rewards)
\n—<\/p>\n
\n– \u2705 **<1ms** reward claim time (async saves)\n- \u2705 **90% reduction** in disk I\/O vs immediate saves\n- \u2705 **Zero TPS impact** during auto-save cycles\n- \u2705 **500-player LRU cache** with smart eviction\n\n---\n\n## \ud83d\udc1b Support & Feedback\n\nFound a bug or have a suggestion? Please report issues with:\n- Server version (e.g., Paper 1.21)\n- Plugin version\n- Steps to reproduce\n- Console errors (if any)\n\n---\n\n**Made with \u2764\ufe0f by ResistanceCore**\n\n*If you enjoy this plugin, please leave a \u2764\ufe0f love and share with other server owners!*\n<\/p>\n","protected":false},"excerpt":{"rendered":"