Blue Arcade

• Fixed a critical bug in party mode that caused the flow to break after the second round.
• Fixed MySQL connections using caching_sha2_password by allowing JDBC public key retrieval.

• Added separate end messages (summary.final_standalone) and scoreboards (scoreboards.finish_standalone) for standalone mode arenas.
• Party mode arenas now support disabling player voting with /baa arena disablevoting <true|false>. When voting is off, games are selected randomly or in a fixed order if configured.
• Party mode arenas now support a fixed game sequence with /baa arena setgameorder <game1,game2,...>. Games cycle through the defined order when voting is disabled. /baa arena cleargameorder resets it to random selection.
• Spectator mode: Players joining a running arena will be warned and, if they click again, placed in spectator mode. Spectators are invisible to players, cannot affect the game, and are removed after the arena ends or via /ba leave.
• /ba quickjoin now prioritizes the arena with the most players waiting, filling existing parties before creating new arenas.
• Fixed incorrect "has already started" message for /ba join and arena signs when an arena is RESTARTING. Now displays the appropriate restarting message.
• Fixed issue where players in dynamic arenas were sent to the wrong spawn location (default world spawn) after the arena ended. Now they are teleported to the configured main lobby or fallback locations.

• New arena type system: arenas can now be either static or dynamic. Static arenas keep the classic persistent world behavior (default), while dynamic arenas create a fresh temporary world for each match. This is the foundation for future features like on demand arenas, events, private games, ready made maps, and more.
• The command /baa info [id] now shows the arena type.
• Existing arena configurations without a type setting are automatically treated as static, ensuring full backward compatibility.
• Party mode arena regeneration has been improved. Old arenas now restore in the background after players have already been moved into the next minigame, so match flow is smoother and no longer delayed.
• Fixed placeholders %bluearcade_arena_[id]_state% and %bluearcade_arena_current_state%. They now correctly return every arena state: waiting, starting, running, finishing, and restarting.

• Fixed reward delivery for players who leave during the end countdown.
• Fixed play menu arena items for the restarting state.
• Arena ground item cleanup now runs after arena regeneration completes.

• New regeneration system. Arena data is now stored in compact binary files instead of JSON and loaded only when needed. Optimizes memory handling for safer and more reliable arena resets.
• New arena structure. Each game has its own folder so files like schematics, regen data and config stay organized together.
• Automatic migration on first startup. Existing data is reorganized and a backup is created before any changes.
• New placeholder %bluearcade_module_<module_id>_players%. Shows how many players are currently active across all arenas using that module.
• The /ba quickjoin command now respects the current arena mode and game if the player is still inside one, and works normally after leaving.
• Fixed reward timing. Rewards are now given after players return to the lobby and their inventory is restored, preventing item rewards from being lost.
• Fixed reconnect issue. Players who rejoin after disconnecting in a mini-game get a short period of invincibility to avoid fall damage while their position is restored.

API CHANGES

• GameModule.getDisplayName() default method. Modules can now override this to declare their own display name. The core checks this method before falling back to the language.yml lookup or the descriptor name.
• ModuleConfigAPI.registerCopyOnly(String fileName) registers a config file using a copy if missing strategy: the bundled resource is only copied to disk when the file does not exist; afterwards the file is loaded without merging defaults, so entries the admin deliberately removed are never restored.
• MenuAPI.registerModuleMenuAPI(String moduleId, MenuAPI handler) and MenuAPI.unregisterModuleMenuAPI(String moduleId) modules can now register a custom MenuAPI handler for their own menus without touching the core implementation class.
• ItemClickHandler<P> functional interface for GUI item click callbacks in the inventory API.
• ItemAPI.registerClickHandler(String itemId, ItemClickHandler handler) and ItemAPI.unregisterClickHandler(String itemId) modules can now register click handlers for their lobby items.
• HytaleEventRegistry interface allows Hytale modules to register ECS systems in registerEvents() without reflection.
• MCSoundsAPI interface (extends SoundsAPI) with playNBS(P, String) and stopNBS(P) for Minecraft specific NoteBlock song playback.
• HTSoundsAPI interface (extends SoundsAPI) with playMIDI(P player, String midiId) and stopMIDI(P player) for Hytale specific MIDI song playback.
• Deprecated SoundsAPI.playNBS: use MCSoundsAPI.playNBS (Minecraft) or HTSoundsAPI.playMIDI (Hytale) instead.

All changes are additive and require no modifications to existing 3.2 modules.

CORE CHANGES

• /ba join now opens a minigame categories menu before the arena list, grouping available arenas by minigame.
• Added use_categories option in play_menu.yml (default: true). Set to false to restore the previous flat arena list behaviour.

• Added an optional ghost effect at the end of a game. If enabled, players in the arena will appear as invisible during the final phase. Disabled by default.
• Added a reconnect timeout for party leaders. If the leader disconnects, the party will wait a set amount of time for them to return. If they do, they keep leadership. If not, the party is disbanded.

• Added tab list arena isolation. While inside an arena, players only see other players from the same arena in the tab list.
• Added team color indicator in the tab list. In team games, each player's name is prefixed with a colored square (█) matching their team color.
• Added show_global toggle to stats_menu.yml. When set to false, global stats are hidden from the stats menu and categories view.
• Module version comparison now supports both semantic versioning (x.x.x) and commit-based versioning (YYYYMMDD-hash).
• Fixed stats menu not reflecting label changes from language.yml.

• Added automatic arena item and mob cleanup to keep maps clean before and after matches.
• Players can no longer pick up dropped items during the finish phase.
• Added a new config loading method that preserves default files without overwriting existing ones (temporary solution until API update).

• Updated default party menu configs so the leave action also closes the menu.
• Fixed deleted YAML menu items being restored on reload.
• Simplified dedicated main lobby messages.

• Added support for Spigot 26.1. Current limitations:
  • Scoreboards do not have RGB colors.
  • Menus do not have RGB colors.

• Fixed corrupt .jar

• Fixed podium reassignment causing an UnsupportedOperationException when moving already-listed winners.
• Fixed optional spawns being incorrectly processed during pre-match waiting.

• Moved some hardcoded messages to language.yml for better localization.
• Fixed message delivery issues and added console warnings for blank or missing messages.
• Fixed module display names to prioritize each module language.yml over descriptor defaults.
• Introduced experimental database changes to prevent server thread blocking during data sync.

• NEW MICROGAME: Bridge Race - Build bridges to reach the finish line first - https://store.blueva.net/resources/resource/32-bridge-race/
• Replaced /baa setmainlobby with /baa mainlobby, which also adds options to clear the lobby, teleport to it, and enable a dedicated lobby world for features like lobby items and scoreboard support.
• Leaving a message blank in language.yml now disables it instead of showing the default fallback text.

- NEW MICROGAME: Water Well - Jump into the water well from above and score points - https://store.blueva.net/resources/resource/31-water-well/
- Added WorldEdit support for faster arena restores. Blue Arcade can now generate and reuse .schem snapshots for configured regions. A warning is shown when saving very large regions without WorldEdit/FAWE.
- Fixed shift-click party invites. Invites now only trigger if the player is already in a party, preventing incorrect “not leader” messages.
- Fixed a rare issue in the game summary where the same player could appear in multiple podium positions when matches had very few players.
- Updated /baa arena <id> setrounds to work in standalone mode. The command now shows a warning explaining that rounds are primarily designed for party mode, and standalone will repeat the same minigame for the configured number of rounds.

- NEW MICROGAME: Splegg - Shoot eggs to break the floor and be the last standing - https://store.blueva.net/resources/resource/30-splegg/
- Added debug mode to settings.yml to more easily detect problems during plugin development or configuration.

- NEW MINIGAME: Capture The Wool - Capture enemy wools from their base and bring them back to yours. First team to capture all wools wins - https://store.blueva.net/resources/resource/29-capture-the-wool/
- Improved end of match flow in standalone games to make sure the correct winner celebration is used.
- Fixed victory celebrations in team games so the winning team now gets their effects and end music more reliably.

- Fixed the HologramAPI implementation by migrating to TextDisplay based holograms.

- Improved version comparison logic to avoid occasional false "new update" notices caused by formatting differences.
- Improved update-check stability so temporary empty responses from the update service are handled more safely.
- Deprecated manual sign text formats (like [BlueArcade]) are now actively blocked, reinforcing command based sign setup (/baa signs set).

- Added /baa upgradefiles to help migrate BlueArcade V2 files to V3 format. It is highly recommended that you create a backup of your files before running it.

- Improved how time_played is displayed, it now shows a readable duration format (for example, 1h 12m 9s) instead of raw seconds.
- Corrected a small capitalization detail in the default global stat label for better visual consistency.

- Added a new teams.manager section in settings.yml. Server owners can now customize team IDs, team names, team icons (materials), and set the maximum number of teams available in team-based modes.
- Improved startup spawn behavior. If a game module disables shared spawns, the Core will no longer force players into the default arena spawn. Modules that don’t require spawns can now fully manage their own spawn system.

- Fixed a /ba quickjoin error that could affect some Spigot/Paper forks (for example, Leaf) due to runtime compatibility differences, quickjoin now works correctly again on those servers.
- Fixed internal version of the plugin that marked a previous version as current.

API CHANGES:
- Added SchedulerAPI access to SetupContext, allowing setup handlers to run world-thread tasks directly without relying on world.execute().
- Added PlatformType enum ("MINECRAFT", "HYTALE") to declare the target platform in module.yml via the new platform field. If omitted, the module is treated as cross-platform.
- Added ModuleInfo.getPlatform() so modules can query their declared platform at runtime.
- Added SetupRequirement enum ("BOUNDS", "SPAWNS", "TIME") and GameModule.getDisabledRequirements() so modules can opt out of default setup requirements. The core skips prompts and validation for disabled requirements.
- Deprecated GameConfig.requiresBounds() and GameConfig.requiresSpawns() in favor of GameModule.getDisabledRequirements().
- Added GameModule.allowJoinInProgress() to let modules declare whether players may join after a match has started in standalone mode. Default: disabled. Party mode always disallows join-in-progress.
- Separated platform-specific menu types into:
- ui.menu.minecraft (Java/Bedrock menus)
- ui.menu.hytale (Hytale custom UI pages)
- Legacy ui.menu classes are now deprecated.
- Added experimental HytaleMenuAPI and HytaleMenuActionHandler to register/open HytaleMenuDefinition menus and dispatch module actions from Hytale UI event bindings.

All changes are additive and require no modifications to existing 3.1 modules.

- Fixed a bug that occurred when the Blueva Store API did not respond (e.g during website maintenance).
- Fixed a bug that prevented NBS files with spaces in their names from being loaded.

- Added "/ba quickjoin" tab completion that now suggests currently available selector arguments based on enabled waiting arenas.
- Added optional integration toggles in "settings.yml" under "integrations.force_disable" to force-disable PlaceholderAPI, NoteBlockAPI, Vault, and Floodgate/Geyser behavior when needed.
- Fixed a bug where some messages in the store menu did not render colors.

- Store confirm menu action chains now continue only when /ba store purchase succeeds
- Updated the version of Metrics (bStats).

- Fixed module auto-update checks to resolve the latest release from the minecraft channel before comparing versions, preventing cross-platform release mismatches and repeated download loops.
- Updated /ba quickjoin to support optional selectors: no argument joins a random arena, party joins a random party arena, and <module_id> joins a standalone arena matching that module id.

- Added options in settings.yml to disable all visibility of the game UI.
- Improved YAML error messages to provide detailed information when a file fails to load.

- Fixed placeholders module-id parsing to support IDs with underscores.
- Fixed a bug causing duplicate entries in the top rankings.

- Added a bypass for blocked commands, allowing admins and OPs to use any command during games.
- Added a custom economy option to integrate with any currency plugin via commands and PlaceholderAPI.
- Fixed economy isolation to ensure the plugin strictly uses Vault or Custom providers for all operations.
- Updated internal logging to remove unnecessary Paper console warnings and improve report clarity.

- NEW MINIGAME: Lucky Pillars (Pillars of Fortune) - Spawn on bedrock pillars, receive random items, and be the last player or team standing - https://store.blueva.net/resources/resource/28-lucky-pillars/
- NEW MICROGAME: Chairs - Music plays, seats appear, and players must sit before the timer ends. Each round removes players until only one remains - https://store.blueva.net/resources/resource/27-chairs/
- Fixed an intermittent arena shutdown hang when the Core forcibly closes a session due to low player count. Arenas now finish correctly and remove the final player instead of getting stuck.
- Fixed top-sign head refresh when the sign has a player head directly above it. The head display now updates correctly with top data changes.

- Improved anonymous error reporting to only submit reports when the plugin is up to date.
- Attempt to fix incorrect leaderboard positions in signs.

- Locked /baa arena and /baa game setup edits while an arena is enabled. Arena and game setup changes now require disabled state first.
- Added safety confirmation for /baa disable and /baa game <id> <game> disable when the arena is currently running.

- The detection of the minimum number of players in an arena has been improved. When an arena has only one player, it will stop instantly and display the final summary without relying on the module logic.
- Fixed the allowed_commands configuration option, it wasn't blocking commands. (already fixed in 3.1.4 but not mentioned in the change log)
- In settings.yml, game.global.cancel_commands.allowed_commands has been modified to add:
1. /ba
2. /barcade
3. /bluearcade
4. /arcade

- Added anonymous error reporting to Blueva.net (toggleable in settings.yml).
- Added progress logs when a module update is detected and starts downloading.
- Added api-version compatibility validation between modules and the Core.
- Fixed module store updater to replace old JAR files with the correct filenames.
- Fixed incompatible modules not displaying a clear error message when disabled.
- Improved /baa module store update and download commands to verify versions before processing.
- Updated all official modules to api-version: 3.1

- Improved /baa forcestart to reduce remaining time to 10 seconds when used during the lobby countdown.
- Fixed {game} placeholder not displaying the actual game name in configuration error messages.

- Improved module store to ensure downloads always use the Minecraft release channel.
- Improved module updates to ensure they stay on the Minecraft release channel.
- Fixed crash in /baa forcestart when entering an arena ID that does not exist.

- Optimized I/O operations to enhance data file loading and saving speeds.
- Fixed an issue where Party Mode games could end prematurely before all pending minigames were finished.

API CHANGES:
- Exposed PlayerUtil through ModuleAPI to allow checks when a GameContext is unavailable.
- PlayerUtil now supports checking whether a player is in a waiting arena.

PLUGIN:
- Fixed crash when using the plugin without NoteblockAPI
- Fixed the /baa reload command, which was not reloading some files correctly.
- /baa module store update now reloads updated modules immediately and blocks updates when the module is running or starting in any arena.

- Fixed players spawning at the same location sometimes.
- Added capture of maximum health in player session snapshots.
- Added restoration of maximum health from player session snapshots.
- Added fallback health reset on leave when restoration fails.

- Added previous location fallback for player restoration when no main lobby is configured.
- Fixed arena availability not updating live when using /baa enable and /baa disable.
- Fixed active arenas not stopping immediately when disabled.
- Fixed loss of player state (inventories, XP, effects, and movement) on leave or after a crash.

- Fixed bug allowing players to break blocks in waiting and starting lobbies.
- Fixed victory music and effects persisting when using quickjoin from finished matches.
- Fixed podium names disappearing during Party Mode "next game" announcements.
- Fixed star rankings not displaying in final summaries by clearing module overrides.

- Added new placeholders for leaderboards
- Added top leaderboard signs with optional automatic head updates.
- Introduced /baa signs set command to replace the deprecated manual sign setup.
- Deprecated old sign text configurations.

- Simplified module store search input, while keeping clearer output spacing and pagination details shown after the results.
- Ensured module store searches return results even when no query is provided.
- Fixed empty error message that appeared when using /ba quickjoin and there was no arena available.

Changes in config files: https://github.com/BluevaDevelopment/BlueArcade3-ConfigFiles/commit/86d76d1de435236dde69e304518e8033320d7a5d

- Fixed visual bug that displayed empty placeholders when placing the main lobby.

💎 BLUE ARCADE 3: THE DEFINITIVE MINIGAME SOLUTION

TL;DR – THE BIG STUFF:

🔌 Fully Modular: Every game is now a separate, independent module.
📂 Open Source: All official game modules are now Open Source on GitHub.
📱 Native Bedrock: True Bedrock menus/forms for Geyser users (no more clunky chests).
🛒 New Store & Progression: +60 Effects/Songs, Levels, Global Achievements, and Leaderboards.
🎮 New Heavyweights: Battle Royale and SkyWars added to the library.
🛠️ Developer API: 20+ Interfaces to build your own custom games.
🆕 Constant Minigames: We are releasing new modules regularly! Join our Discord to vote for the next games we should build.

📜 FULL CHANGELOG:


──────────────────────────
PART 1: GENERAL CHANGES
──────────────────────────


FULLY MODULAR ARCHITECTURE:
The Plugin is Now Modular

Blue Arcade 3 introduces a completely modular architecture. The core plugin no
longer contains any hardcoded minigames - all games are now independent modules
that load dynamically.

This means:
- Install only what you need: Just want SkyWars and TNT Run? Install only those
- Independent updates: Each module updates separately without touching the core
- Total customization: Modify any module without affecting the others
- Fewer conflicts: If a module has issues, the rest of the plugin keeps working


Open Source Modules

All official Blue Arcade modules are now open source and available on GitHub:
- See exactly how each game works
- Fork and create your own modified version
- Contribute improvements that benefit the entire community
- Learn to create your own modules by studying the existing ones


No Longer Just a Party Plugin

Blue Arcade 3 is no longer "just a party games plugin". It's now a complete
gaming platform that supports:
- Party Mode: Classic minigame rotation with multiple rounds
- Standalone Mode: Each arena can run a single game independently
- Network Mode: Full BungeeCord/Velocity integration for server networks


Full Java and Bedrock Menu Support

The plugin now has complete support for both Java Edition and Bedrock Edition
menus. Bedrock players connecting through Geyser will see native Bedrock-style
forms and menus instead of chest GUIs, providing a much better experience for
crossplay servers.


NEW CORE SYSTEMS:
Party System (Friend Groups)

New system to play with friends:
- Create private or public groups
- Invite friends to your party
- Join the same arena together automatically
- Party chat to communicate between members
- Party leader with special controls
- Command: /ba party


Store with Effects

New in-game store for visual customization with 60+ unique items:

Victory Effects (18 available):
- Fireworks (Free) - Classic fireworks burst
- Vulcan Wool - Launch colorful wool around you
- Vulcan Fire - Explode with fiery magma bursts
- Ice Walker - Freeze the ground beneath you
- Notes - Play a shower of musical notes
- Chicken Burst - Release a flock of chickens
- Warden Orbit - Summon wardens that circle you
- Daredevil Ride - Ride in style on a fearless steed
- Meteor Storm - Call down blazing meteors
- Pig Land - Let pigs rain from the sky
- Wolf Pack - Summon loyal wolves around you
- Anvil Rain - Bring down anvils from above
- Twerk Apocalypse - Spawn dancing NPCs to celebrate
- Titan - Grow to giant size
- Wither Rider - Ride a wither and shoot skulls
- Rainbow Ray - Summon a spinning rainbow ray
- Star Shower - Let sparkling stars orbit you
- Destroy Island - Summon TNT blasts without damage

Victory Music (20 songs available):
- We Are the Champions - Queen (Free)
- Happy - Pharrell Williams
- Bohemian Rhapsody - Queen
- Levels - Avicii
- Believer - Imagine Dragons
- Faded - Alan Walker
- Billie Jean - Michael Jackson
- Let It Be - The Beatles
- Never Gonna Give You Up - Rick Astley
- Africa - Toto
- Dancing Queen - ABBA
- Take On Me - a-ha
- Smells Like Teen Spirit - Nirvana
- Stairway to Heaven - Led Zeppelin
- Blinding Lights - The Weeknd
- Despacito - Luis Fonsi
- Shake It Off - Taylor Swift
- Hotel California - Eagles
- Sweet Child o' Mine - Guns N' Roses
- Get Lucky - Daft Punk

Death Effects (11 available):
- Dust Puff (Free) - A tiny puff on elimination
- Explosion - Big boom without damage
- Lightning Strike - A dramatic lightning flash
- Souls - Gentle spirits drift away
- Blood Splatter - Redstone splash particles
- Anvil Drop - A falling anvil visual
- Disintegration - Ash rising from the body
- Sculk Spores - Sculk souls burst outward
- Ghost Flame - A ring of soul fire
- Smoke Cloud - Thick smoke on death
- Ender Shatter - Portal sparks scatter

Kill Effects (11 available):
- Spark Pop (Free) - A simple spark burst
- Color Aura - A brief colorful ring
- Glow Pulse - A quick glow highlight
- Vertical Pulse - Particles rise from your feet
- Halo - A glowing halo above your head
- Confetti - Celebration sparkles
- Totem Flash - A totem burst on kill
- Heart Pop - Hearts burst with joy
- Critical Burst - A classic critical hit pop
- Note Pop - Musical notes rise up
- Star Trail - Electric sparks in a ring

Each category also includes a Random option that picks a different effect
each time.

Command: /ba store


Leaderboards and Tops

New competitive ranking system:
- Global rankings of all players
- Rankings by specific game
- Rankings by period: Lifetime, Yearly, Monthly, Weekly
- Top 10/50/100 players
- Real-time updates
- Command: /ba tops


XP and Levels System

New progression system:
- Earn XP by playing and winning matches
- Level up unlocking new titles
- Custom titles based on your level (Rookie, Expert, Master, ...)
- Visual progress bar to next level
- Additional rewards when leveling up
- Command: /ba level


Achievements System

New achievement system:
- Global achievements for general milestones (first game, 100 wins, etc.)
- Game-specific achievements for each module
- Visible progress towards each achievement
- Rewards when unlocking: credits, stars, XP
- Organized categories for easy navigation
- Notifications when you unlock something new
- Command: /ba achievements


Improved Statistics System

Much more complete statistics:
- Global stats: Games played, won, total time, etc.
- Per-game stats: Specific metrics for each module
- Detailed history of your activity
- MySQL synchronization for server networks
- Command: /ba stats



──────────────────────────
PART 2: TECHNICAL CHANGES
──────────────────────────

MODULE LOADING:
Dynamic Loading System

- Modules load from /plugins/BlueArcade/modules/ folder
- Each module is an independent JAR file
- Custom ClassLoader per module to avoid conflicts
- Automatic detection of duplicate or incompatible modules


Module Descriptor (module.yml)

Each module includes a module.yml file with:
- Module name, ID and version
- Type: MINIGAME (long matches) or MICROGAME (quick rounds)
- Required API version
- Main class
- Authors and description
- Optional dependencies


Module Auto-Update

- The plugin can check for updates automatically
- Downloads and installs new versions without manual intervention
- File integrity verification for downloads
- Configurable check interval

DEVELOPER API:
Blue Arcade 3 exposes a complete public API with 20+ specialized interfaces
for developers to create their own modules.

Core APIs:
- AchievementsAPI - Achievements system integration
- ArenaAPI - Arena data and state access
- ConfigAPI - General configuration access
- CoreConfigAPI - Core plugin configuration
- ModuleConfigAPI - Per-module configuration
- GameSetupAPI - Game setup and configuration
- SetupDataAPI - Setup data access
- SetupSelectionAPI - Setup selection handling
- StatsAPI - Statistics system
- StoreAPI - Store and shop integration
- TeamsAPI - Team management and assignment
- PlayerAPI - Player state and data

UI/Visual APIs:
- HologramAPI - Hologram creation and management
- ItemAPI - Item creation utilities
- MenuAPI - GUI menu creation (Java and Bedrock)
- MessageAPI - Localized messages
- ScoreboardAPI - Scoreboard management
- SoundsAPI - Sound playback
- TitlesAPI - Title and subtitle display
- VoteMenuAPI - Voting menu creation
- VisualEffectsAPI - Particle and visual effects

Utility APIs:
- SchedulerAPI - Task scheduling (Folia compatible)
- BlocksAPI - Block manipulation utilities

COMPATIBILITY
- Spigot 1.21 - 1.21.11
- Java 21
- Full Bedrock support via Geyser (native menus)


──────────────────────────
PART 3: MODULE CHANGELOG
──────────────────────────

MODULES PORTED FROM BLUE ARCADE 2:

Race
The classic racing minigame.
Type: Microgame
V3 Changes:
- Scoreboard now shows exactly who is winning in real-time
(Previously you had no idea who was ahead until someone finished)


Spleef
Break the floor under your opponents.
Type: Microgame
V3 Changes:
- Floor no longer needs to be square shaped
- Now supports any floor shape (circles, irregular shapes, etc.)


Snowball Fight
Snowball warfare.
Type: Microgame
V3 Changes:
- Now has two game modes:
- Last Standing: Classic elimination, last player alive wins
- Most Kills: Players respawn instantly, highest kills when time
runs out wins


All Against All
PvP combat everyone against everyone.
Type: Microgame
V3 Changes:
- Now has two game modes:
- Last Standing: Classic elimination, no respawns, last alive wins
- Most Kills: Respawn on death with temporary immunity, highest
kill count when time runs out wins
- Health regeneration on kill (configurable)
- Building enabled with periodic block supplies


One In The Chamber
Bow precision with one arrow at a time.
Type: Microgame
V3 Changes:
- Now has two game modes:
- Last Standing: Classic elimination, last player alive wins
- Most Kills: Respawn on death, highest kills when time runs out wins


Traffic Light
Advance on green, freeze on red.
Type: Microgame
V3 Changes:
- No longer instantly kills you for moving on red at the start
- Now gives warnings by pushing you backwards
- Only eliminates after multiple violations
- Much less frustrating early-game experience


TNT Tag
Pass the bomb before it explodes.
Type: Minigame
V3 Changes:
- No significant changes in this version


TNT Run
Run while the floor collapses.
Type: Minigame
V3 Changes:
- No significant changes in this version


Block Party
Find the correct color before the floor disappears.
Type: Minigame
V3 Changes:
- Powerup system (speed boost, time bonus)
- Block fragments now fall as physical objects when floor disappears
- Improved music synchronization (NBS)


Exploding Sheep
Shear sheep before they explode.
Type: Microgame
V3 Changes:
- COMPLETELY REDESIGNED GAMEPLAY
- Sheep now change color progressively: white -> red -> white -> red
- When color changes speed up and smoke appears, the sheep is about
to explode
- ALL sheep eventually explode, not just random ones
- Players must judge: stay close to shear for points, or run away
before explosion?
- Risk vs reward gameplay instead of pure randomness
- Games end much faster as the map breaks down from explosions
- Transforms from one of the most tedious games into one of the
fastest and most exciting


Run From The Beast
Escape the beast or team up to hunt it.
Type: Minigame
V3 Changes:
- No significant changes in this version


Red Alert
Survive while the floor disappears.
Type: Microgame
V3 Changes:
- Now has two game modes:
- Chaos: Random blocks disappear unpredictably
- Trail: Blocks disappear where you walk, leaving a deadly path
behind you


Minefield
Cross the minefield without exploding.
Type: Microgame
V3 Changes:
- COMPLETELY REDESIGNED GAMEPLAY
- Mines no longer kill you instantly
- Stepping on a mine now launches you high into the air
- If you land on another mine, you bounce again
- Turns into a skill-based game: navigate carefully or bounce around
- Much less frustrating than instant death from barely touching a
pressure plate
- Transforms from a tedious elimination game into a fun bouncy
challenge


Fast Zone
Extreme speed race.
Type: Microgame
V3 Changes:
- No significant changes in this version


Knockback
Combat with extreme knockback.
Type: Microgame
V3 Changes:
- Now has two game modes:
- Last Standing: Classic elimination, last player on the platform wins
- Most Kills: Respawn on death, highest knockoff count when time
runs out wins



NEW MODULES IN BLUE ARCADE 3


Battle Royale
COMPLETELY NEW - The classic battle royale comes to Blue Arcade.
Type: Minigame
Features:
- Drop from flying dragon
- Storm system with 5 progressive stages:
- Stage 1: 100% radius, no damage (40s)
- Stage 2: 70% radius, 1 damage/s (45s)
- Stage 3: 45% radius, 2 damage/s (40s)
- Stage 4: 25% radius, 3 damage/s (35s)
- Stage 5: 0% radius, 4 damage/s (20s)
- Lightning synchronized with storm
- Chest loot with configurable weights
- Team support (configurable size and count)
- Health regeneration on kill


SkyWars
COMPLETELY NEW - The popular floating islands game.
Type: Minigame
Features:
- Spawn on floating islands with glass cages
- Multiple events:
1. Chest refill
2. Final storm with gradually re
- Advanced voting system (4 categories):
- Chest loot: Basic, Normal, Overpowered
- Hearts: 10, 20, 30
- Time of day: Day, Night, Sunset, Sunrise
- Weather: Sunny, Rainy
- Fully configurable multi-tiered loot
- Granular permissions per vote option
- Automatic scheduled events
- Initial fall protection



MORE GAMES COMING SOON:
This is just the beginning! We'll be releasing many more game modules in the
coming updates. Join our Discord to participate in community votes and help
decide which games get added next:

https://discord.com/invite/CRFJ32NdcK




USEFUL LINKS

- DOCUMENTATION
Full documentation:
https://docs.blueva.net/books/blue-arcade/chapter/minecraft-spigot-edition


- FOR DEVELOPERS
Module creation guide:
https://docs.blueva.net/books/blue-arcade/page/creating-a-module

- Blue Arcade API (GitHub):
https://github.com/BluevaDevelopment/BlueArcadeAPI/tree/main

- API JavaDocs:
https://blueva.net/docs/arcade/api/

- Source code of all official modules:
https://github.com/BluevaDevelopment/BlueArcadeAPI/blob/main/EXAMPLE_PROJECTS.md

- Official module store:
https://store.blueva.net/resources/category/3-blue-arcade-modules/
1. Download official modules
2. Publish your own modules for the community
3. Browse modules directly in-game with /baa module store!

- Removed legacy setup wizard.

⚠️ End of Life notice
This update marks the end of major development for Blue Arcade v2.

From now on, only bug-fix updates will be released during 2026.
No new features or changes are planned for this version.

Development continues actively on Blue Arcade v3, which will replace v2 in the coming days.
The update will be free, but v3 is not compatible with v2 configurations, so a fresh setup will be required.

Nothing breaks today.
You can keep using v2 normally while you plan your migration.

- Added new placeholder to get the internal name of the games: {internal_game_name} (only for Scoreboards and Titles).
- Improved block-below detection in TNT Run.
- Fixed a bug where, if a player left the region while a minigame was starting, they were not teleported back.
- Fixed an issue where the death block was not detected in TNT Run and Block Party.

- Fixed a bug where missing death block settings could cause errors in minigames.

- Attempted another approach to arena player counting issues.

- Potential fix for arena player counting desync issues after long uptime

- Arena countdown system improvements to address freezing reports.
- Fixed a bug where some minigames did not display the correct title or sound when starting the game.

- Fixed bug in Minefield where players would die multiple times after stepping on a mine.
- Fixed bug in Run From The Beast where the game would end immediately at the start with incorrect winners.
- Fixed bug in Snowball Fight where the game wouldn't end when all players eliminated each other simultaneously.
- Fixed bug in the voting system where votes were ignored after the first game in an arena session.

- New minigame: TNT Run - A fast paced game where players must keep moving as blocks disappear beneath their feet. Be the last one standing!
- Extended [ICODE]{place_X}[/ICODE] and [ICODE]{stars_X}[/ICODE] placeholders from 1-3 to 1-10, now supporting top 10 positions.
- Fixed player count synchronization issues in arenas

- Fixed error when interacting with chests in RFTB
- Fixed glow effect persisting on players after RFTB ends

- Added option to disable chat muting when minigame instructions are displayed
- Fixed bug where the voting message always displayed the viewer name instead of the actual voter name
- Fixed async command dispatch error in reward system

- Replaced old setup wizard with complete command based setup system using /baa (BlueArcade Admin). Legacy setup wizard will be removed in future versions.
- Added comprehensive admin command suite. Some of the new commands include:

1. Arena management: create, delete, enable, disable, list, info
2. Arena configuration: setlobby, setname, setmode, setrounds, minplayers, maxplayers
3. Game management: add, remove, list, enable, disable
4. Game configuration: bounds, spawn, time, deathblock, finishline, floor, and game specific settings
5. Utilities: stick, pos1, pos2, clearselection, goto, teleport, reload
6. Arena control: forcestart and forcestop commands to manually start or stop arenas

- Arenas can now be easily configured as standalone or party mode via commands instead of manually editing data files.
- Added JSON caching system for data files improving performance and reducing disk I/O.

NOTES:
- The setup wizard has been marked as deprecated and will be removed in a future version.
- Arenas created with the new command system cannot be modified using the legacy setup wizard.
- These changes are necessary to achieve plugin modularity. (https://trello.com/c/k6Fp9xnG/39-make-the-plugin-completely-modular)

- Adjusted minimum player handling: lobby uses config, in-game only stops below 2 players.
- Fixed language key error that caused crashes when there weren’t enough players.

- Added configurable Quick Start system that reduces the countdown when the arena fills up.
- Improved first minigame transition: direct teleport after lobby countdown for a smoother experience.
- Fixed critical interference bug between multiple arenas. Players in different arenas will no longer receive titles, sounds, messages, or rewards from other arenas.
- Fixed constant console error when loading data files in 1.21.
- Fixed bug in OITC where you could kill yourself with the bow and gain kills.
- Fixed critical bug in TNT Tag where incorrect players were eliminated. The game now properly tracks who has the TNT at all times and between rounds.
- Fixed bug where second and third place statistics were saved incorrectly.

- Added experimental support for Folia.
- Fully reorganized the language file: player-facing messages are now separated from admin-only ones, making translations easier and more focused.
- Minigames that are not configured will no longer appear in the vote menu.
- Votes in the vote menu now update live for all players without needing to reopen it.
- Added an option to display arena status in the MOTD when using Bungee mode.
- Players in the waiting lobby who fall into the void will now be teleported back instead of falling endlessly.
- Fixed a bug in Block Party where a console error sometimes occurred at the end of the game.
- Fixed an issue in versions 1.21.6, 1.21.7, and 1.21.8 where titles and action bars would not appear.
- Fixed a bug where vote menu changes were not being updated properly.
- Fixed a bug in Exploding Sheep where block drops from the previous round remained in the arena.
- Fixed a bug in Bungee mode where the scoreboard would not reappear after leaving and rejoining an arena.
- Fixed an issue where players were unnecessarily teleported to the main lobby in Bungee mode.
- Fixed a bug with the "Spawn on Join" option that teleported players to an incorrect Y (height) coordinate.

- Fixed an issue with Block Party where depending on the size of the dance floor the blocks were not removed.

- New Minigame: Block Party - Stay on the correct color block as the floor disappears beneath you. Dance, react quickly, and be the last player standing!
- Added 7 new nbs files (in /plugins/BlueArcade/songs) (Songs for Block Party) Credits: https://github.com/nickg2/NBSsongs
- Added support for 1.21.8***
- Fixed a bug where the scoreboard did not appear correctly in Run From The Beast.

*** Although the plugin works in 1.21.8, I recommend using it in 1.21.5 or lower as the adventure-plataform-bukkit dependency has yet to be updated. The only thing that doesn't work are the titles and actionbar.

- Added support for 1.21.7
- Internal dependencies updated

- Fixed a bug where leaving the minefield border after dying would trigger another death and extend spectator time.

- Now when you die in Minefield you will be in spectator mode for a few seconds as in Traffic Light. This fixes some bugs with the minigame.

- Added support for Spigot 1.21.5/1.21.6.
- There is still some work to do with 1.21.7, but we are working on it and I will update as soon as possible.

- Fixed a bug in Traffic Light where dying would cause you to remain in spectator mode permanently.
- Fixed a bug in RFTB where votes did not appear in the voting menu.

- Added Bungee Mode (compatible with BungeeCord and Velocity), allowing the plugin to be separated into "lobby" and "game" servers.
- Added support for synchronizing statistics with MySQL.
- Statistics system reworked to fully support MySQL integration.

- The licensing system has been removed. Find out why here: https://blueva.net/post/6-saying-goodbye-to-our-licensing-system/
- Fixed bug that allowed you to advance in the RFTB configuration without configuring anything.
- Fixed error in which no message appeared when trying to advance in the configuration of incomplete minigames.

- New Minigame: Run From The Beast - Complete the parkour and prepare to take down the beast before it takes you down.
- Players with 0 stars will no longer be included in the final scoreboard summary. (Still pending for individual minigames.)
- Arena wrap-up time after final results have been sent has been reduced from 30 seconds to 5 seconds.
- Fixed a bug where players were unable to break blocks in Spleef.
- Internal code improvements and optimizations for better performance.

- Added messages informing about the license verification.
- Added some comments in the language file (no need to modify anything).
- Fixed bug that did not give rewards in arenas with only one round.

- Fixed bug that did not allow to start the plugin due to obfuscation.

- Replaced our external licensing system using BuiltByBit Ultimate API.
- Fixed bug that didn't allow to use custom language files.
- Fixed bug that wrongly calculated the final positions in Spleef when there is only one round in the arena.

- Fixed bug that could not verify licenses for new users

- Fixed bug that did not allow hitting with the sword in OITC.
- Fixed bug that did not teleport some mini-games when falling into the void.
- Fixed bug that did not allow the plugin to be used without NoteblockAPI

- Fixed bug that cancelled combat for all players on the server regardless of whether they were in an arena or not.

IMPORTANT: Blue Arcade 1.X configurations will not work in this new 2.0.0. You need to reconfigure the plugin.

- Fixed bug when disabling the plugin when the license was invalid.
- Fixed bug with the temporary license that allowed more time than indicated.
- Fixed bug that did not save user data properly.
- Fixed bug in TNT Tag that caused surrounding people to die unfairly when TNT exploded.
- Fixed bug that allowed voting for mini-games in arenas with only one minigame.
- Fixed bug that did not give stars in arenas with only one minigame.

IMPORTANT: Blue Arcade 1.X configurations will not work in this new 2.0.0. You need to reconfigure the plugin. If you use our Party Games Setup, do not upgrade until the resource is updated.

- Fixed console spam error when updating the content of the signs.
- Fixed a bug with explosions in TNT Tag that caused it to kill nearby players.
- Improvements in the Red Alert code for dead player detection.

IMPORTANT: Blue Arcade 1.X configurations will not work in this new 2.0.0. You need to reconfigure the plugin. If you use our Party Games Setup, do not upgrade until the resource is updated.

- Fixed bug that didn't register signs correctly. Delete the signs.json file if you have already registered one.
- Small corrections in the messages file.

IMPORTANT: Blue Arcade 1.X configurations will not work in this new 2.0.0. You need to reconfigure the plugin. If you use our Party Games Setup, do not upgrade until the resource is updated.

Internal reorganization:
- The plugin has changed a lot internally to improve its readability and help it update faster.
- The mini-games of the arenas are now saved in separate files, there will still be the same content, but now only what the plugin needs will be loaded instead of constantly loading everything.
- The user modifiable files are still in YAML, but the data files are now stored in JSON for faster data reading. (And there are still many changes to be made that will occur in the future)
- New content and improvements
- Updated to Minecraft 1.21
- The plugin now supports RGB colors and gradients using the Adventure MiniMessage API. However, legacy colors still work.

Changes in Multiple mode (Party Games):
-Added menu to vote for mini-games before starting an arena.
-Now the next mini-game will be announced before teleporting from the previous one.
-New sounds made with note blocks have been added when changing mini-games (Optionally using NoteblockAPI)

Most serious bugs have been fixed:
-Fixed bug in which when entering any player could fly.
-Fixed bug in which some minigames ended randomly after starting.
-Fixed bug in which sometimes the winners of each game were not counted correctly.
-Fixed bug where sometimes some region-dependent mini-games did not work.

Plugin license reverted to original:
-The plugin costs money again (explained why below). It now costs $14.99
-The licensing system removed in the previous update has been reimplemented. Old licenses do not work, contact us to receive a new one.

Why has there been so much inactivity of the plugin and why does it now cost money?

These two issues are related. We initially made the plugin free and open-source in the hope that more people would contribute to its development, as many had expressed interest in doing so. However, this did not happen. Instead, users only modified the code for their own purposes without sharing their changes with the main branch. As a result, not only did we lack contributors, but we also didn't generate any revenue, which ultimately led to a drop in motivation for the developers.

In hindsight, the decision to change the license was a mistake, but we've now reverted it to ensure we maintain motivation and continue delivering regular updates.

For those who obtained the setup while the plugin was free (before 09/28/2024), you have up to two months to claim your free Blue Arcade license. If you miss the deadline, you will need to purchase the plugin.

- SpigotMC version removed. Now the plugin is the same on all platforms.
- Removed "BlueAPI" dependency.
- Fixed bug related to Scoreboard in 1.20.4
- Fixed major bug that stopped the whole game when deleting players in TNT Tag.
- Fixed repetitive message notifying that you are tagged in TNT Tag.
- Removed obsolete methods to prevent Legacy plugin support from starting.

- New Minigame: Fast Zone
- Now if a string in the language file is missing ('') the message will not be sent.
- The Spanish language (es_ES.yml) has been updated to the latest version.
- Added support for Spigot 1.18 by user request.
- Fixed bug in which the arenas did not stop when they had less than the minimum number of users.
- Small improvements and optimizations in the code.

- New Minigame: Knockback
- Added rewards. Configure it through the rewards.yml file
- Added an option to remove the arrows fired in OITC (Default: true)
- The fire aspect of the sword in OITC has been removed.
- Added licensing system to combat piracy. (If you have purchased the resource you should have received your license as a private message on the platform where you purchased it.)

- Fixed bug when saving the blocks of an arena in Exploding Sheep.
- Fixed bug that played the "classified" sound many times in some minigames.

- Fixed bug where Red Alert did not detect when a player died.
- Fixed bug in which if a player leaves an arena and is among the top 3 classified, the fireworks would spawn anyway.
- The number of times an update is checked has been reduced to prevent spam messages in the console.

- New Minigame: Red Alert
- Added an option to spawn fireworks at the location of the winners (#1, #2 and #3).
- If there is only one round in a game the final leaderboard will be shown directly at the end of the mini-game.
- Added command "/ba reload [all/file name]" to reload the plugin configuration (some files require a complete server restart).
- Added command "/ba goto [id] [minigame]" to teleport to a configured minigame.
- Added different sounds during the arena (customizable in sounds.yml file).
- Now you can adjust the explosion level in the "Exploding Sheep" minigame. (Can't be done from inside the game, you must do it from the configuration file: /plugins/BlueArcade/data/arenas/arenaid.yml)
- Disabled the fall damage in all minigames.
- Fixed bug in OITC that didn't count as kill when killing with sword.
- Fixed bug that didn't regenerate the map in Exploding Sheep in some occasions.
- Fixed bug that regenerated the map in Spleef with players still in the minigame.
- Fixed bug that didn't show the mini-description of some minigames in the scoreboard.
- Fixed bug where in some minigames players were not teleported when leaving the borders.
- Fixed bug in which the death block did not do anything in some minigames.

- Added an explosion on death in TNT Tag
- Players in TNT Tag can now hit each other.
- Changed the OITC stick to a sword. (As in the Original OITC)
- Fixed bug that did not show the name of the TNT Tag minigame on the scoreboard when playing it.
- Fixed checks when finishing configuring Spleef.
- Added checking for updates in the SpigotMC version.

- New Minigame: TNT TAG: Players pass a TNT block between themselves, avoiding being the last one holding it when it explodes. The objective is to not be the last one holding the TNT block.
- Added an item for exiting an arena in the waiting lobby.
- Added signs for joining arenas. Format -> Line 1: [BlueArcade], Line 2: join/quickjoin, Line 3: (arenaid)
- Added the variables {max_players} and {min_players} to the Scoreboard.
- Added an option in the configuration to teleport players to the main lobby upon server entry.
- Added an Action Bar in the waiting lobby and minigames.
- The /ba join, /ba leave, and /ba quickjoin commands can now be executed from the console.
- Fixed an issue where if command blocking was disabled, the "/leave" command would not work.

- Fixed bug that generated an exception due to a null Material when regenerating the minigame Exploding Sheep.
- Fixed bug that incorrectly add victories to users.
- Fixed compatibility with Spigot 1.16.
- New checks have been added to try to solve the bug that skips minigames after choosing them without any reason. Although modifications have been implemented in the hope of solving this problem, it cannot be assured that it is completely solved in this version.

- Fixed a bug where the red light affected the spectators (again, sorry, this time it is fixed).
- Fixed a bug where death_block affected spectators.
- Fixed a bug where leaving the Exploding Sheep region as a spectator counted as a death.
- Fixed a bug where ending an arena and removing all players would display a "... has left the arena." message for each player.
- Fixed a bug where the "has left the arena" message appeared for all players when finishing an arena.
- Fixed a bug where trying to break a snow block with a snowball in spleef caused console errors.
- Fixed a bug in the /leave command in the waiting lobby.
- Fixed a bug where hitting an NPC caused console errors.
- Fixed a bug where Spleef would freeze and generate repetitive errors.
- Fixed a bug where Snowball Fight would do nothing and generate errors.
- Disabled block interaction in games and the waiting lobby.
- Fixed many other bugs...
- Now if all players leave the arena, the last player will get a victory instead of stopping the game.

- Updated the plugin to be compatible with Spigot 1.20.
- Added support for Spigot 1.16 by user request.
- Changed the scoreboard library from Netherboard to Fastboard.
- Fixed a bug that caused new minigame configuration to not register the "death_block" in the arena file.
- Fixed a bug that caused the plugin to stop completely when trying to remove player potion effects.
- Fixed a bug when starting Spleef in versions 1.12 and 1.19.
- Fixed a harmless bug in the console related to Traffic Light.

- Fixed critical error when trying to configure a new arena.

- Fixed error when trying to enter a non-existent arena.
- Fixed bug in the language files of a command (/ba quickjoin).
- Fixed bug that sometimes the player didn't change the game mode from spectator to adventure.
- Fixed bug in OITC that sometimes player didn't die despite being hit by an arrow.
- Fixed bug that teleports the spectators of Traffic Light when the light is red.
- Fixed obfuscation problem.
- Improved death block detection.
- Improved performance considerably.

- Added death block in all mini-games. When stepping on this block, the player will die. By default, it is the barrier (Important: Only if the player steps on the block, not if he touches it).
- Now potion effects will be cleared in every minigame.
- Placeholders for PlaceholderAPI added.
- Update checker added.
- Metrics added (you can disable it).
- Spanish language (es_ES) added. Credits to Iruvatar Network (www.iruvatar.com).
- Other internal changes to improve anti-piracy security...

&lt;h2 style=&quot;text-align: center;&quot; data-xf-p=&quot;1&quot;&gt;NEW: BLOCK PARTY &amp;amp; TNT RUN&lt;/h2&gt;
&lt;h2 style=&quot;text-align: center;&quot; data-xf-p=&quot;1&quot;&gt;(Image will be updated soon, see the text version for details).&lt;/h2&gt;
&lt;p data-xf-p=&quot;1&quot;&gt;&lt;img class=&quot;fr-fic fr-dii fr-draggable &quot; src=&quot;https://i.imgur.com/ilM0Tvs.png&quot; alt=&quot;&quot; width=&quot;auto&quot; height=&quot;auto&quot; /&gt;&lt;/p&gt;
&lt;p&gt;&amp;nbsp;&lt;/p&gt;
&lt;p data-xf-p=&quot;1&quot;&gt;&lt;img class=&quot;fr-fic fr-dii fr-draggable &quot; src=&quot;https://i.imgur.com/MgEYmI7.png&quot; alt=&quot;&quot; /&gt;&lt;/p&gt;