Support:

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

Changelogs:

Added

• Added /fakeplayer for staff to spawn a temporary packet-only player bait NPC with through-block aim detection and clickable staff alerts.
• Added automatic fakeplayer skin resolution that prefers the active SkinsRestorer skin and falls back to the player's original Mojang GameProfile skin.
• Added fakeplayer skin-layer rendering, timed despawn, gravity without fall damage, and vanilla-style damage, knockback, and hurt feedback.
• Added manual /tpa and /tpahere queue review menus for requests received while incoming request settings are disabled, including player-head entries, page navigation, direct accept, random single-request accept, and normal request expiry.
• Added RTP destination chunk warmup before the teleport starts to reduce post-teleport ping spikes and missing terrain.
• Added temporary RTP-only player chunk distance throttling after teleport, with automatic restore after the destination area has settled.
• Added duel terrain-mode arena settings for generated FLAT and VANILLA arenas, including item drop, block break/place, bucket use, hunger, weather, morning, and fall-damage controls.
• Added vanilla-style lid animation and block sound feedback when opening the custom Ender Chest from a placed ender chest.
• Added SpawnStash staff bait stashes with random /spawnstash and /stash spawning, configurable stash types, timed rollback, and creator/staff alerts.
• Added SpawnStash bait spawners backed by the managed spawner system, including optional spawner claiming when bait spawners are broken.
• Added configurable SpawnStash container contents for chest-style bait blocks.

Changed

• Crate item rewards now preserve complete custom item data, including plugin metadata, attributes, potion data, custom model data, and other item properties.
• Amethyst tools claimed from crates now start a fresh countdown using the duration saved with the reward and receive the claimant as owner with a new unique item identity.
• Fakeplayers are now removed from the player tab list after their skin profile is delivered while remaining visible in the world.
• Fakeplayer skin, tablist, physics, and hit behavior now use stable internal defaults instead of exposing implementation-specific tuning options.
• Re-enabling TPA or TPAHere request settings no longer auto-accepts queued requests; players must review or accept those queued requests from the matching queue menu.
• Inline tablist player heads now only attempt skin rendering on Minecraft/Adventure runtimes that expose supported player-head text components.
• On unsupported Paper/Spigot runtimes, tablist <head:...> tokens are omitted instead of forcing an unsupported render path.
• RTP now treats pregenerated terrain as the safe default and avoids generating new chunks unless chunk generation is explicitly enabled.
• RTP now falls back to limited chunk generation after pregenerated and loaded chunk searches fail, so non-pregenerated worlds can still find safe destinations without enabling full RTP chunk generation.
• RTP search limits are clamped to safe minimums so old low values cannot cause one-attempt failures or unlimited searches.
• RTP restores temporary player chunk distances gradually instead of sending the full view distance back in one burst.
• Config sync now cleans duplicate setup-comment blocks without changing YAML setting values.
• Managed YAML files now remove obsolete options that are no longer shipped while preserving runtime-managed crate, arena, and network entries.
• Duel item drops, block break/place, and bucket use now follow arena settings while preserving arena protection and rollback safety.
• Placed ender chest clicks now route directly into the custom Ender Chest before vanilla opens its own container state.
• SpawnStash placement now uses the staff member's body position and keeps block protection configurable instead of always protecting bait blocks.

Fixed

• Fixed crate item rewards losing custom metadata when saved, which caused Amethyst tools and other custom items to stop functioning after they were claimed.
• Fixed invalid or expired Amethyst items being accepted as crate reward templates.
• Fixed fakeplayer spawn packets causing client Network Protocol Error disconnects on newer Paper/ProtocolLib combinations.
• Fixed fakeplayers using random default Minecraft skins instead of the active SkinsRestorer or original GameProfile texture.
• Fixed fakeplayer hat, jacket, sleeve, and pants layers disappearing shortly after spawn.
• Fixed airborne fakeplayers remaining suspended, knockback snapping them back to spawn, and repeated hits leaving them floating.
• Fixed managed spawners revealed by anti-ESP sometimes showing an empty cage instead of the rotating mini mob from ENTITY_TYPE.
• Fixed repeating tablist refresh errors on Paper 1.21.8 caused by newer Adventure object-component calls being unavailable at runtime.
• Fixed RTP safe-location failures caused by old configs with very low attempt or chunk sample values.
• Fixed RTP searches ending with very low safe-location attempts, such as attempts 1/64, samples 128/128, when chunk generation was disabled.
• Fixed ungenerated chunks consuming valid-location attempts while RTP chunk generation is disabled.
• Fixed RTP config sync overriding GENERATE-CHUNKS: true back to false during reload.
• Fixed RTP safe-location checks allowing destinations without full player clearance in overworld and end worlds.
• Fixed large missing terrain holes and ping spikes immediately after RTP by preloading and refreshing the destination area in small batches.
• Fixed RTP loaded-chunk fallback choosing locations closer than the configured MIN-RADIUS, so admins can reliably push RTP farther out through rtp.yml.
• Fixed managed YAML setup comments being duplicated when older config files already had blank-separated # UDS setup: comment blocks.
• Fixed repeated setup comment blocks from accumulating above top-level config sections during automatic config sync.
• Fixed missing and updated YAML defaults being moved to the bottom instead of staying beside their bundled siblings and top-level sections.
• Fixed inline option comments not being synchronized into existing YAML files and managed comments being inserted inside multiline quoted values.
• Fixed worth.yml BLOCK-ITEMS being ignored, so blocked materials no longer show worth, sell, or appear in the worth browser even when priced.
• Fixed end crystals in active duels so placed crystals can damage valid duel opponents and self-crystal deaths resolve through normal duel win/loss handling.
• Fixed generated-world duel claim rewards so winners receive the loser claim loot without losing their own restored inventory items.
• Fixed duel opponent checks so a participant is not treated as their own opponent.
• Fixed duplicate Ender Chest close sounds when closing the custom Ender Chest opened from a placed block.
• Fixed SpawnStash break alerts so the stash creator receives them, including clickable teleport-to-player alert messages.
• Fixed SpawnStash configured container items not appearing in bait chests.

Support:

• Folia: 1.21.x - 26.x

Changelogs:

Added

• Added Folia /fakeplayer support for temporary packet-only player bait NPCs with through-block aim detection and clickable staff alerts.
• Added Folia fakeplayer skin resolution that prefers the active SkinsRestorer skin and falls back to the player's original Mojang GameProfile skin.
• Added Folia fakeplayer skin layers, timed despawn, gravity without fall damage, and vanilla-style damage, knockback, and hurt feedback.
• Added Folia manual /tpa and /tpahere queue review menus for requests received while incoming request settings are disabled, including player-head entries, page navigation, direct accept, random single-request accept, and normal request expiry.
• Added Folia RTP destination chunk warmup before the teleport starts to reduce post-teleport ping spikes and missing terrain.
• Added temporary Folia RTP-only player chunk distance throttling after teleport, with automatic restore after the destination area has settled.
• Added Folia duel arena settings for item drop, block break/place, and bucket use controls.
• Added Folia vanilla-style lid animation and block sound feedback when opening the custom Ender Chest from a placed ender chest.
• Added Folia SpawnStash staff bait stashes with random /spawnstash and /stash spawning, configurable stash types, timed rollback, and creator/staff alerts.
• Added Folia SpawnStash bait spawners backed by the managed spawner system, including optional spawner claiming when bait spawners are broken.
• Added configurable Folia SpawnStash container contents for chest-style bait blocks.

Changed

• Folia crate item rewards now preserve complete custom item data, including plugin metadata, attributes, potion data, custom model data, and other item properties.
• Amethyst tools claimed from Folia crates now start a fresh countdown using the duration saved with the reward and receive the claimant as owner with a new unique item identity.
• Folia fakeplayers are removed from the player tab list after their skin profile is delivered while remaining visible in the world.
• Folia fakeplayer skin, tablist, physics, and hit behavior now use stable internal defaults instead of exposing implementation-specific tuning options.
• Re-enabling Folia TPA or TPAHere request settings no longer auto-accepts queued requests; players must review or accept those queued requests from the matching queue menu.
• Folia tablist formatting now omits unsupported <head:...> tokens before MiniMessage parsing.
• Folia RTP now treats pregenerated terrain as the safe default and avoids generating new chunks unless chunk generation is explicitly enabled.
• Folia RTP now falls back to limited chunk generation after pregenerated and loaded chunk searches fail, so non-pregenerated worlds can still find safe destinations without enabling full RTP chunk generation.
• Folia RTP search limits are clamped to safe minimums so old low values cannot cause one-attempt failures or unlimited searches.
• Folia RTP restores temporary player chunk distances gradually instead of sending the full view distance back in one burst.
• Folia config sync now cleans duplicate setup-comment blocks without changing YAML setting values.
• Folia managed YAML files now remove obsolete options that are no longer shipped while preserving runtime-managed crate, arena, and network entries.
• Folia duel item drops, block break/place, and bucket use now follow arena settings while preserving arena modification protection.
• Folia placed ender chest clicks now route directly into the custom Ender Chest before vanilla opens its own container state.
• Folia SpawnStash placement now uses the staff member's body position and keeps block protection configurable instead of always protecting bait blocks.

Fixed

• Fixed Folia crate item rewards losing custom metadata when saved, which caused Amethyst tools and other custom items to stop functioning after they were claimed.
• Fixed invalid or expired Amethyst items being accepted as Folia crate reward templates.
• Fixed Folia fakeplayer packet handling for current ProtocolLib APIs without making ProtocolLib a hard plugin dependency.
• Fixed Folia fakeplayers falling back to random default Minecraft skins when SkinsRestorer or Mojang profile textures are available.
• Fixed Folia fakeplayer skin layers, gravity, damage feedback, and vanilla-style knockback state updates.
• Fixed Folia managed spawners revealed by anti-ESP sometimes showing an empty cage instead of the rotating mini mob from ENTITY_TYPE.
• Fixed Folia tablist formats containing <head:...> from falling through to raw or invalid text on runtimes without inline player-head text support.
• Fixed Folia RTP safe-location failures caused by old configs with very low attempt or chunk sample values.
• Fixed Folia RTP region watchdog stalls caused by blocking generated-chunk checks during random sampling.
• Fixed Folia RTP searches ending with very low safe-location attempts, such as attempts 1/64, samples 128/128, when chunk generation was disabled.
• Fixed ungenerated chunks consuming valid-location attempts while Folia RTP chunk generation is disabled.
• Fixed Folia RTP config sync overriding GENERATE-CHUNKS: true back to false during reload.
• Fixed Folia RTP safe-location checks allowing destinations without full player clearance in overworld and end worlds.
• Fixed large missing terrain holes and ping spikes immediately after Folia RTP by preloading and refreshing the destination area in small batches.
• Fixed Folia RTP loaded-chunk fallback choosing locations closer than the configured MIN-RADIUS, so admins can reliably push RTP farther out through rtp.yml.
• Fixed managed YAML setup comments being duplicated when older Folia config files already had blank-separated # UDS setup: comment blocks.
• Fixed repeated setup comment blocks from accumulating above top-level Folia config sections during automatic config sync.
• Fixed missing and updated Folia YAML defaults being moved to the bottom instead of staying beside their bundled siblings and top-level sections.
• Fixed inline option comments not being synchronized into existing Folia YAML files and managed comments being inserted inside multiline quoted values.
• Fixed Folia worth.yml BLOCK-ITEMS being ignored, so blocked materials no longer show worth, sell, or appear in the worth browser even when priced.
• Fixed end crystals in active Folia duels so placed crystals can damage valid duel opponents and self-crystal deaths resolve through normal duel win/loss handling.
• Fixed Folia duel opponent checks so a participant is not treated as their own opponent.
• Fixed duplicate Folia Ender Chest close sounds when closing the custom Ender Chest opened from a placed block.
• Fixed Folia SpawnStash break alerts so the stash creator receives them, including clickable teleport-to-player alert messages.
• Fixed Folia SpawnStash configured container items not appearing in bait chests.

Support:

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

Changelogs:

Added

• Added crash protection for item data used by Auction House, Orders, custom Ender Chest, Crates, and Duels.
• Added CRASH-PROTECTION defaults for serialized item size, display names, lore, books, persistent data keys, container depth, and nested containers.
• Added crash protection checks for written book page count, page length, total book characters, lore length, display-name length, persistent-data key count, and nested container contents.
• Added a dedicated unsafe-item rejection path for Auction House and Orders so crash protection failures are not reported as normal material-block failures.
• Added player-facing crash protection messages with context and reason placeholders so admins can see where and why an item was blocked.
• Added setup comments across bundled YAML configuration files so admins can understand each file and top-level section more easily.
• Added optional crate hologram view-distance and update-interval controls for personal key displays.
• Added Duel map selection for queue/create flows with configured arenas, random arena choice, and generated biome arena options.
• Added private Duel creation modes for invite-only and friends-only challenges.
• Added a Duel requests settings toggle so players can reject direct /duel and /create invite requests.
• Added prepared generated Duel arena handling so flat arenas are pooled/reused and vanilla arena generation is opt-in instead of happening during match-found.
• Added SELL-MENU.AUTO-SELL support to control whether the Sell GUI sells deposited items automatically.
• Added configurable Orders item selection modes: curated select menu, inventory item template, and chat search.
• Added an optional Orders select-item catalog that browses orderable materials from the running server jar with category tabs.
• Added owner order editing for active orders with no delivered progress, including item, quantity, and price changes.
• Added location-radius shard regions with SHARDS.CUBOIDS.REGIONS.<id>.LOCATION and RADIUS, while existing cuboid shard regions still take priority.
• Added automatic AFK shard region setup from /uds setup setafk, so shard countdowns and rewards can work without manual /cuboid bind ... shard true.
• Added a colorful ASCII art startup banner that displays in the server console when the plugin is enabled, showing the plugin title, version, author credit (BeestoXd), Discord link, and a donation appreciation note.
• Added /god with /godmode alias for session-only staff god mode, including /god <player> for online targets.
• Added RTP failure diagnostics that report both safe-location attempts and chunk sample usage.
• Added RTP config cleanup for existing rtp.yml files with stale search comments, unsafe legacy values, or old failure message formatting.
• Added shard admin balance commands: /addshards, /removeshards, and /setshards.

Changed

• Existing config sync now merges bundled # UDS setup: comments into server config files without replacing admin-written comments.
• CRASH-PROTECTION is now kept near core settings during config sync instead of being appended after command toggles.
• Item safety checks now use raw serialized item byte size instead of estimating size from Base64 output.
• Crash protection blocks unsafe storage actions while keeping the original item on the player, cursor, or inventory slot instead of stripping all metadata.
• Normal custom UDS items, enchantments, persistent data, and non-nested shulker/container contents remain allowed when they stay within configured limits.
• Nested containers such as shulker boxes inside shulker boxes are blocked by default, while regular single-depth shulker contents remain valid.
• Personal crate key holograms are now hidden from all players by default and only shown to their owner.
• Duel queue menu now uses centered paper/stats/selector/claims controls; the selector is hidden for flat/static-only arena modes.
• Duel queue paper lore now reflects the actual active arena mode, including static/custom map queues and flat generated arenas.
• Generated Duel worlds now keep starting player inventory intact while removing only items gained inside generated arenas from post-match carryout/claims.
• Generated Duel arenas now use smaller default borders and closer spawns so opponents are easier to find.
• Vanilla Duel biome mode no longer performs live vanilla world/chunk generation by default during queue match-found.
• Orders created from inventory items now require exact delivered item data, including shulker contents, custom names, lore, enchantments, and persistent data.
• Orders now store the actual delivered item for owner claims instead of recreating the requested template.
• Orders price edits now withdraw only the increased escrow difference or refund the lowered difference.
• Orders per-item price limit now defaults to the total budget cap so prices above 1M can be used when the total order budget allows it.
• Paper/Spigot global combat logout punishment is now opt-in by default; players who leave during global combat are no longer killed unless COMBAT-MANAGER.KILL-ON-LOGOUT is enabled.
• RTP now treats RTP worlds as pregenerated by default; new terrain is not generated unless SETTINGS.GENERATE-CHUNKS is explicitly enabled.
• RTP search limits are now finite and clamped: attempts below 32 use 32, chunk samples below 64 use 64, and intervals below 8 ticks use 8.
• RTP direct lookups used by portals and RTP zones now follow the same sample budget and tick delay as normal RTP searches.
• RTP zone searches now count against the same active RTP player limit as command/menu RTP searches.
• Packaged RTP defaults now use PLAYERS-IN-RTP: 1, MAX-ATTEMPTS: 64, MAX-CHUNK-SAMPLES: 128, ATTEMPT-INTERVAL-TICKS: 8, and GENERATE-CHUNKS: false.
• RTP search actionbars no longer show attempt/check counters such as (0/16) or (0 checks).
• /uds setup apply single-paper confirm now keeps spawn and AFK menus enabled so setup-created locations open through /spawn and /afk.
• Setup-created spawn and AFK menu areas now reuse the earliest available menu slot instead of creating unnecessary later entries.
• Sell GUI auto-processing now waits briefly for click and drag transfers to settle before selling and refreshing multiplier progress.
• When Sell GUI auto-sell is disabled, deposited items remain movable and are returned when the GUI closes instead of being sold.
• Shop price lore handling now recognizes both regular and small-caps price labels.
• God mode keeps visible and audible damage feedback, leaves damage events active for combat/tag systems, and prevents health loss from PvP, mobs, fall damage, fire/lava, suffocation, starvation, and drowning.
• God mode lets underwater air drain normally while preventing drowning health loss, and clears automatically when the player leaves the server.
• Totem purchases now allow quantity adjustment up to 36 instead of forcing one purchase at a time.
• Amount input now accepts comma/underscore separators and compact suffixes through Q; amount tab suggestions now use compact uppercase values.

Improved

• Crate key hologram updates now reuse cached key balances and skip unchanged text refreshes to reduce repeated database and entity work.
• RTP checks several random block columns inside a loaded generated chunk before marking that chunk unsafe.
• RTP failure logs now include world, radius, attempts, samples, and chunk generation state for easier pregeneration diagnosis.
• Existing valid custom RTP values are preserved during config sync; only unsafe legacy values such as 0, 1, and legacy attempt value 16 are repaired.

Fixed

• Unsafe stored items loaded from the database are skipped and logged instead of being restored into plugin storage flows.
• Unsafe items are blocked before creating or editing Auction House listings and Orders, editing crate rewards, saving custom Ender Chest contents, starting Duels, or storing Duel loot claims.
• Blocked unsafe item actions keep the item in the player's inventory or cursor instead of silently deleting it.
• Fixed unsafe items being able to enter custom Ender Chest storage through click, drag, hotbar swap, offhand swap, or shift-click paths.
• Fixed crate reward saves and reward grants accepting items whose serialized data or nested contents exceed the configured crash protection limits.
• Fixed Duel starts and Duel loot claims accepting unsafe inventory or loot items that could later be saved into plugin storage.
• Fixed personal crate key holograms scaling poorly by no longer hiding each player-owned display from every other online player.
• Fixed Duel claim menus closing from the barrier button instead of returning to the queue menu.
• Fixed flat generated Duel matches showing a biome name in match-found messaging.
• Fixed generated Duel cleanup deleting held or carried items that players already had before entering the arena.
• Fixed Duel queue lag caused by synchronous generated world or chunk creation in match-found paths.
• Fixed Orders search relevance so direct queries like wool no longer mix in unrelated fuzzy results such as wood, oak logs, or wooden tools.
• Fixed Orders search menus crashing after direct-result cleanup on modern Java immutable lists.
• Fixed legacy or corrupt Orders item data repeatedly logging Material cannot be null; bad rows now repair to a safe material fallback when possible.
• Fixed Orders config sync being skipped when bundled messages.yml had invalid indentation under ORDERS.
• Fixed /tpa and /tpahere incoming requests so players with TPA confirm menus enabled receive the clickable notification and the confirm GUI reliably opens shortly after while the request is still pending.
• Fixed Paper/Spigot combat-tagged players rejoining with zero health and dying after disconnecting during combat.
• Fixed compact money suffixes rendering as lowercase in scoreboards and economy placeholders; compact money now displays uppercase K, M, B, T, and Q while amount input remains case-insensitive.
• Fixed /uds setup setspawn and /uds setup setafk not immediately creating usable /spawn and /afk menu entries.
• Fixed setup menu locations being saved under the broken small-caps location key; old broken saves are still read and cleaned up on future setup saves.
• Fixed AFK shard countdowns and rewards not starting after /uds setup setafk.
• Fixed spawn/AFK menu delete and recreate flows jumping to #2 or #3 when an earlier slot should be reused.
• Fixed /cuboid bind and /cuboid delete flows leaving stale spawn, AFK, or shard references that could recreate deleted areas in later slots.
• Fixed several config message lookups using small-caps key names instead of the configured uppercase YAML keys.
• Fixed RTP zone world names saved with small-caps text resolving as missing worlds instead of the intended vanilla world names.
• Fixed RTP destinations, portal suggestions, and RTP zone searches failing when the configured world folder exists but the world is currently unloaded.
• Fixed RTP failing with misleading messages such as after 1 attempts when old configs had very low attempt values.
• Fixed ungenerated chunks consuming safe-location attempts while chunk generation is disabled.
• Fixed direct RTP and zone RTP searches scanning chunks as fast as futures completed, which could spike TPS and player ping.
• Fixed RTP fallback-to-loaded-chunks behavior so it only happens after the configured sample threshold and within the finite search budget.
• Fixed redundant shop price lore not being removed when the label used a regular text variant.
• Fixed god mode targets not receiving knockback from melee, sprint, Knockback, and Punch projectile hits.
• Fixed shop spawner purchases charging players without delivering the managed spawner item; failed reward delivery now refunds the purchase.

Removed

• Removed legacy unlimited RTP behavior for MAX-ATTEMPTS and MAX-CHUNK-SAMPLES values such as 0, 16, and 128.

Support:

• Folia: 1.21.x - 26.x

Changelogs:

Added

• Added setup comments across bundled YAML configuration files so admins can understand each file and top-level section more easily.
• Added optional crate hologram view-distance and update-interval controls for personal key displays.
• Added Folia support for a Duel requests opt-out state so direct Duel requests can respect player preference when the settings button is configured.
• Added SELL-MENU.AUTO-SELL support to control whether the Sell GUI sells deposited items automatically.
• Added configurable Orders item selection modes: curated select menu, inventory item template, and chat search.
• Added an optional Orders select-item catalog that browses orderable materials from the running server jar with category tabs.
• Added owner order editing for active orders with no delivered progress, including item, quantity, and price changes.
• Added location-radius shard regions with SHARDS.CUBOIDS.REGIONS.<id>.LOCATION and RADIUS, while existing cuboid shard regions still take priority.
• Added automatic AFK shard region setup from /uds setup setafk, so shard countdowns and rewards can work without manual /cuboid bind ... shard true.
• Added a colorful ASCII art startup banner that displays in the server console when the plugin is enabled, showing the plugin title, version, author credit (BeestoXd), Discord link, and a donation appreciation note.
• Added /god with /godmode alias for session-only staff god mode, including /god <player> for online targets.
• Added RTP failure diagnostics that report both safe-location attempts and chunk sample usage.
• Added RTP config cleanup for existing rtp.yml files with stale search comments, unsafe legacy values, or old failure message formatting.
• Added shard admin balance commands: /addshards, /removeshards, and /setshards.

Changed

• Existing config sync now merges bundled # UDS setup: comments into server config files without replacing admin-written comments.
• Setup comments are now managed with stable tags so future default-comment updates can merge cleanly without duplicating comment blocks.
• Folia personal crate key holograms are now hidden from all players by default and only shown to their owner.
• Folia Duel queue menu now uses centered paper/stats/claims controls, with paper handling queue join/leave.
• Orders created from inventory items now require exact delivered item data, including shulker contents, custom names, lore, enchantments, and persistent data.
• Orders now store the actual delivered item for owner claims instead of recreating the requested template.
• Orders price edits now withdraw only the increased escrow difference or refund the lowered difference.
• Orders per-item price limit now defaults to the total budget cap so prices above 1M can be used when the total order budget allows it.
• Folia RTP now treats RTP worlds as pregenerated by default; new terrain is not generated unless SETTINGS.GENERATE-CHUNKS is explicitly enabled.
• Folia RTP search limits are now finite and clamped: attempts below 32 use 32, chunk samples below 64 use 64, and intervals below 8 ticks use 8.
• Folia direct RTP lookups used by portals and RTP zones now follow the same sample budget and tick delay as normal RTP searches.
• Folia RTP zone searches now count against the same active RTP player limit as command/menu RTP searches.
• Packaged RTP defaults now use PLAYERS-IN-RTP: 1, MAX-ATTEMPTS: 64, MAX-CHUNK-SAMPLES: 128, ATTEMPT-INTERVAL-TICKS: 8, and GENERATE-CHUNKS: false.
• RTP search actionbars no longer show attempt/check counters such as (0/16) or (0 checks).
• /uds setup apply single-paper confirm now keeps spawn and AFK menus enabled so setup-created locations open through /spawn and /afk.
• Setup-created spawn and AFK menu areas now reuse the earliest available menu slot instead of creating unnecessary later entries.
• Sell GUI auto-processing now waits briefly for click and drag transfers to settle before selling and refreshing multiplier progress.
• When Sell GUI auto-sell is disabled, deposited items remain movable and are returned when the GUI closes instead of being sold.
• Shop price lore handling now recognizes both regular and small-caps price labels.
• God mode keeps damage events active for combat/tag systems while preventing health loss from PvP, mobs, fall damage, fire/lava, suffocation, starvation, and drowning.
• God mode lets underwater air drain normally while preventing drowning health loss, and clears automatically when the player leaves the server.
• Totem purchases now allow quantity adjustment up to 36 and stay on the confirmation menu after successful buys.
• Amount input now accepts comma/underscore separators and compact suffixes through Q; amount tab suggestions now use compact uppercase values.

Improved

• Folia crate key hologram updates now reuse cached key balances and skip unchanged text refreshes to reduce repeated database and entity work.
• Folia RTP checks several random block columns inside a loaded generated chunk before marking that chunk unsafe.
• Folia RTP failure logs now include world, radius, attempts, samples, and chunk generation state for easier pregeneration diagnosis.
• Existing valid custom RTP values are preserved during config sync; only unsafe legacy values such as 0, 1, and legacy attempt value 16 are repaired.

Fixed

• Config comment updates now stay organized during startup or reload instead of being appended in hard-to-read locations.
• Fixed Folia personal crate key holograms scaling poorly by no longer hiding each player-owned display from every other online player.
• Fixed Folia Duel claim menus closing from the barrier button instead of returning to the queue menu.
• Fixed Folia direct Duel requests being sent to players who have Duel requests disabled.
• Fixed Orders search relevance so direct queries like wool no longer mix in unrelated fuzzy results such as wood, oak logs, or wooden tools.
• Fixed Orders search menus crashing after direct-result cleanup on modern Java immutable lists.
• Fixed legacy or corrupt Orders item data repeatedly logging Material cannot be null; bad rows now repair to a safe material fallback when possible.
• Fixed Orders config sync being skipped when bundled messages.yml had invalid indentation under ORDERS.
• Fixed /tpa and /tpahere incoming requests so players with TPA confirm menus enabled receive the clickable notification and the confirm GUI reliably opens shortly after while the request is still pending.
• Fixed compact money suffixes rendering as lowercase in scoreboards and economy placeholders; compact money now displays uppercase K, M, B, T, and Q while amount input remains case-insensitive.
• Fixed /uds setup setspawn and /uds setup setafk not immediately creating usable /spawn and /afk menu entries.
• Fixed setup menu locations being saved under the broken small-caps location key; old broken saves are still read and cleaned up on future setup saves.
• Fixed AFK shard countdowns and rewards not starting after /uds setup setafk.
• Fixed spawn/AFK setup flows reusing later menu entries when an earlier slot should be reused.
• Fixed /cuboid bind and /cuboid delete flows leaving stale spawn, AFK, or shard references that could recreate deleted areas in later slots.
• Fixed RTP zone world names saved with small-caps text resolving as missing worlds instead of the intended vanilla world names.
• Fixed RTP destinations, portal suggestions, and RTP zone searches failing when the configured world folder exists but the world is currently unloaded.
• Fixed Folia RTP failing with misleading messages such as after 1 attempts when old configs had very low attempt values.
• Fixed ungenerated chunks consuming safe-location attempts while chunk generation is disabled.
• Fixed Folia direct RTP and zone RTP searches scanning chunks as fast as futures completed, which could spike TPS and player ping.
• Fixed one player being able to start overlapping RTP zone searches by staying inside the zone.
• Fixed RTP fallback-to-loaded-chunks behavior so it only happens after the configured sample threshold and within the finite search budget.
• Fixed Lunar teammate particles spawning for dead or invalid teammates during death and respawn ticks.
• Fixed redundant shop price lore not being removed when the label used a regular text variant.
• Fixed god mode targets not receiving knockback from melee, sprint, Knockback, and Punch projectile hits.
• Fixed Folia startup and reload crashes when saved managed spawners refresh their in-world block state during plugin enable.
• Fixed shop spawner purchases charging players without delivering the managed spawner item; failed reward delivery now refunds the purchase.
• Fixed Folia sidebar shard balances rendering as raw numbers instead of compact values such as 999.8K or 1M.

Removed

• Removed legacy unlimited RTP behavior for MAX-ATTEMPTS and MAX-CHUNK-SAMPLES values such as 0, 16, and 128.

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.

Support:

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

Changelogs:

Added

• Added a dedicated Paper/Spigot release build target, separated from the Folia build.
• Added runtime-compatible tablist skin avatar refresh for Spigot builds where inline player-head components are not supported.
• 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 for controlling spawn/AFK menu area deletion.

Changed / Improved

• Improved the Paper/Spigot build target so it uses the Spigot API build path instead of sharing the Folia build.
• Changed the plugin API declaration to Minecraft 1.21 so the jar can load across older and newer Paper/Spigot 1.21.x / 26.x builds instead of requiring API 26.1.2.
• Improved Paper/Spigot build compatibility by targeting the Spigot API 1.21-R0.1-SNAPSHOT baseline.
• Improved max-health handling so healing, duels, and FFA health restoration work across builds with different health attribute naming.
• Improved tablist name updates so older Spigot builds fall back cleanly to legacy tablist names when native Adventure components are unavailable.
• 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 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 Paper/Spigot jars failing to load on builds below API 26.1.2 with Unsupported API version 26.1.2.
• Fixed tablist skin icons not appearing on older Spigot 1.21.x builds by using the normal tablist avatar as the fallback when inline head rendering is unavailable.
• Fixed the tablist updater logging ClassNotFoundException: net.minecraft.network.chat.Component on Spigot builds that do not expose Mojang-mapped component classes.
• 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 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 Paper/Spigot API 26.1.2.
• Removed warning spam from tablist component parsing on Spigot builds that need the legacy name fallback.
• Removed the need to create spawn or AFK cuboid areas before basic /spawn and /afk teleports can work on a new server.
• Removed forced stack merging from normal worth display refreshes.
• Removed the shared universal-jar release direction for this build; Paper/Spigot and Folia are handled separately.
• Removed the (Admin) suffix from the spawn/AFK menu delete lore.

Support:

• Paper: 26.x
• Folia: 26.x
• Spigot: 26.x

Changelogs:

Added

• Added built-in portal holograms for RTP portals, using configurable TextDisplay lines from PORTAL-SYSTEM.HOLOGRAM.
• Added per-portal hologram overrides for REGION, SERVER-ID, and LINES, allowing each portal to show different colors, region labels, and player counts.
• Added /portalmanager sethologramhere <id> so staff can move a portal hologram to their current location without editing the database.
• Added tab completion for /amethysttool, including subcommands, online player targets, and available amethyst tool types.

Improved

• Updated Folia support to dev.folia:folia-api:26.1.2.build.8-stable and Java 21-25.
• Updated plugin metadata to target api-version: '26.1.2' while keeping folia-supported: true.
• Improved Folia-safe player iteration so repeated player-wide updates now enumerate globally and execute per-player work through each player's entity scheduler.
• Improved ClearLag execution for Folia by scanning removable entities around online players and removing each entity from its own entity scheduler context.
• Improved crate and portal hologram handling so TextDisplay spawning, orphan cleanup, and particle updates run through the correct region scheduler.
• Improved spawner block syncing, item drops, and generation checks with Folia region ownership guards.
• Improved staff, duel, FFA, freeze, bounty, and chat broadcasts so player-facing work is routed through Folia-safe scheduler paths.
• Portal holograms now support <total_player>, {region}, {server}, {server_id}, {server_status}, {players}, {world}, and destination placeholders.
• Local server player totals now use live Bukkit online player counts instead of depending on network status snapshots.
• Custom hologram positions are saved with portal data and restored after plugin reloads or server restarts.
• /portalmanager info <id> now shows whether the hologram location is automatic or manually positioned.
• Amethyst tool type suggestions now use command-friendly names like sell-axe and shard-booster.
• FFA exit handling now prefers safe server spawn, arena return, or world spawn locations instead of returning players to a captured location inside an FFA arena.
• Billford now uses the shared BILLFORD-MENU configuration for its title, size, trade item display, and confirm button styling.
• Billford's default 54-slot layout now places required items on the left, the hopper trade button in the center, reward preview on the right, and info/countdown controls below.
• /findplayer now reports player locations more clearly with AFK, RTP zone, spawn, dimension, and biome-aware results.
• /cuboid bind <cuboid> shard <true|false> now also manages the AFK zone binding, so shard cuboids can be used directly as AFK destinations.

Fixed

• Fixed build shading on Java 21-25 by updating maven-shade-plugin to 3.6.2.
• Fixed old Folia target artifacts being out of sync by rebuilding and refreshing
• Fixed risky Folia runtime paths that directly scanned all world entities during arena rollback, ClearLag, and hologram cleanup.
• Fixed duel and FFA arena rollback cleanup to operate from the arena region instead of a global task context.
• Fixed anti-ESP spawner visibility updates so player ray tracing and block-change packets run on the player's entity scheduler.
• Fixed TPA confirm menus on Folia so the recipient's confirmation GUI opens reliably when another player sends /tpa or /tpahere.
• Kept the existing fallback behavior: players with TPA confirm menus disabled still receive the clickable chat request message.
• Kept TPA auto-accept and disabled-request queue behavior unchanged.
• Fixed portal holograms not moving after /portalmanager sethologramhere <id> when an existing hologram entity was already active.
• Fixed local portal holograms showing 0 Players after startup or reload when using a local SERVER-ID.
• Fixed stale portal hologram TextDisplay duplicates after restart that could make the player-count line render as a block-like/emoji glyph until sethologramhere was run again.
• Fixed sethologramhere storing the hologram at the player's feet by applying a configurable vertical offset.
• Fixed FFA /leave sometimes sending the leaving player back into the same arena at a rollback evacuation height instead of fully exiting the session.
• Fixed FFA arena resets moving other waiting or preserved FFA players to vertical rollback evacuation spots when one player leaves.
• Fixed Billford input slots being capped to the top row, allowing configured trades to use the full 54-slot GUI.

Support:

• Paper: 26.x
• Folia: 26.x
• Spigot: 26.x

Changelogs:

Added

• Added built-in portal holograms for RTP portals, using configurable TextDisplay lines from PORTAL-SYSTEM.HOLOGRAM.
• Added per-portal hologram overrides for REGION, SERVER-ID, and LINES, allowing each portal to show different colors, region labels, and player counts.
• Added /portalmanager sethologramhere <id> so staff can move a portal hologram to their current location without editing the database.
• Added tab completion for /amethysttool, including subcommands, online player targets, and available amethyst tool types.

Improved

• Updated Folia support to dev.folia:folia-api:26.1.2.build.8-stable and Java 21-25.
• Updated plugin metadata to target api-version: '26.1.2' while keeping folia-supported: true.
• Improved Folia-safe player iteration so repeated player-wide updates now enumerate globally and execute per-player work through each player's entity scheduler.
• Improved ClearLag execution for Folia by scanning removable entities around online players and removing each entity from its own entity scheduler context.
• Improved crate and portal hologram handling so TextDisplay spawning, orphan cleanup, and particle updates run through the correct region scheduler.
• Improved spawner block syncing, item drops, and generation checks with Folia region ownership guards.
• Improved staff, duel, FFA, freeze, bounty, and chat broadcasts so player-facing work is routed through Folia-safe scheduler paths.
• Portal holograms now support <total_player>, {region}, {server}, {server_id}, {server_status}, {players}, {world}, and destination placeholders.
• Local server player totals now use live Bukkit online player counts instead of depending on network status snapshots.
• Custom hologram positions are saved with portal data and restored after plugin reloads or server restarts.
• /portalmanager info <id> now shows whether the hologram location is automatic or manually positioned.
• Amethyst tool type suggestions now use command-friendly names like sell-axe and shard-booster.
• FFA exit handling now prefers safe server spawn, arena return, or world spawn locations instead of returning players to a captured location inside an FFA arena.
• Billford now uses the shared BILLFORD-MENU configuration for its title, size, trade item display, and confirm button styling.
• Billford's default 54-slot layout now places required items on the left, the hopper trade button in the center, reward preview on the right, and info/countdown controls below.
• /findplayer now reports player locations more clearly with AFK, RTP zone, spawn, dimension, and biome-aware results.
• /cuboid bind <cuboid> shard <true|false> now also manages the AFK zone binding, so shard cuboids can be used directly as AFK destinations.

Fixed

• Fixed build shading on Java 21-25 by updating maven-shade-plugin to 3.6.2.
• Fixed old Folia target artifacts being out of sync by rebuilding and refreshing
• Fixed risky Folia runtime paths that directly scanned all world entities during arena rollback, ClearLag, and hologram cleanup.
• Fixed duel and FFA arena rollback cleanup to operate from the arena region instead of a global task context.
• Fixed anti-ESP spawner visibility updates so player ray tracing and block-change packets run on the player's entity scheduler.
• Fixed TPA confirm menus on Folia so the recipient's confirmation GUI opens reliably when another player sends /tpa or /tpahere.
• Kept the existing fallback behavior: players with TPA confirm menus disabled still receive the clickable chat request message.
• Kept TPA auto-accept and disabled-request queue behavior unchanged.
• Fixed portal holograms not moving after /portalmanager sethologramhere <id> when an existing hologram entity was already active.
• Fixed local portal holograms showing 0 Players after startup or reload when using a local SERVER-ID.
• Fixed stale portal hologram TextDisplay duplicates after restart that could make the player-count line render as a block-like/emoji glyph until sethologramhere was run again.
• Fixed sethologramhere storing the hologram at the player's feet by applying a configurable vertical offset.
• Fixed FFA /leave sometimes sending the leaving player back into the same arena at a rollback evacuation height instead of fully exiting the session.
• Fixed FFA arena resets moving other waiting or preserved FFA players to vertical rollback evacuation spots when one player leaves.
• Fixed Billford input slots being capped to the top row, allowing configured trades to use the full 54-slot GUI.

Support:

• Paper: 26.x
• Folia: 26.x
• Spigot: 26.x

Changelogs:

Added

• Added built-in portal holograms for RTP portals, using configurable TextDisplay lines from PORTAL-SYSTEM.HOLOGRAM.
• Added per-portal hologram overrides for REGION, SERVER-ID, and LINES, allowing each portal to show different colors, region labels, and player counts.
• Added /portalmanager sethologramhere <id> so staff can move a portal hologram to their current location without editing the database.
• Added tab completion for /amethysttool, including subcommands, online player targets, and available amethyst tool types.

Improved

• Updated Folia support to dev.folia:folia-api:26.1.2.build.8-stable and Java 21-25.
• Updated plugin metadata to target api-version: '26.1.2' while keeping folia-supported: true.
• Improved Folia-safe player iteration so repeated player-wide updates now enumerate globally and execute per-player work through each player's entity scheduler.
• Improved ClearLag execution for Folia by scanning removable entities around online players and removing each entity from its own entity scheduler context.
• Improved crate and portal hologram handling so TextDisplay spawning, orphan cleanup, and particle updates run through the correct region scheduler.
• Improved spawner block syncing, item drops, and generation checks with Folia region ownership guards.
• Improved staff, duel, FFA, freeze, bounty, and chat broadcasts so player-facing work is routed through Folia-safe scheduler paths.
• Portal holograms now support <total_player>, {region}, {server}, {server_id}, {server_status}, {players}, {world}, and destination placeholders.
• Local server player totals now use live Bukkit online player counts instead of depending on network status snapshots.
• Custom hologram positions are saved with portal data and restored after plugin reloads or server restarts.
• /portalmanager info <id> now shows whether the hologram location is automatic or manually positioned.
• Amethyst tool type suggestions now use command-friendly names like sell-axe and shard-booster.
• FFA exit handling now prefers safe server spawn, arena return, or world spawn locations instead of returning players to a captured location inside an FFA arena.
• Billford now uses the shared BILLFORD-MENU configuration for its title, size, trade item display, and confirm button styling.
• Billford's default 54-slot layout now places required items on the left, the hopper trade button in the center, reward preview on the right, and info/countdown controls below.
• /findplayer now reports player locations more clearly with AFK, RTP zone, spawn, dimension, and biome-aware results.
• /cuboid bind <cuboid> shard <true|false> now also manages the AFK zone binding, so shard cuboids can be used directly as AFK destinations.

Fixed

• Fixed build shading on Java 21-25 by updating maven-shade-plugin to 3.6.2.
• Fixed old Folia target artifacts being out of sync by rebuilding and refreshing
• Fixed risky Folia runtime paths that directly scanned all world entities during arena rollback, ClearLag, and hologram cleanup.
• Fixed duel and FFA arena rollback cleanup to operate from the arena region instead of a global task context.
• Fixed anti-ESP spawner visibility updates so player ray tracing and block-change packets run on the player's entity scheduler.
• Fixed TPA confirm menus on Folia so the recipient's confirmation GUI opens reliably when another player sends /tpa or /tpahere.
• Kept the existing fallback behavior: players with TPA confirm menus disabled still receive the clickable chat request message.
• Kept TPA auto-accept and disabled-request queue behavior unchanged.
• Fixed portal holograms not moving after /portalmanager sethologramhere <id> when an existing hologram entity was already active.
• Fixed local portal holograms showing 0 Players after startup or reload when using a local SERVER-ID.
• Fixed stale portal hologram TextDisplay duplicates after restart that could make the player-count line render as a block-like/emoji glyph until sethologramhere was run again.
• Fixed sethologramhere storing the hologram at the player's feet by applying a configurable vertical offset.
• Fixed FFA /leave sometimes sending the leaving player back into the same arena at a rollback evacuation height instead of fully exiting the session.
• Fixed FFA arena resets moving other waiting or preserved FFA players to vertical rollback evacuation spots when one player leaves.
• Fixed Billford input slots being capped to the top row, allowing configured trades to use the full 54-slot GUI.