BattlePass-Fork

# ⚔️ BattlePass > **The most advanced, feature-rich Battle Pass system for 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! ## 🧩 Version Compatibility | **Plugin version** | **Supported Paper** | **Java** | |--------------------|---------------------|----------| | `8.2.4+` | `1.21` – `26.2` | 25 | | `8.2.3` | `1.21` – `1.21.11` | 21 | ## 🚨 Important Disclaimer This is a **fork** of the original BattlePass plugin by (https://github.com/lino9999/BattlePass). ### 📋 Modifications from Original This fork includes the following enhancements: - **Expanded mission functionality** with additional features and mission types - Additional missions for players with premium pass - Various improvements and customizations beyond the original codebase ## 🌟 Why Choose BattlePass-Fork? Unlike 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**. ### 🔥 Key Features * **🏆 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). * **🛠️ 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. * **💾 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** *(Enhanced in this fork)* * **7 Daily Missions** (can customize) generated randomly every day. * **Extended Mission Types** with additional targets and parameters: - Kill specific mob types with `additional-targets` support - Trade with specific villager professions - Enchant multiple item types - Deal/take damage from specific sources - Track specific types of player movement - And more! * **2 Premium Missions** (can customize) generated every day for players with premium pass. * **💰 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. * **🔌 Powerful Integrations** * **PlaceholderAPI**: Full support for scoreboards, tabs, and chat. * **MythicMobs**: Create missions to kill specific custom bosses or mobs. !(https://cdn.modrinth.com/data/QTHpugE4/images/5e678c238023e1fc9e257a27e42e087943da4984.png) ## 🆕 Improvements in this Fork ### 1. **Extended Target Support for Missions** This allows tasks to be more generic and flexible with `additional-targets` parameter: ```yaml kill-skeletons: type: KILL_MOB target: SKELETON additional-targets: - STRAY - BOGGED display-name: "Kill <amount> Skeletons" min-required: 10 max-required: 25 min-xp: 100 max-xp: 200 weight: 10 ``` ### 2. **Specific Villager Profession Trading** Supported targets: `ANY`, `FARMER`, `FISHERMAN`, `SHEPHERD`, `FLETCHER`, `LIBRARIAN`, `CARTOGRAPHER`, `CLERIC`, `ARMORER`, `WEAPONSMITH`, `TOOLSMITH`, `BUTCHER`, `LEATHERWORKER`, `MASON`, `MERCHANT`. ### 3. **Multi-Item Type Enchanting Support** Example: ```yaml enchant-swords: type: ENCHANT_ITEM target: DIAMOND_SWORD additional-targets: - "NETHERITE_SWORD" - "IRON_SWORD" - "GOLDEN_SWORD" - "COPPER_SWORD" - "STONE_SWORD" - "WOODEN_SWORD" display-name: "Enchant <amount> swords" min-required: 1 max-required: 3 min-xp: 150 max-xp: 300 weight: 5 ``` ### 4. **Enhanced Damage Tracking** - **Damage Dealt** to specific mob groups - **Damage Taken** from specific sources (FIRE, LAVA, FALL, etc.) - **Death Tracking** from specific causes ### 5. **Specific Movement Type Tracking** Supported targets: `ANY`, `WALK`, `SWIM`, `FLY`, `SNEAK`. ### 6. **Extended Mission Parameters** - Flexible damage amount requirements - Multiple mob/entity targeting - Profession-specific villager interactions ### 7. **Extended Mission Parameters** - Added the ability to add additional missions to players with a premium pass. - `missions.yml` - `premium-additional-missions: 2` ## 📥 Installation 1. Download `BattlePass-Fork.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. ## 🎮 Commands & Permissions | Command