LeafRTP | Random Teleport

Upgrade note. rtp.servers.* now defaults to true instead of op, so in network mode every player can reach open cross-server regions; restrict with negative permissions if you relied on the old default. CIRCLE and SQUARE now use new selection engines that ignore weight; use CIRCLE_DEPRECATED_PURE_SPIRAL or SQUARE_DEPRECATED_PURE_SPIRAL to keep the 3.2.1 behavior. Region shapes now default to mode: REROLL instead of ACCUMULATE; files that set mode keep their value. In config.yml, defaults.shape.uniquePlacements now defaults to "auto" (a radius matching the view distance) instead of 0, and defaults.spatialResolution to "auto" (scaled to the region's size) instead of 3; set 0 and 3 to keep the 3.2.1 values. Both jars now load on Minecraft 1.18 or newer with Java 17 or newer; the Lite jar no longer loads on 1.13 - 1.17. Folia is supported only from 1.21.11; older Folia still loads the jar but is no longer supported. Saved memory and region cache files from 3.2.1 still load, but RTP rewrites them in a new format at the next save or shutdown, and 3.2.1 can't read that format, so back up plugins/RTP/ if you may need to roll back.

Added

- Runs on Spigot and Paper 1.18 - 1.20.6, and on Java 17 ([ADR-113](https://github.com/DailyStruggle/RTP/tree/V3/docs/adr/ADR-113-java-17-baseline-and-26x-support-boundary.md)). The full jar now loads on Spigot and Paper 1.18 through 1.20.6, and Fabric 1.20.1 servers can run it on Java 17. These older versions are best-effort and are not covered by automated tests. NeoForge still needs 1.21.1 or newer, and Fabric 1.20.2 - 1.20.6 is not supported. Folia is supported from 1.21.11: it is experimental and only its current builds are maintained, so older Folia builds are not supported and can crash on their own. Bug reports are accepted for Minecraft 1.21.11 through the latest release; the per-version status is in the [support matrix](https://github.com/DailyStruggle/RTP/blob/V3/docs/dev/SUP… - Tag exclusions in `safety.yml` (ADR-017). Remove entries from a block tag instead of listing every variant by hand, e.g. #minecraft:slabs - OAK_SLAB. - Actions. Script multi-step teleports in YAML: what happens before, during and after the teleport, what to do on failure or timeout, and conditions that must pass first (permission, balance, cooldown, world, biome, time, server load and more). Destinations can be anchored to a player, a claim, a faction or a world center, and teams can be placed together. Walk-in triggers start an action when a player enters a zone. Commands: /rtp action (rtp.action; /rtp trigger and /rtp run are other names for it), /rtp action cancel (rtp.action.cancel) and /rtp back (rtp.back). The bundled action addon ships ready-made modes such as arena, KOTH, scatter and teams. - Web config editor (`/rtp editor`). Edit RTP's configs in a browser and apply the changes back to the server. Permission: rtp.editor. The region map shows the land of every loaded world, including the nether and the end, and a region's world can be picked from the worlds the server detected. Passwords, tokens and other secrets are redacted before anything leaves the server and are never overwritten by the editor. Only config files inside the plugin folder can be written, and a browser must be trusted before it can apply changes (revoke with /rtp editor untrust; optional expiry with editor.trust.maxAgeDays in advanced/network.yml). - Import from other RTP plugins (`/rtp config import`, ADR-066). Reads another random-teleport plugin's config folder, such as BetterRTP, JustRTP or EzRTP, by recognizing common config layouts, and moves over worlds, radius, shape, cooldowns, prices, database, effects and JustRTP zones. Permission: rtp.config. The old plugin doesn't need to be installed. Existing files are only replaced with overwrite=true, and are backed up first. /rtp config import permissions prints LuckPerms commands that map BetterRTP, JustRTP and EzRTP permission nodes to RTP's. - Setup wizard (`/rtp admin setup`). A guided first-time setup in chat or the console: world, gameplay, performance, preview, confirm. Your config is backed up before anything is written. Permission: rtp.admin.setup. - Teleport near your own claim or faction. Actions can pick destinations around the player's land, with Towny, GriefPrevention and SaberFactions/FactionsUUID supported through the bundled claim addon. The search center stays put through small land changes, and terrain already known to be bad is reused so new searches start fast. - Selection heatmap and pipeline views (`/rtp visualization heatmap`, `/rtp visualization pipeline`). See on the in-game map where destinations land and how the search moves through a region. Permission: rtp.menu.admin. - More claim plugins. The bundled claim addon also keeps players out of HuskTowns, PlotSquared, UltimateClaims and MinePlots land. - Minecraft 26.3 on Fabric. The Fabric jar also runs on 26.3 servers. - Holograms. Status and pre-teleport text can be shown as holograms, using built-in text displays on 1.19.4+ or DecentHolograms / HolographicDisplays. - New engines for `CIRCLE` and `SQUARE` (ADR-085, ADR-088). Picks spread evenly by area and never repeat a chunk within a pass. In mode: REROLL players are kept several chunks apart without using up the region, so expand: false regions never run out; very narrow strips of land on internal cell borders may be skipped. Bad-land memory is smaller and faster, and its saved files are up to a third smaller. weight no longer applies; the old shapes remain as *_DEPRECATED_PURE_SPIRAL. - Commands as teleport effects, and a `death` stage (effects-api-ADR-007). Run console or player commands at any teleport stage, with player and location placeholders. The new death stage runs effects when a player dies. - Claim and spacing rejections expire (ADR-079). Land rejected for a reason that can change, such as a claim or another player nearby, is retried after the time set in advanced/ttl.yml instead of being avoided forever. Bad terrain is still remembered permanently. - Units in configs and commands. Write radius: 5km, teleportCooldown: 2h30m or cacheCap: 256mb. Distance, time and size units are supported; plain numbers keep their old meaning. - World border check. RTP warns when a region reaches past the world border and keeps destinations inside it. - API on Maven Central. rtp-api, rtp-core and the API libraries they depend on, such as commands-api and effects-api, are published to Maven Central. Platform jars are not. - For addon developers. New rtp-api surfaces for actions, claim boundaries (ClaimBoundaryProvider), web editor extensions (EditorExtensionRegistry, ADR-107; tabs are built from the editor's own widgets, so no addon code runs in the browser, and no bundled addon uses them yet), and extra region-file formats (RegionFormatRegistry, ADR-077; RTP itself reads only Anvil .mca and loads other formats such as .linear asynchronously).

Changed

- RTP is now MIT-licensed in full ([ADR-108](https://github.com/DailyStruggle/RTP/tree/V3/docs/adr/ADR-108-all-mit-licensing-pro-as-support.md)). The PolyForm Noncommercial terms on non-core source (ADR-061) are withdrawn. Free and Pro jars are both MIT; Pro is a support tier and grants no extra licence. Earlier releases keep the licence they shipped with. - Location queues renamed to hot, cold and backlog (ADR-078). The L1/L2/L3 names in /rtp info and the docs now say what each queue holds. Queues always release the chunks of locations they drop. - Background search loads far fewer chunks (ADR-110). Filling the location queues first checks chunks that are already loaded or saved on disk. Only locations held ready for teleport get their surrounding view-distance area preloaded. Other sp