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: `` 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.