Attention: plugin in beta report any bug or tell me what to add! ;D
BattlePass is a complete plugin for Minecraft servers that adds a seasonal progression system similar to modern battle royale games.
battlepass gui
View attachment 903523 actionbar mission notification Exp daily reward leaderboard for top player Custom shop
Coins
Main Features:
Level System: 54 levels to unlock by earning XP
Dual-Track Rewards: Free rewards for all players + exclusive premium rewards
Daily Missions: 5 random missions that reset every day (kills, mining, PvP, etc.)
Limited Seasons: Each season lasts 30 days with automatic reset
Global Leaderboard: Top 10 players with highest levels achieved
Intuitive GUI: Complete graphical interface with page navigation
SQLite Database: Secure saving of all progress
Smart Notifications: Automatic alerts for new available rewards
Exp Daily Reward, Actionbar mission notification and more..
Commands:
Permissions:
battlepass.admin - Access to administrative commands
battlepass.use - Allows use of /battlepass command
Configuration files:
Code (YAML):
# Battle Pass Messages Configuration # # Placeholders: # %player% - Player name # %level% - Current level # %xp% - Current XP # %xp_needed% - XP needed for next level # %total_levels% - Total levels earned # %season_time% - Time until season ends # %reset_time% - Time until daily missions reset # %amount% - Amount (for various contexts) # %mission% - Mission name # %progress% - Current progress # %required% - Required amount # %reward_xp% - XP reward amount # %target% - Target player name (for admin commands) # %current% - Current progress # %time% - Time remaining
# Errors player-only: "&cOnly players can use this command!" no-permission: "&cYou don't have permission to use this command!" player-not-found: "&cPlayer not found!" invalid-amount: "&cInvalid amount! Please enter a number." amount-must-be-positive: "&cAmount must be positive!"
# Help menu help:
header: "&6&lBattle Pass Commands:" battlepass: "&e/battlepass &7- Open the Battle Pass GUI" help: "&e/bp help &7- Show this help menu" reload: "&e/bp reload &7- Reload the configuration" add-premium: "&e/bp addpremium <player> &7- Give premium pass to a player" remove-premium: "&e/bp removepremium <player> &7- Remove premium pass from a player" add-xp: "&e/bp addxp <player> <amount> &7- Add XP to a player" remove-xp: "&e/bp removexp <player> <amount> &7- Remove XP from a player"
# Premium pass messages premium:
given-sender: "&aPremium pass given to %target% for this season!" given-target: "&6&lCONGRATULATIONS! &eYou now have the Premium Battle Pass!" removed-sender: "&cPremium pass removed from %target%!" removed-target: "&cYour Premium Battle Pass has been removed!" required: "&c&lYou need the Premium Pass to claim this reward!"
# XP messages xp:
added-sender: "&aAdded %amount% XP to %target%'s Battle Pass!" added-target: "&a&lYou received %amount% Battle Pass XP!" removed-sender: "&cRemoved %amount% XP from %target%'s Battle Pass!" removed-target: "&c&l%amount% Battle Pass XP has been removed!"
# Level up level-up: "&6&lLEVEL UP! &fYou are now level &e%level%" new-rewards: "&e&lNEW REWARDS! &fYou have new rewards available to claim!"
# Join messages rewards-available: "&eYou have &f%amount% &erewards available to claim!" rewards-notification: "&eYou have &f%amount% &enew rewards to claim!"
# Season messages season:
reset: "&6&l[SEASON RESET] &eThe Battle Pass season has ended! A new season begins now!" ends-in: "&7Season ends in: &e%season_time%" achievement: "%player% has completed the entire Battle Pass!" premium-achievement: "%player% has become a LEGEND by completing the Premium Battle Pass!"
# Daily reward messages daily-reward:
claimed: "&a&lDaily Reward Claimed! &fYou received &e%amount% XP!" already-claimed: "&cYou have already claimed your daily reward! Come back later."
# Battle Pass Configuration # Season duration in days season:
duration: 30
# Experience configuration # xp-per-level: Fixed XP required to advance to next level # Total XP needed for level 54 = xp-per-level × 53 # Examples: # - 100 XP per level = 5,300 total XP (very easy) # - 400 XP per level = 21,200 total XP (easy) # - 1000 XP per level = 53,000 total XP (balanced for 30 days) # - 2000 XP per level = 106,000 total XP (hard) experience:
xp-per-level: 200
# Daily reward configuration daily-reward:
xp: 200
# Battle Coins distribution configuration # Coins distributed to top 10 players every 24 hours # Format: position = coins amount battle-coins:
distribution:
1: 10
2: 9
3: 8
4: 7
5: 6
6: 5
7: 4
8: 3
9: 2
10: 1
Code (YAML):
# Battle Pass Missions Configuration # # You can create any type of mission with customizable requirements # # Mission Types: # - KILL_MOB: Kill a specific mob type # - BREAK_BLOCK: Break a specific block type # - MINE_BLOCK: Mine a specific block type (for ores, only counts if item drops) # - PLACE_BLOCK: Place a specific block type # - CRAFT_ITEM: Craft a specific item # - FISH_ITEM: Fish a specific item # - ENCHANT_ITEM: Enchant any item # - BREED_ANIMAL: Breed a specific animal type # - TAME_ANIMAL: Tame a specific animal type # - TRADE_VILLAGER: Trade with villagers # - KILL_PLAYER: Kill players # - DEATH: Die a certain number of times # - DAMAGE_DEALT: Deal damage to entities # - DAMAGE_TAKEN: Take damage # - WALK_DISTANCE: Walk a certain distance in blocks # - PLAY_TIME: Play for a certain amount of minutes # # Each mission pool will have missions randomly selected from it daily # The 'weight' determines how likely a mission is to be selected # # Available placeholders: # <amount> - The required amount for the mission # <target> - The target mob/block/item name
# Number of daily missions to generate daily-missions-count: 7