Support:

• Folia: 1.21.x - 26.x

Changelogs:

Added

• Added COMBAT-MANAGER.KILL-ON-LOGOUT to control whether global combat logout kills players.
• Added contextual tab suggestions across registered Folia commands.
• Added data-aware suggestions for command arguments such as players, homes, warps, RTP destinations, crates, spawners, duel/FFA arenas, portals, cuboids, worlds, amounts, durations, toggles, and feature keys.
• Added /crate bind support for uncolored and colored Shulker Boxes.
• Added global display-level currency customization for both money and shards through the CURRENCY config section.
• Added configurable currency names, plural names, symbols, symbol colors, amount colors, decimal places, and normal/compact display formats.
• Added formatted PlaceholderAPI placeholders for money and shards names, symbols, colors, and full formatted values while keeping the existing numeric placeholders compatible.
• Added scoreboard icon placeholders and icon-column alignment controls for cleaner sidebar currency/stat rows.
• Added worth display inside open Shulker Box inventories, following each player's Worth Display setting.
• Added configurable compact currency suffixes, compact decimal precision, and number separators for money and shards.
• Added separate tablist media badge permissions for media-only, plus-only, and combined media badge access.

Changed / Improved

• Command tab suggestions now respect command permissions and disabled feature groups before showing options.
• Commands with free-text arguments now stop suggesting values after the structured arguments are complete.
• Crate and Amethyst tool admin commands now suggest their remaining structured arguments more completely.
• Global combat logout punishment is enabled by default while still leaving Duel, FFA, and excluded-world quit handling to their own systems.
• Existing CRATES.* entries in crates.yml are now treated as server-managed crate content after first install.
• Startup and reload configuration sync no longer restores bundled example crate definitions or rewards into customized crate configs.
• Crate catalog syncing now leaves custom crate IDs, reward IDs, and deleted default rewards untouched in existing crates.yml files.
• Player-facing money and shard displays now use configured currency formatting across balances, payments, admin money commands, shard commands, stats, profiles, leaderboards, scoreboards, shops, purchase confirmations, Billford, crates, bounty messages, auction house, orders, worth displays, sell feedback, hover stats, Lunar rich presence, and Amethyst sell feedback.
• Vault economy formatting and currency names now follow the configured main money currency.
• Bundled default configs now use currency placeholders instead of hardcoded $, Money, Dollars, Shards, or fixed shard colors.
• Shop and crate reward displays now show configured currency formatting instead of fixed money or shard text.
• The default scoreboard icon column width is now 10 for tighter symbol-to-text spacing.
• Shop purchase confirmations now stay open after a successful buy so players can keep buying the same item until they close or cancel the menu.
• Shop purchases now refresh worth display immediately after delivered items are added to the player's inventory.
• Open Shulker Box inventories now clean temporary worth display lore when closed or when creative mode clears worth displays.
• Formatted money and shard displays now use compact values by default, such as 100k and 1,5m, while compact formatting can be disabled to show full grouped values such as 100.000.
• Economy command placeholders now keep compact lowercase output for player-facing amounts while full grouped values remain available through explicit full placeholders.
• New players now get all five personal home slots on the first /homes page by default, instead of starting with only two usable slots.
• Player-facing defaults now use the small-caps visual style consistently across messages, menus, titles, lore, action bars, broadcasts, death messages, staff/freeze/invsee text, auction house, orders, duels, FFA, crates, spawners, Billford, Amethyst tools, and command descriptions.
• Fallback text shown when a config value is missing now follows the same small-caps style for generated labels such as crates, keys, spawners, items, arenas, leaderboard types, server/rules buttons, PlaceholderAPI status text, and no-data values.
• Tablist media badges now allow media icon and plus badge grants to be shown separately or together through permissions.

Fixed

• Fixed feature-disabled commands still being able to expose tab suggestions through existing completers.
• Fixed missing tab suggestions for /crate key, /crate take, /crate set, /crate keyall, crate reward slots, and Amethyst tool durations.
• Fixed players being able to log out during the global combat timer without dying.
• Fixed deleted or replaced default crate rewards being added back to edited crates after restart or /uds reload.
• Fixed custom crate reward layouts being mixed with old bundled rewards when admins removed default entries and added their own items.
• Fixed scoreboard sidebar rows looking uneven when icons had different visible widths or color-code lengths.
• Fixed shard and money labels remaining hardcoded in several fresh default menus, messages, hover text, and reward displays after currency names were customized.
• Fixed formatted currency output missing from PlaceholderAPI, Vault formatting, shop purchase messages, and reward-related messages that players see.
• Fixed shop purchase success sounds not playing when the configured sound used Bukkit enum-style names.
• Fixed newly purchased shop items not stacking with matching inventory items that already had worth display lore until the player moved an item slot.
• Fixed shop purchases compacting intentionally split stacks while refreshing worth display, such as split Golden Apples merging back together after buying more.
• Fixed open Shulker Box contents not showing worth display while regular player inventory items already did.
• Fixed sell, worth, hover stats, Lunar rich presence, Amethyst sell feedback, and shop validation displays bypassing the configured currency formatter in some money output.
• Fixed remaining normal-case fallback words such as None, Inactive, Console, Amethyst Tool, Crate, Key, Spawner, and Item appearing in player-facing output after the visual text update.
• Fixed display-only text updates so parsed values stay compatible, including YAML booleans, hex colors, placeholders, command paths, permission nodes, material IDs, database fields, and the literal currency token.
• Fixed the Folia build failing after feature toggle systems were added but not fully initialized for the Folia runtime.
• Fixed /money, /balance, /addmoney, /removemoney, /setmoney, and /pay still showing grouped full money values where compact output was expected.
• Fixed small-caps player-facing permission nodes not matching normal ASCII LuckPerms grants such as rank.media.
• Fixed tablist media badge and rank-related display state not refreshing immediately after LuckPerms user data changed.

Support:

• Paper: 1.21.x - 26.x
• Spigot: 1.21.x - 26.x

Changelogs:

Added

• Added COMBAT-MANAGER.KILL-ON-LOGOUT to control whether global combat logout kills players.
• Added contextual tab suggestions across registered Paper/Spigot commands.
• Added data-aware suggestions for command arguments such as players, homes, warps, RTP destinations, crates, spawners, duel/FFA arenas, portals, cuboids, worlds, amounts, durations, toggles, and feature keys.
• Added /crate bind support for uncolored and colored Shulker Boxes.
• Added global display-level currency customization for both money and shards through the CURRENCY config section.
• Added configurable currency names, plural names, symbols, symbol colors, amount colors, decimal places, and normal/compact display formats.
• Added formatted PlaceholderAPI placeholders for money and shards names, symbols, colors, and full formatted values while keeping the existing numeric placeholders compatible.
• Added scoreboard icon placeholders and icon-column alignment controls for cleaner sidebar currency/stat rows.
• Added worth display inside open Shulker Box inventories, following each player's Worth Display setting.
• Added configurable compact currency suffixes, compact decimal precision, and number separators for money and shards.
• Added separate tablist media badge permissions for media-only, plus-only, and combined media badge access.

Changed / Improved

• Command tab suggestions now respect command permissions and disabled feature groups before showing options.
• Commands with free-text arguments now stop suggesting values after the structured arguments are complete.
• Crate and Amethyst tool admin commands now suggest their remaining structured arguments more completely.
• Global combat logout punishment is enabled by default while still leaving Duel, FFA, and excluded-world quit handling to their own systems.
• Existing CRATES.* entries in crates.yml are now treated as server-managed crate content after first install.
• Startup and reload configuration sync no longer restores bundled example crate definitions or rewards into customized crate configs.
• Crate catalog syncing now leaves custom crate IDs, reward IDs, and deleted default rewards untouched in existing crates.yml files.
• Player-facing money and shard displays now use configured currency formatting across balances, payments, admin money commands, shard commands, stats, profiles, leaderboards, scoreboards, shops, purchase confirmations, Billford, crates, bounty messages, auction house, orders, worth displays, sell feedback, hover stats, Lunar rich presence, and Amethyst sell feedback.
• Vault economy formatting and currency names now follow the configured main money currency.
• Bundled default configs now use currency placeholders instead of hardcoded $, Money, Dollars, Shards, or fixed shard colors.
• Shop and crate reward displays now show configured currency formatting instead of fixed money or shard text.
• The default scoreboard icon column width is now 10 for tighter symbol-to-text spacing.
• Shop purchase confirmations now stay open after a successful buy so players can keep buying the same item until they close or cancel the menu.
• Shop purchases now refresh worth display immediately after delivered items are added to the player's inventory.
• Open Shulker Box inventories now clean temporary worth display lore when closed or when creative mode clears worth displays.
• Formatted money and shard displays now use compact values by default, such as 100k and 1,5m, while compact formatting can be disabled to show full grouped values such as 100.000.
• Economy command placeholders now keep compact lowercase output for player-facing amounts while full grouped values remain available through explicit full placeholders.
• New players now get all five personal home slots on the first /homes page by default, instead of starting with only two usable slots.
• Player-facing defaults now use the small-caps visual style consistently across messages, menus, titles, lore, action bars, broadcasts, death messages, staff/freeze/invsee text, auction house, orders, duels, FFA, crates, spawners, Billford, Amethyst tools, and command descriptions.
• Fallback text shown when a config value is missing now follows the same small-caps style for generated labels such as crates, keys, spawners, items, arenas, leaderboard types, server/rules buttons, PlaceholderAPI status text, and no-data values.
• Tablist media badges now allow media icon and plus badge grants to be shown separately or together through permissions.

Fixed

• Fixed the Paper/Spigot plugin failing to load after the command tab suggestion update.
• Fixed feature-disabled commands still being able to expose tab suggestions through existing completers.
• Fixed missing tab suggestions for /crate key, /crate take, /crate set, /crate keyall, crate reward slots, and Amethyst tool durations.
• Fixed players being able to log out during the global combat timer without dying.
• Fixed deleted or replaced default crate rewards being added back to edited crates after restart or /uds reload.
• Fixed custom crate reward layouts being mixed with old bundled rewards when admins removed default entries and added their own items.
• Fixed scoreboard sidebar rows looking uneven when icons had different visible widths or color-code lengths.
• Fixed shard and money labels remaining hardcoded in several fresh default menus, messages, hover text, and reward displays after currency names were customized.
• Fixed formatted currency output missing from PlaceholderAPI, Vault formatting, shop purchase messages, and reward-related messages that players see.
• Fixed shop purchase success sounds not playing when the configured sound used Bukkit enum-style names.
• Fixed newly purchased shop items not stacking with matching inventory items that already had worth display lore until the player moved an item slot.
• Fixed shop purchases compacting intentionally split stacks while refreshing worth display, such as split Golden Apples merging back together after buying more.
• Fixed open Shulker Box contents not showing worth display while regular player inventory items already did.
• Fixed sell, worth, hover stats, Lunar rich presence, Amethyst sell feedback, and shop validation displays bypassing the configured currency formatter in some money output.
• Fixed remaining normal-case fallback words such as None, Inactive, Console, Amethyst Tool, Crate, Key, Spawner, and Item appearing in player-facing output after the visual text update.
• Fixed display-only text updates so parsed values stay compatible, including YAML booleans, hex colors, placeholders, command paths, permission nodes, material IDs, database fields, and the literal currency token.
• Fixed /money, /balance, /addmoney, /removemoney, /setmoney, and /pay still showing grouped full money values where compact output was expected.
• Fixed small-caps player-facing permission nodes not matching normal ASCII LuckPerms grants such as rank.media.
• Fixed tablist media badge and rank-related display state not refreshing immediately after LuckPerms user data changed.

Support:

• Folia: 1.21.x - 26.x

Changelogs:

Added

• Added an admin feature toggle system through /uds features.
• Added in-game feature toggle GUI with paginated feature items, enabled/disabled status, and click-to-toggle behavior.
• Added console/admin subcommands:
  • /uds features list
  • /uds features toggle <feature>
  • /uds features enable <feature>
  • /uds features disable <feature>
• Added persistent FEATURES.<FEATURE_KEY>.ENABLED settings in config.yml.
• Added FEATURE-TOGGLE-MENU defaults in menus.yml.
• Added user-facing feature toggle messages in messages.yml.
• Added ultimatedonutsmp.admin.features permission.
• Added automatic bundled YAML configuration syncing on server startup/restart and /uds reload.
• Added smart-merge behavior so new default configuration paths are added without requiring existing .yml files to be deleted.
• Added automatic configuration backups under config-backups/<timestamp>/ before synced files are changed.
• Added internal bundled-default snapshots under .default-configs/ so future builds can update untouched default values safely.
• Added a startup guard that logs an error and disables UltimateDonutSmp when PlaceholderAPI is missing or disabled, preventing unresolved sidebar placeholders.

Changed / Improved

• Disabled features now block their related commands at execution time instead of requiring command removal from plugin.yml.
• /uds reload and /uds features remain available even when other feature groups are disabled.
• Existing COMMANDS.<KEY> values remain backward-compatible when a matching FEATURES value is not present.
• Command help/setup command listings now hide commands whose feature group is disabled.
• Scoreboard and tablist toggles apply live to online players by hiding/restoring sidebar data and clearing/restoring tablist formatting.
• Shards toggle now stops shard commands, passive shard rewards, kill shard rewards, and shard cuboid rewards.
• Homes, RTP, RTP zone, crates, shop/sell/worth, auction house, orders, duels, FFA, staff mode, freeze, invsee, network servers, spawners, portals, Lunar integrations, optimization, combat, fast crystals, and key-all now respect the central feature state.
• Crate visuals/listeners and spawner generation/listeners now stop behavior while their feature is disabled.
• Folia runtime behavior uses the Folia-safe scheduler path while applying live feature state changes to online players.
• Existing admin/server custom configuration values are now preserved when bundled defaults are refreshed.
• /uds reload now applies bundled configuration updates before plugin systems reload their settings.
• Default YAML updates are now delivered through the Folia plugin build instead of relying on manual file deletion.

Fixed

• Fixed disabled command groups not fully stopping background or passive systems.
• Fixed scoreboard/tablist displays lingering for online players after the related feature is disabled.
• Fixed RTP zone countdown behavior continuing when RTP or RTP zone is toggled off.
• Fixed shard passive rewards and cuboid rewards continuing even when shard access is disabled.
• Fixed crate and spawner runtime behavior remaining active after their command access was disabled.
• Fixed Folia feature-state cleanup paths that need entity/global scheduling instead of direct synchronous player mutation.
• Fixed updated bundled YAML defaults not reaching existing plugin folders unless the old .yml file was manually removed.
• Fixed invalid YAML recovery keeping the plugin stuck on a broken file; broken configs are backed up and restored from bundled defaults.

Support:

• Paper: 1.21.x - 26.x
• Spigot: 1.21.x - 26.x

Changelogs:

Added

• Added an admin feature toggle system through /uds features.
• Added in-game feature toggle GUI with paginated feature items, enabled/disabled status, and click-to-toggle behavior.
• Added console/admin subcommands:
  • /uds features list
  • /uds features toggle <feature>
  • /uds features enable <feature>
  • /uds features disable <feature>
• Added persistent FEATURES.<FEATURE_KEY>.ENABLED settings in config.yml.
• Added FEATURE-TOGGLE-MENU defaults in menus.yml.
• Added user-facing feature toggle messages in messages.yml.
• Added ultimatedonutsmp.admin.features permission.
• Added automatic bundled YAML configuration syncing on server startup/restart and /uds reload.
• Added smart-merge behavior so new default configuration paths are added without requiring existing .yml files to be deleted.
• Added automatic configuration backups under config-backups/<timestamp>/ before synced files are changed.
• Added internal bundled-default snapshots under .default-configs/ so future builds can update untouched default values safely.
• Added a startup guard that logs an error and disables UltimateDonutSmp when PlaceholderAPI is missing or disabled, preventing unresolved sidebar placeholders.

Changed / Improved

• Disabled features now block their related commands at execution time instead of requiring command removal from plugin.yml.
• /uds reload and /uds features remain available even when other feature groups are disabled.
• Existing COMMANDS.<KEY> values remain backward-compatible when a matching FEATURES value is not present.
• Command help/setup command listings now hide commands whose feature group is disabled.
• Scoreboard and tablist toggles apply live to online players by hiding/restoring sidebar data and clearing/restoring tablist formatting.
• Shards toggle now stops shard commands, passive shard rewards, kill shard rewards, and shard cuboid rewards.
• Homes, RTP, RTP zone, crates, shop/sell/worth, auction house, orders, duels, FFA, staff mode, freeze, invsee, network servers, spawners, portals, Lunar integrations, optimization, combat, fast crystals, and key-all now respect the central feature state.
• Crate visuals/listeners and spawner generation/listeners now stop behavior while their feature is disabled.
• Existing admin/server custom configuration values are now preserved when bundled defaults are refreshed.
• /uds reload now applies bundled configuration updates before plugin systems reload their settings.
• Default YAML updates are now delivered through the plugin build instead of relying on manual file deletion.

Fixed

• Fixed disabled command groups not fully stopping background or passive systems.
• Fixed scoreboard/tablist displays lingering for online players after the related feature is disabled.
• Fixed RTP zone countdown behavior continuing when RTP or RTP zone is toggled off.
• Fixed shard passive rewards and cuboid rewards continuing even when shard access is disabled.
• Fixed crate and spawner runtime behavior remaining active after their command access was disabled.
• Fixed updated bundled YAML defaults not reaching existing plugin folders unless the old .yml file was manually removed.
• Fixed invalid YAML recovery keeping the plugin stuck on a broken file; broken configs are backed up and restored from bundled defaults.

Support:

• Folia: 1.21.x - 26.x

Changelogs:

Added

• Added a dedicated Folia release build target with Folia-specific jar naming.
• Added /uds setup for first-time server setup, including setup status, single-server preset application, spawn/AFK location setup, and command usage browsing.
• Added /uds setup apply single-paper confirm to apply a safe standalone preset with SQLite data/data.db, Redis disabled, local network identity, Discord webhooks disabled, Lunar Rich Presence disabled, and spawn/AFK area menus disabled until valid areas are created.
• Added /uds setup setspawn and /uds setup setafk to save fallback spawn and AFK teleport locations from the player's current position.
• Added /uds setup commands [all|starter|economy|market|pvp|staff|admin|setup] [page] to browse command usage metadata from the plugin command registry.
• Added tab completion for /uds reload, /uds statswipe, /uds optimize, and /uds setup.
• Added the ultimatedonutsmp.admin.setup permission for setup commands.
• Added an admin-only right-click action to remove configured spawn/AFK menu areas directly from the teleport area menu.
• Added the ultimatedonutsmp.admin.teleportareas.delete permission to the Folia resource plugin.yml.

Changed / Improved

• Improved Folia packaging so the Folia jar is built and named separately from the Paper/Spigot jar.
• Changed the plugin API declaration to Minecraft 1.21 so the Folia jar can load across older and newer compatible 1.21.x / 26.x builds instead of requiring API 26.1.2.
• Improved the Folia build target to compile against folia-api 1.21.11-R0.1-SNAPSHOT.
• Improved max-health handling so healing, duels, and FFA health restoration work across builds with different health attribute naming.
• Improved login validation compatibility by using the stable async pre-login path instead of newer connection-only login events.
• Improved death-screen message handling so builds without the newer override API can still process player deaths.
• Improved /spawn and /afk so they only open area menus when menu mode is enabled and at least one valid area exists; otherwise they fall back to the saved setup locations.
• Improved setup status feedback with runtime, storage, Redis, Discord webhook, spawn, AFK, RTP world, and optional integration checks.
• Improved sidebar scoreboard compatibility by using a Folia-safe rendering path instead of Bukkit scoreboard creation.
• Improved RTP search and safe-location checks so they run through Folia region scheduling.
• Improved worth display refresh so it no longer force-merges inventory stacks.
• Improved pickup stacking by temporarily clearing worth display metadata before Minecraft handles item pickup, then refreshing worth lore afterward.
• Improved /uds setup setspawn and /uds setup setafk so repeated runs fill the next available spawn/AFK menu slot instead of replacing the first slot.
• Improved setup-created spawn/AFK areas so, when all configured area slots are already used, a new menu area is created in the next free menu slot.
• Improved setup success feedback so it reports which area and menu slot were saved.
• Improved spawn/AFK menu counters for location-only areas: {players} now counts online players within 16 blocks of the saved location when no cuboid exists.
• Improved unset spawn/AFK menus so they show one centered barrier instead of multiple unset placeholders.
• Improved the random spawn/AFK button so it only appears when more than one valid teleport area exists.
• Changed the admin delete hint from Right-click to delete (Admin) to Right-click to delete.

Fixed

• Fixed Folia jars failing to load on builds below API 26.1.2 with Unsupported API version 26.1.2.
• Fixed Folia shutdown errors where the plugin attempted to schedule tasks while already disabled.
• Fixed blacklist and ban login checks failing to load on Folia builds that do not expose the newer connection validation event.
• Fixed death handling compatibility on Folia builds that do not expose the newer death-screen message override method.
• Fixed first-run /spawn and /afk opening empty area menus when menu mode existed but usable cuboid areas had not been created yet.
• Fixed /uds usage metadata so setup is included in the admin command entry point.
• Fixed sidebar scoreboard display issues on Folia servers.
• Fixed Folia scoreboard warnings caused by unsupported Bukkit scoreboard creation.
• Fixed /rtp thread check errors during random teleport searches.
• Fixed RTP safe-location checks running outside the correct Folia region context.
• Fixed split stacks snapping back together after worth display refresh, such as 10 sand split into 5/5.
• Fixed manually recombined stacks not accepting newly mined or picked-up matching blocks.
• Fixed worth display metadata blocking vanilla item stacking during pickup.
• Fixed /uds setup setspawn and /uds setup setafk only updating slot 0 instead of creating or filling additional slots.
• Fixed setup location saves only updating fallback config while the spawn/AFK menu still treated the area as unset.
• Fixed the spawn/AFK menu showing configured but unset locations as usable teleport entries.
• Fixed the admin delete click being reversed; left-click now teleports and right-click deletes.
• Fixed location-only spawn/AFK slots showing 0/200 forever when players were standing near the saved location.

Removed

• Removed the hard runtime requirement for Folia API 26.1.2.
• Removed shutdown-time task registration from AntiESP cleanup when the plugin is already disabled.
• Removed the need to create spawn or AFK cuboid areas before basic /spawn and /afk teleports can work on a new server.
• Removed the shared universal-jar release direction for this build; Folia and Paper/Spigot are handled separately.
• Removed Folia sidebar dependency on Bukkit's scoreboard manager.
• Removed unsafe RTP lookup behavior that could break Folia region rules.
• Removed forced stack merging from normal worth display refreshes.
• Removed the (Admin) suffix from the spawn/AFK menu delete lore.