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.