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.