MSP-BattlePass - Missions & Rewards

[HR][/HR]

FEATURES

• 
  []Fully configurable seasons with start and end dates.
  []Unlimited cumulative tiers with custom XP requirements.
  []Separate Free and Premium reward tracks.
  []Daily, weekly and season-long missions.
  []Automatic mission progress for joins, playtime, player kills, deaths, mob kills and block breaking.
  []Custom minigame objectives through the public Java API.
  []Paginated battle-pass and mission GUIs.
  []Single reward claiming and Claim All support.
  []Automatic season resets when the season ID changes.
  []Customizable menus, messages, icons and rewards.
  []Offline-capable administration commands.
  []Dependency-free per-player storage.
  []Asynchronous saves with atomic file replacement.
  []No NMS and no required third-party plugins.

MISSIONS

Create as many missions as your season needs.

Available periods:

• 
  []DAILY — resets every day.
  []WEEKLY — resets every Monday.
• SEASON — remains active for the complete season.

Built-in mission events:

• 
  []JOIN
  []PLAY_MINUTE
  []PLAYER_KILL
  []DEATH
  []MOB_KILL
  []BLOCK_BREAK
• CUSTOM

CUSTOM objectives allow SkyWars, BedWars, survival servers and any other minigame to report victories or server-specific actions through the API.

REWARD SYSTEM

Built-in reward types:

• 
  []Minecraft items
  []Console commands
  []Player messages
  []Namespaced sounds
• Custom reward providers registered through the API

[/LIST]
Available command placeholders:

• 
  []%player%
  []%uuid%
  []%tier%
  []%season%

Console command rewards make MSP-BattlePass compatible with most economy, crate, rank, permission and cosmetic plugins without requiring a direct dependency.

If a custom reward provider is unavailable, the reward remains unclaimed instead of being lost.

BATTLE-PASS GUI

• 
  []54-slot graphical interface.
  []Automatic pagination.
  []Player head with current level, XP and Premium status.
  []Remaining season time.
  []Visual mission progress bars.
  []Free and Premium reward information.
  []Left-click to claim Free rewards.
  []Right-click to claim Premium rewards.
  []Claim All button.
  []Protected inventories that prevent item movement.

PLAYER COMMANDS

Command aliases:

ADMINISTRATION COMMANDS

Administration commands support offline players.

PERMISSIONS

The previous mrslowpaintbattlepass.* and rodrigobattlepass.* permission namespaces remain accepted for compatibility.

CONFIGURATION

MSP-BattlePass generates three readable YAML files:

• 
  []config.yml — menus, saving intervals and security limits.
  []messages.yml — completely customizable messages and colors.
• season.yml — season dates, missions, tiers and rewards.

All tier icons and mission icons can use valid Minecraft materials.

STORAGE

Player profiles are stored locally by UUID.

The plugin saves:

• 
  []Experience and current tier.
  []Premium access.
  []Free and Premium claims.
  []Mission progress.
  []Mission reset periods.
  []Current season ID.

Profiles are saved asynchronously and use atomic file replacement to reduce the possibility of corrupted data.

MySQL and cross-server synchronization are not included in this version.

DEVELOPER API

The public MSPBattlePassAPI allows other plugins to:

• 
  []Add experience.
  []Advance missions.
  []Report custom objectives.
  []Grant or revoke Premium access.
  []Read player progress.
  []Register completely custom reward types.

Published Bukkit events:

• 
  []BattlePassExperienceEvent
  []BattlePassMissionCompleteEvent
  []BattlePassTierUnlockEvent
  []BattlePassRewardClaimEvent

Experience and reward-claim events are cancellable.

INSTALLATION

1. 
   []Stop your Paper server.
   []Place MSP-BattlePass-0.1.3-alpha.jar inside the plugins folder.
   []Start the server once to generate the configuration.
   []Stop the server and configure season.yml.
2. Start the server and run /bp admin season.

When upgrading from a previous version, MSP-BattlePass can automatically copy configuration and player data from the previous plugin folders while preserving the originals as backups.

IMPORTANT INFORMATION

• 
  []Premium checkout is external. Grant Premium through a command, store or another plugin.
  []Default rewards are examples and should be balanced for your server economy.
  []This release uses local per-player files and does not include MySQL.
  []Test console reward commands before using them in a live season.

LICENSE

MSP-BattlePass is open-source software released under the MIT License.

Copyright © 2026 MrSlowPaint.