BattlePass-Fork

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： paper purpur

标签： adventure economy game-mechanics

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

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

🆕 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

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

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