Zentrix | Battle Royale Plugin 3.1

IMPORTANT: Back up your Zentrix folder before updating, and read Breaking Changes / Action Required first.

New Features

• Scenarios: 18 built-in match modifiers, such as Timber, Vein Sweep and Dragon Rush, chosen by player vote, by you, or at random.
• Custom Games: Players can schedule their own matches with [ICODE]/customgames[/ICODE], with an optional password.
• Built-in gliders: Nine gliders are included, plus an in-game editor. MatrixGliders is no longer needed.
• Victory celebrations: Winners get sounds, particles and fireworks. Players pick their celebration and glider in [ICODE]/cosmetics[/ICODE].
• Rejoin: Players who disconnect or leave can return to their match with [ICODE]/rejoin[/ICODE] while their corpse remains.
• Richer profiles: New stats, solo vs. team results and match history. You can also view other players with [ICODE]/profile <player>[/ICODE].
• More recipe types: Furnace, blast furnace, smoker, campfire and stonecutter recipes.
• Spectator items: Hide other spectators, or jump straight into another match with Play Again.
• View distance per world: Set view and simulation distance separately for each world type.
• Update notices: Staff are told on join when a new version is available.

Improvements

• Minecraft 26.1, 26.2 and 26.3: Supported on Paper and Purpur. 26.3 support is in beta.
• Admin menus: [ICODE]/zx manage[/ICODE] is now one hub, and almost every setting can be changed in-game.
• Arena setup: New Nether and End pages, Nether fallback portal placement, and per-arena scenario settings.
• Match phases: A clearer layout and new actions such as heal, refill loot, set weather or time, and run commands. Your existing file still works.
• Performance: Matches start and clean up faster and run lighter, especially when several run at once, and long-running servers use less memory.
• Spectator announcements: Spectators now also see phase titles, sounds, announcements and border warnings.
• Player Stats and coins save faster and survive crashes.
• Menus and messages: Custom icons for every button, plus multi-line, centered and optional messages.
• Placeholders: Many new scoreboard and PlaceholderAPI placeholders.
• Currency rewards: Rewards are now a simple list and can be paid silently. Your existing values are converted automatically.
• Lobby items: Lobby and spectator items can no longer be moved or dropped.
• Developer API: Many new hooks for add-ons.
• Usage statistics: Anonymous stats are sent via bStats. You can opt out in [ICODE]plugins/bStats/config.yml[/ICODE].

Fixes

• Fixed player data being lost when a data file was corrupted or several servers shared one database.
• Fixed currency rewards: lobby rewards could be farmed, rewards arriving together could be lost, and the last-team-member reward didn't pay when a teammate left.
• Fixed admin currency commands reporting success when the change didn't go through.
• Fixed the Cornucopia sometimes pasting with missing parts, not finishing on busy servers, or leaving temporary files behind.
• Fixed team matches being able to start with every player on the same team.
• Fixed a failed revival leaving the teammate unable to be revived again.
• Fixed [ICODE]/kill[/ICODE] and similar instant kills inflating damage stats, and time survived counting time spent in the lobby.
• Fixed players being stuck with an empty inventory on join when the lobby wasn't set.
• Fixed players keeping a match's health and effects after a server crash.
• Fixed the Ender Dragon boss bar and dark sky staying on screen after leaving the End.
• Fixed a brief server freeze when the Nether fallback portal was built.
• Fixed the recipe editor giving back extra copies of items when editing a recipe.
• Fixed players taking damage while caged on Cornucopia podiums.
• Fixed the last eliminated player missing the elimination and winner messages.
• Fixed mobs noticing, following or spawning around spectators.
• Fixed corpses burning or turning into Drowned.
• Fixed several class ability issues, including Warrior damage landing after a match ended.
• Fixed WorldGuard leaving a folder behind for every finished match.
• Fixed out-of-range game rule values being accepted.
• Fixed FastAsyncWorldEdit warnings filling the console after matches.
• Fixed the profile menu opening at the wrong size.

Removed

• MatrixGliders support. Its gliders and player data are imported automatically on first start.

Breaking Changes / Action Required

• Commands renamed:Run [ICODE]/zx help[/ICODE] for the full list. Common changes:
  • [ICODE]/zx setlobby[/ICODE] → [ICODE]/zx lobby set main[/ICODE] (or [ICODE]waiting[/ICODE])
  • [ICODE]/zx wand[/ICODE] → [ICODE]/zx give wand[/ICODE], and [ICODE]/zx givestar[/ICODE] → [ICODE]/zx give star[/ICODE]
  • [ICODE]/zx arena manage[/ICODE] → [ICODE]/zx arena[/ICODE], and [ICODE]/zx loot[/ICODE] → [ICODE]/zx manage[/ICODE]
  • [ICODE]/zx deathmatch settemplate[/ICODE], [ICODE]addspawn[/ICODE] and the rest → [ICODE]/zx deathmatch set …[/ICODE] and [ICODE]/zx deathmatch spawn …[/ICODE]
  • [ICODE]/zx currency take[/ICODE] → [ICODE]/zx currency remove[/ICODE]
• Permissions renamed to match: For example, [ICODE]zentrix.admin.wand[/ICODE] → [ICODE]zentrix.admin.give.wand[/ICODE] and [ICODE]zentrix.admin.currency.others[/ICODE] → [ICODE]zentrix.admin.balance.others[/ICODE]. Update your permissions plugin.
• Paper or Purpur only: Other server software and versions outside 1.21.9–26.3 won't start.
• Update your integrations: Older versions are switched off at startup. Minimums: PlaceholderAPI 2.12.3, TAB 6.1.2, WorldGuard 7.0.14, FastAsyncWorldEdit 2.15.4, Simple Voice Chat 2.6.21.
• Selection wand swapped: Left-click now sets Position 1 and right-click sets Position 2, matching WorldEdit. Position 1 is where the dragon spawns, and it flies toward Position 2. Existing arenas are unchanged.
• Solo is now free-for-all by default: Set [ICODE]arena-management.solo-teams: true[/ICODE] to keep teams of one.
• New config structure:Files are reorganized automatically on first start, with backups under [ICODE]_internal/recovery/migration/[/ICODE]. Update any scripts or notes that use the old paths.
  • [ICODE]gameplay/[/ICODE]: [ICODE]modes.yml[/ICODE] (was [ICODE]game-types.yml[/ICODE]), [ICODE]economy.yml[/ICODE] (was [ICODE]currency.yml[/ICODE]), [ICODE]phases.yml[/ICODE], [ICODE]teams.yml[/ICODE], [ICODE]broadcasts.yml[/ICODE], [ICODE]scenarios.yml[/ICODE]
  • [ICODE]content/[/ICODE]: [ICODE]classes.yml[/ICODE], [ICODE]items.yml[/ICODE], [ICODE]recipes/[/ICODE], [ICODE]loot/[/ICODE], [ICODE]cosmetics/[/ICODE] (gliders and celebrations)
  • [ICODE]_internal/[/ICODE]: player data and backups. Don't edit these files by hand.
  • [ICODE]settings.yml[/ICODE], [ICODE]guis.yml[/ICODE], [ICODE]locales/[/ICODE] and [ICODE]arenas/[/ICODE] stay where they were.
• MongoDB users: The driver downloads on first start, so offline servers need to add it to [ICODE]_internal/libraries/[/ICODE] by hand.