⚔️ SxBattlePass


The ultimate Battle Pass and Quest system for Minecraft servers.
Increase player engagement, retention, and activity with daily quests, weekly challenges, seasonal progression, premium passes, boosters, leaderboards, and a powerful in-game editor.
Whether you run a Survival, Lifesteal, SMP, Prison, SkyBlock, RPG, or Minigame server, SxBattlePass provides everything you need to create an addictive progression system for your community.
━━━━━━━━━━━━━━━━━━━━
FEATURES
━━━━━━━━━━━━━━━━━━━━
✔ Battle Pass System
✔ Free & Premium Passes
✔ Daily Quests
✔ Weekly Quests
✔ Seasonal Progression
✔ Custom Rewards
✔ Experience & Tier System
✔ Points & Currency Support
✔ Quest Categories
✔ Leaderboards
✔ Boosters
✔ In-Game Editor
✔ PlaceholderAPI Support
✔ Vault Support
✔ Folia Support
✔ MySQL & SQLite Storage
✔ Highly Optimized
━━━━━━━━━━━━━━━━━━━━
QUESTS
━━━━━━━━━━━━━━━━━━━━
Create engaging quests for your players and reward them for completing challenges.
✔ Block Breaking
✔ Block Placing
✔ Mob Killing
✔ Player Killing
✔ Farming
✔ Mining
✔ Fishing
✔ Playtime
✔ Economy Tasks
✔ Custom Objectives
And much more.
━━━━━━━━━━━━━━━━━━━━
FREE & PREMIUM PASSES
━━━━━━━━━━━━━━━━━━━━
Offer free progression for all players while providing premium battle passes with exclusive rewards, quests, and bonuses.
Perfect for:
• Donators
• Seasonal Events
• Store Purchases
• VIP Members
━━━━━━━━━━━━━━━━━━━━
BOOSTERS
━━━━━━━━━━━━━━━━━━━━
Create powerful boosters that affect:
✔ Quest Progress
✔ Experience
✔ Points
✔ Rewards
✔ Currency
Apply boosters to individual players or your entire server.
━━━━━━━━━━━━━━━━━━━━
LEADERBOARDS
━━━━━━━━━━━━━━━━━━━━
Compete against other players and climb the rankings.
✔ Quest Leaderboards
✔ Tier Leaderboards
✔ Seasonal Competition
━━━━━━━━━━━━━━━━━━━━
IN-GAME EDITOR
━━━━━━━━━━━━━━━━━━━━
Manage your battle pass directly in-game.
✔ Edit Quests
✔ Edit Rewards
✔ Create New Content
✔ Configure Progression
✔ Save Changes Instantly
No complicated configuration required.

━━━━━━━━━━━━━━━━━━━━
PLUGIN INFORMATION
━━━━━━━━━━━━━━━━━━━━
Name: SxBattlePass
Author: Silent Dev
Minecraft Version: 1.21+
Folia Support: Yes
Paper Support: Yes
Spigot Support: Yes
Soft Dependencies:
• PlaceholderAPI
• Vault
━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━
1. Download SxBattlePass.jar
2. Place the jar into your plugins folder.
3. Restart your server.
4. Configure the plugin files.
5. Use /bpa reload after making changes.
━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━
battlepass.use
Regular player access.
battlepass.admin
Full administrative access.
battlepass.editor
Access to the in-game editor.
battlepass.debug.id
Displays quest and week IDs.
sxbattlepass.block
Blocks a player from using SxBattlePass.
━━━━━━━━━━━━━━━━━━━━
PLAYER COMMANDS
━━━━━━━━━━━━━━━━━━━━
Aliases:
/sxpass
/sxbp
/sxbattlep
/pass
/bp
/bp open
Open the main menu.
/bp menu
Open the main menu.
/bp open week <week>
Open a specific week.
/bp open event <event>
Open an event menu.
/bp booster
View active boosters.
/bp leaderboard
Open leaderboard menu.
/bp leaderboard quests
Open quest leaderboard.
/bp leaderboard tier
Open tier leaderboard.
/bp stats
View personal statistics.
/bp help
Show help menu.
━━━━━━━━━━━━━━━━━━━━
ADMIN COMMANDS
━━━━━━━━━━━━━━━━━━━━
Aliases:
/sxbpa
/bpa
/sxbattlepassa
/bpa reload
Reload the plugin.
/bpa editor
Open editor menu.
/bpa open week <week>
Open week menu as admin.
/bpa set pass <player> <pass-id>
Set a player's pass.
/bpa set pass all <pass-id>
Set pass for all players.
/bpa set pass online <pass-id>
Set pass for all online players.
/bpa set points <player> <points>
Set player points.
/bpa set balance <player> <amount>
Set player balance.
/bpa give points <player> <points>
Give points.
/bpa give balance <player> <amount>
Give balance.
/bpa giveall points <points>
Give points to everyone.
/bpa giveall balance <amount>
Give balance to everyone.
/bpa remove balance <player> <amount>
Remove balance.
/bpa boosters add <player/all> <type> <percent> <hours> <affects>
Add a booster.
/bpa boosters clear <player/all>
Clear boosters.
/bpa progress quest <player> <week> <quest-id> <amount>
Progress a quest.
/bpa progress daily quest <player> <quest-id> <amount>
Progress a daily quest.
/bpa quest ids
Display week quest IDs.
/bpa daily quest ids
Display daily quest IDs.
/bpa new season
Start a new season.
/bpa delete user <player>
Delete player data.
/bpa close menu <player>
Force close menu.
/bpa material item
Get item identifier.
/bpa material block
Get targeted block identifier.
/bpa material b64
Get Base64 data of held item.
/bpa migrate storage <newType>
Migrate storage.
/bpa bypass locked quests <player>
Toggle locked quest bypass.
━━━━━━━━━━━━━━━━━━━━
PLACEHOLDERAPI
━━━━━━━━━━━━━━━━━━━━
All placeholders begin with:
%battlepass_%
Player Data:
%battlepass_points%
%battlepass_experience%
%battlepass_tier%
%battlepass_pass_type%
%battlepass_pass_id%
%battlepass_balance%
%battlepass_completed_quests%
Time:
%battlepass_time_to_daily_reset%
%battlepass_time_to_next_week%
%battlepass_time_to_season_end%
Leaderboards:
%battlepass_top_tier_<place>_name%
%battlepass_top_tier_<place>_value%
%battlepass_top_quests_<place>_name%
%battlepass_top_quests_<place>_value%
━━━━━━━━━━━━━━━━━━━━
FEATURES OVERVIEW
━━━━━━━━━━━━━━━━━━━━
✔ Battle Pass Progression
✔ Free & Premium Passes
✔ Daily Quests
✔ Weekly Quests
✔ Seasons
✔ Experience System
✔ Tier Rewards
✔ Quest Rewards
✔ Leaderboards
✔ Boosters
✔ In-Game Editor
✔ PlaceholderAPI Support
✔ Vault Integration
✔ Folia Support
━━━━━━━━━━━━━━━━━━━━
⚡ PERFORMANCE
━━━━━━━━━━━━━━━━━━━━
✔ Minecraft 1.21+
✔ Folia Supported
✔ Async Operations
✔ Lightweight
✔ Production Ready
━━━━━━━━━━━━━━━━━━━━
SUPPORT
━━━━━━━━━━━━━━━━━━━━
Discord:
https://discord.gg/y6V4yh4RBM
Need help, found a bug, or have a suggestion?
Join our Discord server for support and updates.