# \u2694\ufe0f BattlePass<\/p>\n
> **The most advanced, feature-rich Battle Pass system for Paper servers.**
\n> Engage your players with Daily Missions, Tiered Rewards, and a custom Currency Shop.
\n> **No config editing required** \u2014 manage everything via In-Game GUI!<\/p>\n
## \ud83d\udea8 Important Disclaimer<\/p>\n
This is a **fork** of the original BattlePass plugin by lino9999.<\/p>\n
### \ud83d\udccb Modifications from Original
\nThis fork includes the following enhancements:
\n– **Expanded mission functionality** with additional features and mission types
\n– Additional missions for players with premium pass
\n– Various improvements and customizations beyond the original codebase<\/p>\n
## \ud83c\udf1f Why Choose BattlePass-Fork?
\nUnlike other plugins, **BattlePass-Fork** 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**.<\/p>\n
### \ud83d\udd25 Key Features<\/p>\n
* **\ud83c\udfc6 Seasonal Progression System**
\n * Fully customizable tier system (default 54 levels).
\n * **Dual Reward Tracks**: Free Pass (for everyone) and Premium Pass (VIP\/Paid).
\n * Automatic season reset options (Monthly or Duration-based).<\/p>\n
* **\ud83d\udee0\ufe0f In-Game GUI Editor (No YAML needed!)**
\n * **Mission Editor**: Create, edit, or delete daily missions directly inside the game.
\n * **Rewards Editor**: Drag-and-drop items from your inventory to set rewards for any level.<\/p>\n
* **\ud83d\udcbe Database & Sync Support**
\n * **SQLite** (Default): Plug and play for single servers.
\n * **MySQL**: Full support for syncing player progress, XP, and rewards across a BungeeCord\/Velocity network.<\/p>\n
* **\ud83d\udcdc Dynamic Missions** *(Enhanced in this fork)*
\n * **7 Daily Missions** (can customize) generated randomly every day.
\n * **Extended Mission Types** with additional targets and parameters:
\n – Kill specific mob types with `additional-targets` support
\n – Trade with specific villager professions
\n – Enchant multiple item types
\n – Deal\/take damage from specific sources
\n – Track specific types of player movement
\n – And more!
\n * **2 Premium Missions** (can customize) generated every day for players with premium pass.<\/p>\n
* **\ud83d\udcb0 Battle Coins & Shop**
\n * Players earn **Battle Coins** by ranking in the daily leaderboard.
\n * Spend coins in the customizable **Shop GUI** for exclusive items, XP boosts, or commands.<\/p>\n
* **\ud83d\udd0c Powerful Integrations**
\n * **PlaceholderAPI**: Full support for scoreboards, tabs, and chat.
\n * **MythicMobs**: Create missions to kill specific custom bosses or mobs.<\/p>\n
<\/p>\n
## \ud83c\udd95 Improvements in this Fork<\/p>\n
### 1. **Extended Target Support for Missions**
\nThis allows tasks to be more generic and flexible with `additional-targets` parameter:<\/p>\n
“`yaml ### 2. **Specific Villager Profession Trading** ### 3. **Multi-Item Type Enchanting Support** “`yaml ### 4. **Enhanced Damage Tracking** ### 5. **Specific Movement Type Tracking** ### 6. **Extended Mission Parameters** ### 7. **Extended Mission Parameters** ## \ud83d\udce5 Installation<\/p>\n 1. Download `BattlePass-Fork.jar`. ## \ud83c\udfae Commands & Permissions<\/p>\n | Command | Permission | Description | <\/p>\n ## \ud83e\udde9 Placeholders (PAPI)<\/p>\n Add these to your scoreboard or tablist!<\/p>\n * `%battlepass_level%` – Player’s current tier. *(See `Placeholders.md` for the full list)*<\/p>\n ## \u26a0\ufe0f Support & Credits<\/p>\n ### Support Information: ### Credits: Battle Pass system. Engage your players with Daily Missions, Tiered Rewards, and a custom Currency Shop<\/p>\n","protected":false},"featured_media":26383,"template":"","meta":{"_minecraft_slug":"battlepass-fork","_minecraft_project_id":"QTHpugE4","_minecraft_author":"FlyAwayMaking","_minecraft_license":"MIT","_minecraft_downloads":106,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"battlepass-fork.zip","_minecraft_size_bytes":1037493,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-15T19:35:18.057471Z","_minecraft_date_created":"2026-01-14T01:57:05.005754Z","_minecraft_date_modified":"2026-02-20T17:35:25.120265Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/battlepass-fork","_minecraft_icon_attachment_id":26383,"_minecraft_imported_at":"2026-06-01T09:50:15+00:00","_minecraft_import_hash":"8f6e772cfb87b6e7f731b060d24753ea","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,844,89,127,128],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-26382","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","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
\nkill-skeletons:
\n type: KILL_MOB
\n target: SKELETON
\n additional-targets:
\n – STRAY
\n – BOGGED
\n display-name: “Kill
\n min-required: 10
\n max-required: 25
\n min-xp: 100
\n max-xp: 200
\n weight: 10
\n“`<\/p>\n
\nSupported targets: `ANY`, `FARMER`, `FISHERMAN`, `SHEPHERD`, `FLETCHER`, `LIBRARIAN`, `CARTOGRAPHER`, `CLERIC`, `ARMORER`, `WEAPONSMITH`, `TOOLSMITH`, `BUTCHER`, `LEATHERWORKER`, `MASON`, `MERCHANT`.<\/p>\n
\nExample:<\/p>\n
\nenchant-swords:
\n type: ENCHANT_ITEM
\n target: DIAMOND_SWORD
\n additional-targets:
\n – “NETHERITE_SWORD”
\n – “IRON_SWORD”
\n – “GOLDEN_SWORD”
\n – “COPPER_SWORD”
\n – “STONE_SWORD”
\n – “WOODEN_SWORD”
\n display-name: “Enchant
\n min-required: 1
\n max-required: 3
\n min-xp: 150
\n max-xp: 300
\n weight: 5
\n“`<\/p>\n
\n– **Damage Dealt** to specific mob groups
\n– **Damage Taken** from specific sources (FIRE, LAVA, FALL, etc.)
\n– **Death Tracking** from specific causes<\/p>\n
\nSupported targets: `ANY`, `WALK`, `SWIM`, `FLY`, `SNEAK`.<\/p>\n
\n– Flexible damage amount requirements
\n– Multiple mob\/entity targeting
\n– Profession-specific villager interactions<\/p>\n
\n– Added the ability to add additional missions to players with a premium pass.
\n– `missions.yml` – `premium-additional-missions: 2`<\/p>\n
\n2. Drop it into your server’s `\/plugins\/` folder.
\n3. (Optional) Install **PlaceholderAPI** for placeholders.
\n4. Restart your server.
\n5. Enjoy! Config files (`config.yml`, `missions.yml`, `shop.yml`) will generate automatically.<\/p>\n
\n|:—————————————-|:——————-|:—————————————————————————————————————————————————————-|
\n| `\/bp` or `\/battlepass` | `battlepass.use` | Opens the main Battle Pass menu. |
\n| `\/bp help` | `battlepass.use` | Shows the help menu with all available commands. |
\n| `\/bp giveitem
\n| `\/bp addpremium
\n| `\/bp removepremium
\n| `\/bp addxp
\n| `\/bp removexp
\n| `\/bp addcoins
\n| `\/bp removecoins
\n| `\/bp reset season` | `battlepass.admin` | Force reset the entire season progress. |
\n| `\/bp reset missions` | `battlepass.admin` | Force generate new daily missions for all players. |
\n| `\/bp resetplayer
\n| `\/bp reload` | `battlepass.admin` | Reloads all configuration files and restarts the coins distribution task. |
\n| `\/bp edit rewards season
\n| `\/bp event
\n| `\/bp stopevent` | `battlepass.admin` | Stops the currently active XP boost event. |
\n| `\/bp excludefromtop
\n| `\/bp includetop
\n* `%battlepass_xp_progress%` – Formatted XP (e.g., 50\/200).
\n* `%battlepass_premium_status%` – Returns “Active” or “Inactive”.
\n* `%battlepass_season_time%` – Time remaining in the current season.
\n* `%battlepass_coins%` – Current Battle Coins balance.
\n* `%battlepass_daily_reward_available%` – Check if daily reward is ready (“Yes”\/”No”).<\/p>\n
\n– This is a **community-maintained fork** – not the official version
\n– Issues should be reported to this fork’s repository, not the original
\n– No official support is provided by the original author for this modified version<\/p>\n
\nAll original credit goes to lino9999 for creating the base plugin.
\nThis fork builds upon their work with additional features and updates.<\/p>\n","protected":false},"excerpt":{"rendered":"