MicroBattle Minigame Plugin v1.3

If you’re enjoying the resource, I’d really appreciate you taking a moment to leave a review. Development takes a lot of time and effort, and your feedback truly helps and motivates me to keep improving! Thank you!

• Added /microbattle settings command which allows configuring many settings
• Added chest loot customization via /microbattle settings
• Added /microbattle spectate [player] command to spectate players currently in games, also works with skywars.spectate permission
• The /microbattle games command now opens a GUI where you can join a game directly or spectate it if it is running, also works with microbattle.spectate permission
• JsLobby: Added the /profile command for opening the Profile Menu
• JsLobby: Added the /jslobby games command (also available for players with <minigame>.spectate / jslobby.spectate permission), replacing /jslobby list
• Optimized map collapse system
• Added support for version 26.1 (resource pack update required)
• Items no longer drop on death
• More blocks can now be broken faster without tools
• Added new date formats to the scoreboard: %date_daymonth% (25/02/2026) and %date_daymonthdots% (25. 02. 2026)
• Improved Setup mode
• Joining a new available game now also considers other servers if BungeeCord mode is enabled
• Now possible to give currency to offline players
• Changed the argument order for /microbattle give <economy> <player> <amount> to /microbattle give <player> <economy> <amount>
• Joining a new available arena now also allows players with the game.joinfullserver permission
• Accessing the Kit Layout Editor now only requires a shift-click
• AFK check now only runs during an active game
• Increased the time before AFK players are kicked from 90 seconds to 150 seconds
• Added an option to disable the Anti-AFK system in /microbattle settings
• Fixed cases where the Anti-AFK system did not work properly
• Added the ability to reset the default kit by right-clicking the selected kit in the Kit Selector
• Added the ability to reset selected cosmetics
• Improved automatic kit lore formatting
• Improved Server Management
• Improved how statistics are handled
• Teleporting to a player using the Teleporter now closes the inventory
• Players with the same number of kills now share the same rank in Top Players
• Top Players now supports plural forms of score name
• Updated Reward Summary design: reward breakdown is now shown below the header instead of on hover (only when Daily Reward Track is enabled, as it has fewer rewards and won’t spam chat)
• Added server health monitoring. If the server runs into issues (e.g., high memory usage), a restart will be triggered. The system automatically decides whether ongoing arenas can finish or not
• Added /scheduleRestart [hardDeadline] command to schedule a restart (e.g., for plugin updates)
  • hardDeadline = true > allows arenas to finish
  • hardDeadline = false > enforces a strict deadline (10m)
• Added a small reward summary to the post-death game summary
• Added Monthly, Weekly, and Daily statistics
• Added command /microbattle delete <map>
• Rewritten instant void kill
• Adjustments and fixes in the Level System
  • Players now start at level 0
  • Updated Level Ranges to align with Level Evolution
  • Updated Level Up Banner
  • Fixed incorrect color for Level Evolution 80-89
  • Fixed issue where players couldn’t progress past level 10 and could claim infinite rewards
  • Fixed issues with level 100
  • Fixed issue where unclaimed reward for level showed the current level instead of the level applicable to the unclaimed reward
• Weekly quests now reset every Monday instead of using local week start
• The Waiting Lobby inventory is no longer updated every time an inventory is closed. It will now only update when needed, such as when a blinking item indicates an unclaimed reward
• Added a current balance message after purchasing an extra map vote

Bug Fixes:

• Offline players are now correctly included in Top Players
• Post-death Game Summary is no longer sent if the player dies and the game ends
• Fixed the multi-kill messages (Double Kill, Triple Kill, Quadra Kill, Penta Kill)
• Fixed unremoved %team_color% placeholder in player's chat messages
• Fixed %dead_color% placeholder in kill message preview
• Fixed gamesPerServer setting
• Fixed a bug that could prevent the scoreboard from updating correctly for some players
• Fixed an error related to players disconnecting before the post-game win streak message was sent.
• Fixed issue where searching for a new available arena included arenas in the final phase, sending players to the lobby
• Fixed the join message where the online player count was sometimes incorrect
• Fixed the title.winner message
• Fixed an issue where spectators could die from TNT
• Fixed flying in Spectator mode
• Fixed an issue where spectators could pick up arrows from the ground
• Fixed an issue where armor was not removed upon becoming a spectator after death
• Fixed an issue where game ending could trigger multiple times, causing problems
• Fixed an issue where map votes were not properly removed when a player disconnected
• Fixed an issue where daily rewards could be claimed infinitely after the previous update until the player closed the inventory
• Fixed some Projectile Trails dropping collectible item stacks
• Fixed an issue where Daily Reward Track did not grant rewards
• Fixed an issue where players could be kicked for AFK even after moving once the countdown had started
• Fixed an issue where a player received the win message after joining a new arena before it was sent
• Fixed an issue where the plugin sometimes failed to properly integrate with Vault
• Fixed a bug where rewards were not shown in the Daily Reward Track after completing all tiers but still having unclaimed rewards
• Fixed an issue where, in some cases, the player got stuck on the death screen
• Fixed an issue where chat.current_balance showed the balance before the currency was deducted
• Fixed an issue where kit purchase costs were only deducted during the first game when playing multiple games without relogging
• Fixed an issue where minutes were displayed incorrectly in hologram.leaderboard.will_update_in in JsLobby Top Stats Hologram when 1–2 minutes remained
• Fixed issue where, in some cases, Daily Reward Track did not work correctly when a player disconnected from a ongoing game
• Fixed issue where, in some cases, Daily Reward Track did not work correctly when claiming an unclaimed reward from previous days
• Fixed incorrect check for enough players when a player disconnected with minPlayers < 5
• Fixed issue where some end-of-game actions didn’t execute if a spectator joined during the game
• Fixed console error occurring when a player disconnected right after dying
• Fixed incorrect weekly quest reset at the turn of the year
• Fixed mobs spawning in the Waiting Lobby
• Fixed issue where XP orbs would follow spectators (the affected spectatormay still see it, but it is not visible to other players)
• Fixed issue where spectators could push or block players
• Fixed incorrect color formatting in special item lore when using '&' codes
• Fixed an issue where players could swap hand items while in Spectator mode
• Fixed an issue where reaching a new level also changed the player’s vanilla XP level

• Players no longer receive a cosmetics data error message on their first join
• Fixed an issue where the Level System did not work properly on a player’s first join, which also affected chat

Join our Discord to stay up to date with discounts and updates, share your ideas, and report any bugs. https://discord.gg/UFJXmsrX2c

Join our Discord to stay up to date with discounts and updates, share your ideas, and report any bugs. https://discord.gg/UFJXmsrX2c

• Added support for 1.21.9, 1.21.10, and 1.21.11
• Added reworked Top Stats Hologram
• Added simple Lobby System. Commands like joining an arena or the best arena. Ability to set up player stats and top stats for minigames
  • In the future, the Lobby System is planned to be improved and more features will be added. Currently, the admin has to handle lobby-related things like setting up items and NPCs that teleport players into the world
  • I am aware that lobby system should have been in the plugin a long time ago. Sorry it took so long
• When opening the Map Voting GUI, the maps no longer shuffle and the map order will always remain the same. If there are more than 9 maps, the maps will rotate
• Scores in the Reward Summary are now properly sorted
• Items can no longer be placed in the offhand in the Waiting Lobby
• Fixed database table creation on first startup
• Various small fixes

• Improved handling of disconnected players
• Added Level Up Banner
• Individual player stats holograms no longer display for every player
• Multi-word statistics now load correctly
• Fixed database issues
• Fireworks celebrating the game winner will no longer spawn multiple times per player
• Fixed killing players when the killer has no kill message cosmetics

We apologize for any issues caused. In the latest v2.1 update, large portions of the code were rewritten, which unfortunately led to a few bugs slipping through. Thank you for your patience and support!

GameAPI now included in the plugin; remove GameAPI plugin from /plugins to avoid conflicts

Future plans can be found at the end of the changelog

Changelog:

• Level System added
  • Players gain XP by playing and level up as they progress.
  • Currently, rewards include only coins and cosmetic tokens, but additional rewards are planned for the future, such as extra Quest slots, cosmetic crates, and coin boosters (subject to change)
  • To disable, add levelSystem: false in the config.yml
  • To display Level Evolution icons in player chat messages, remove chat.format.x from language files
• Daily Reward Track added: players earn XP by playing and receive rewards for reaching each tier (for now max 7 claims)
  • Players currently receive only coins and cosmetic tokens, but in the future, they will receive reward crates containing additional possible rewards.
  • This will also be used for various events, where players will receive limited currency that they can use to purchase chests containing limited cosmetics (subject to change)
  • Level System must be enabled
  • To disable, add dailyRewardTrack: false in the config.yml
• Optimazation
• Players must now confirm cosmetic and perk purchases
• Added map destruction after a certain time
• Improved grenades
• Added Team Selector
• Disabled tool interactions with blocks
• Added an option to allow players to break blocks by hand almost as fast as with an axe or pickaxe. Kits no longer need to include an axe or pickaxe, reducing the number of items.
• Spectators can now view chests
• Coin Bonus added for quests, level system, and daily rewards - permission: vip.bonus.x (x = 5, 7, 10, 12, 15, 17, 20, 25, 30, 45, 50, 75, 100)
• Quests now reset at fixed times
• Quests now start automatically for players
• Players must claim quest rewards themselves
• CoinsAPI support removed; connect CoinsAPI with VaultAPI and set useVault to true in config
• Purchasing cosmetics now requires new cosmetic tokens, obtainable via Level up or Daily Reward Track
• Language selection added in the new Player Menu
• Cosmetics can now be managed in the new Player Menu
• Added message informing players that coins for purchased kits are deducted after the game starts
• Stats hologram design updated
• Top Statistics temporarily removed (requires rework)
• DecentHolograms no longer required for stats holograms
• ResourcePack reorganized
• Background added to boss bar
• /microbattle start now ignores player count check if a player disconnects
• Players without selected kit will have Kit Selector open at 10 seconds into start
• Each game now has its own Waiting Lobby world
• Better Number formatting added in multiple messages
• BossBar optimized
• Lava no longer spreads
• Lava now deals damage only when the player is inside it

Special items will no longer work in saved kits after the update. Item recognition has changed due to optimization. Please replace existing items in your kits using /microbattle items. If you are using default plugin kits, just delete the kits.yml file from /plugins/microbattle. We apologize for the inconvenience.


Bug Fixes:

• Special items can no longer be used during the Preparation phase
• Spectators can no longer pick up XP from the ground
• Players can no longer receive rewards for killing themselves
• Fixed price display in /microbattle kits list
• Fixed display of player heads in chat and actionbar for non-premium accounts
• Fixed issue where game worlds containing “world” or “nether” in the name were not deleted
• Fixed title translation for victory message
• Fixed bug where multiple teams could be created in some cases exceeding the limit.
• Fixed placeholder in chat.assisted message

Future Plans:

• Lobby System
• New rewards for the LevelSystem and the Daily Reward Track
• More extensive use of the resource pack
• Limited seasonal cosmetics
• Weekly statistics (possible rewards for top-ranked players)
• Cosmetic System rework and new cosmetics
• Quest system rework (?)
• More plugin customization

• Added support for bold and italic styles in the boss bar
• Added HEX color support for titles and action bar
• Added PlaceholderAPI support in the scoreboard and messages
• %time% in the scoreboard title now updates every second
• Fixed issue with quests not being properly sorted in the GUI
• Fixed bug where Reward Summaries were being sent to the wrong players
• Fixed 'Waiting for players' boss bar showing even after the game started

• Optimization
• Game worlds that couldn't be deleted (e.g., after an unexpected server shutdown) are now automatically deleted on startup
• Fixed world creation issues when not using Slime World Manager
• Fixed map authors formatting (visible for newly created maps)

• The daily quest "Marksman" now has the correct completion goal
• Earned advancements no longer appear in chat
• Scoreboard optimization
• Fixed a bug where players sometimes did not receive the Rewards Summary at the end
• Fixed an issue where the plugin wouldn't work if the SlimeWorldPlugin was not present on the server