⚔️ 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!

🚨 Important Disclaimer

This is a fork of the original BattlePass plugin by lino9999.

📋 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.

Main menu

🆕 Improvements in this Fork

1. Extended Target Support for Missions

This allows tasks to be more generic and flexible with additional-targets parameter:

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:

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

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

🎮 Commands & Permissions

Command	Permission	Description
`/bp` or `/battlepass`	`battlepass.use`	Opens the main Battle Pass menu.
`/bp help`	`battlepass.use`	Shows the help menu with all available commands.
`/bp giveitem <type> <player> <amount>`	`battlepass.admin`	Gives special items to a player. Types: `premium` (Premium Pass Voucher), `coins` (Battle Coins), `levelboost` (Experience Boost), `xpevent` (XP Event Beacon).
`/bp addpremium <player>`	`battlepass.admin`	Force unlock Premium Pass for a player.
`/bp removepremium <player>`	`battlepass.admin`	Remove Premium Pass from a player.
`/bp addxp <player> <amount>`	`battlepass.admin`	Give XP to a player.
`/bp removexp <player> <amount>`	`battlepass.admin`	Remove XP from a player.
`/bp addcoins <player> <amount>`	`battlepass.admin`	Give Battle Coins to a player.
`/bp removecoins <player> <amount>`	`battlepass.admin`	Remove Battle Coins from a player.
`/bp reset season`	`battlepass.admin`	Force reset the entire season progress.
`/bp reset missions`	`battlepass.admin`	Force generate new daily missions for all players.
`/bp resetplayer <player>`	`battlepass.admin`	Reset battle pass progress, claimed rewards, and mission progress for a specific player.
`/bp reload`	`battlepass.admin`	Reloads all configuration files and restarts the coins distribution task.
`/bp edit rewards season <number>`	`battlepass.admin`	Opens the reward editor GUI for a specific season.
`/bp event <multiplier> <duration>`	`battlepass.admin`	Starts an XP boost event with the given multiplier and duration (in ticks/seconds depending on config).
`/bp stopevent`	`battlepass.admin`	Stops the currently active XP boost event.
`/bp excludefromtop <player>`	`battlepass.admin`	Exclude a player from appearing in the top leaderboard.
`/bp includetop <player>`	`battlepass.admin`	Include a previously excluded player back into the top leaderboard.

Commands

🧩 Placeholders (PAPI)

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").

(See Placeholders.md for the full list)

⚠️ Support & Credits

Support Information:

This is a community-maintained fork - not the official version
Issues should be reported to this fork's repository, not the original
No official support is provided by the original author for this modified version

Credits:

All original credit goes to lino9999 for creating the base plugin. This fork builds upon their work with additional features and updates.

BattlePass-Fork