RTP 3.2.0

Big change: RTP now comes with a menu built in. Type /rtp and you get a clickable picker instead of instant teleport. Don't like it? Delete addons/LeafRTPGuiAddon.jar to go back to instant. (The menu has an instant option too, and it falls back to instant when no menu is available.)

New

• Countdowns now show as a boss bar instead of spamming chat.
• /rtp now sends you to open-sky spots by default - no more spawning in caves.
• Now ships the full safety config (more block options out of the box).
• The plugin quietly learns biomes from chunks players load, for better results.

Fixed

• requireSkyLight no longer drops players in caves.
• The /rtp menu now opens on Fabric and NeoForge too.
• Low-memory servers no longer get stuck pausing forever - RTP now frees memory.
• Per-world setups now actually work.
• Lots of Fabric and NeoForge 1.26 fixes: no more crashes on teleport effects, chunks generate properly, and the server no longer freezes loading them.

Full changelog

the server backends for fabric and neoforge were left off for no reason. Fixed

LeafRTP 3.1.3

MiniMessage color/gradient support everywhere (even on plain Spigot), six new claim integrations, a world picker in the menu, and a heap-pressure safety brake.

Added

• MiniMessage markup anywhere color codes work - named/hex colors, gradients, decorations. Gradients now render even on pure Spigot (no Adventure). Chat, titles, action bar, console, Fabric & NeoForge all honor it.
• Six new claim integrations: SaberFactions, FactionsBridge, Residence, CrashClaim, HuskClaims, KingdomsX - now twelve bundled.
• World picker row in the /rtp menu.
• Drop-in plugins/RTP/addons/ folder for addon jars (no plugin.yml needed).

Fixed

• WorldGuard protection now actually enforced - a flag-logic inversion let RTP land players inside protected regions.
• Gradients mixed with legacy/hex codes no longer break.
• A throwing claim/region verifier now fails safe (rejects instead of silently accepting).
• /rtp region:<r> world:<w> now teleports into that world, with a dimension-correct vert for nether/end.
• Heap-pressure backoff - background cache fill pauses over maxHeapPercent (default 85), preventing small-heap GC-thrash hangs.

Changed

• MC 26.2 Fabric adapter re-pinned to the 26.2 final release.
• Bundled claim deps refreshed; dropped the unmaintained legacy Factions (1.6.9.x) and pre-2.x HuskTowns integrations.

100% free, MIT-licensed. Also on Modrinth.

This release fixes the last blockers for Folia and cross-server networking in the free build. Folia support required adjusting a handful of scheduler call sites so work lands on the correct region thread; networking required a new proxy-direct transport that uses the proxy itself as the shared store, so the average server owner doesn't need to set up Redis or SQL to get cross-server /rtp.

Added

• Basic Folia support. The lite build now runs on Folia: folia-supported: true is set in plugin.yml, a new FoliaAwareScheduler routes work through Paper API's regionized and per-entity schedulers, and teleports go through Entity#teleportAsync. The throughput-optimized rtp-folia adapter remains Pro-only.

• Cross-server /rtp on the DB-free proxy-direct tier, as a drop-in alternative to Redis/SQL. A cross-server /rtp <server>:<region> issued on a lobby now moves the player and runs /rtp on the destination backend with no Redis/SQL required. proxy-direct uses the proxy's own in-memory transport as the shared store, reached over an outbound TCP connection via a thin RPC, HMAC-signed when RTP_NET_SECRET is set.

• proxy-direct network transport: player-independent cross-server region discovery. transport.type: proxy-direct lets a backend publish its real region list at startup with no player online, so cross-server tab-completion converges with zero players on any backend. No Redis/SQL required.

• Per-server /rtp permission gate for networked backends. Cross-server /rtp <server>:<region> is now gated by rtp.servers.<server> in addition to rtp.regions.<region>, so operators can allow/deny teleport per backend. rtp.servers.* defaults to op and is a child of rtp.*.

• /rtp info biomes biome-occupancy leaderboard. Reports which biomes online players actually spend their time in, ranked by share - useful for gauging where players congregate. Counts are in-memory only and reset on restart/reload. Gated by the existing rtp.info permission.

• spark profiler is now an optional source for /rtp info TPS/MSPT metrics. When spark is installed, RTP merges spark's richer per-window TPS (1m/5m/15m) and mean MSPT over the native binding. Pure soft-dependency via reflection; no compile dependency added.

• performance.yml#biomeWeights ships the full vanilla biome set pre-listed at weight 1.0. Every vanilla overworld/nether/end biome is now enumerated as a ready-to-edit reference. Behaviour is unchanged: an all-1.0 map is identical to the prior default.

• Biome-probability weighting (ADR-062). New performance.yml knobs biomeWeighted (default false) and biomeWeights (biome id -> relative weight) let operators bias or suppress specific biomes in the teleport draw. When enabled, the location selector draws a target biome proportionally to its configured weight, then explores via the bounded spiral until that biome is confirmed.

• Registry-aware gray-space steering for biome weighting. A requested biome the world can produce but that recall memory has not yet recorded stays reachable via bounded-spiral exploration rather than being treated as weight 0. Each recorded biome defers a run-count-proportional share of its weight to exploration, so a high weight on a thinly-recorded biome can never amplify single-run clustering.

• /rtp version (alias /rtp about) subcommand. Reports the running plugin version, platform brand, and host server version. Gated by a new rtp.version permission (default true, child of rtp.*).

Fixed

• Map charts and metrics work correctly on Folia (new in this release alongside Folia support). Map chart delivery is dispatched to the region thread owning the viewer's chunk via RTP.scheduler.runTask(viewerLocation, ...) rather than the global region thread, avoiding a NullPointerException on delivery. Metrics install falls through Folia -> Paper -> raw Bukkit sampler so bStats and /rtp info report live data from first boot.

• Relative coordinate tokens (/rtp centerx=~ centerz=~) now resolve to the player's position. A ~ value previously fell through to Boolean.valueOf("~") == false, silently setting the center to 0. A new resolveRelativeCoordinate helper resolves ~, ~<n>, -~, and -~<n> against the player's current X/Z.

• Fabric and NeoForge no longer suggest /rtp subcommands or parameters the caller lacks permission for. The Brigadier bridge's suggestion provider now gates suggestions through BrigadierBridgeContext.permissionCheck(), closing a tab-completion leak on Brigadier-dispatched platforms.

Changed

• Released jars trimmed of dead weight. Both Pro and lite jars now exclude compile-only IntelliJ annotation classes and orphan Maven metadata that leaked in from shaded dependencies. No code or API change.

• /rtp info stays compact before any metrics are sampled. TPS, MSPT, pipeline latency, percentile, and database-latency rows are suppressed until their underlying values exist. Always-available rows (JVM heap, queue depth, pending teleports, generation outcomes) are unchanged.

• Per-batch [TRACE] ScanTask diag line demoted from INFO to FINE. No longer spams the console during a world scan; still available at elevated log levels.

NEW

• Vault economy support now ships in lite: optional per-/rtp charging (price, priceOther, surcharges, balance floor, refund-on-cancel) works out of the box. Dormant at zero cost when Vault isn't installed.
• German (de) locale translation expanded (the locale already existed; this pass translates more of it).
• Region-specific schematic paste, with a shared translator across platforms.
• Optional PvP / combat-tag gate (off by default) with bundled integrations for PvPManager, CombatLogX and Simple Combat Log, plus a native combat tracker.
• /rtp clearcache admin command and a new rtp.admin permission node.
• /rtp info now surfaces generation success/failure rates and per-cause breakdowns; live-updating bad-locations map during a scan.
• uniquePlacements is now an integer chunk radius (legacy true/false still accepted); config getters tolerate boolean<->int cross-typing.
• Optional emergency-platform block-restoration timeout (safety.yml: platformRestoreSeconds).

CHANGED

• RTP is now MIT-licensed (open-core dual licensing). The jar bundles the MIT license text.
• Region biome visualization now sources pixels from saved scan biome data only.

[3.1.0] - 2026-05-31

Added

• German (de) locale shipped across all config/message files; full locale parity maintained.
• Region-specific schematic paste platforms (ADR-058) with new PasteOptions API and RegionVerifierRegistry footprint claim checks (S-003). New prefabs updated to use it (skyblock, oneblock, high-performance, multi-world).
• Pluggable bare-/rtp root action (ADR-056, REQ-API-F-006). New RootActionRegistry SPI (RTPAPI.hooks().rootAction()) lets an addon take over a bare /rtp (e.g. open a GUI menu) instead of teleporting; subcommands are never routed through it. Shipped with an example menu addon.
• Platform-agnostic addon SPI (ADR-057). New RTPAddon lifecycle interface + AddonRegistry (RTP.addons, ServiceLoader-based) so an addon jar runs unchanged on Bukkit/Paper/Folia, Fabric, and proxy JVMs. RTP_ExampleAddon ported with zero org.bukkit.* imports.
• Optional PvP / combat-tag gate (ADR-055). Off by default (safety.yml#pvpCheckEnabled=false). When enabled, /rtp is refused for a player currently in combat, using either a bound PvPCombatStateRegistry provider (combat-tag plugins such as PvPManager / SimpleCombatLog / CombatLogX) or RTP's built-in native damage tracker. The native tracker is now fed on every supported platform: Bukkit/Paper/Folia via an EntityDamageByEntityEvent listener and Fabric via ServerLivingEntityEvents.AFTER_DAMAGE (both resolve the projectile shooter / primed-TNT igniter as the aggressor and stamp victim/aggressor per pvpTagVictim / pvpTagAggressor). The gate is consulted at the /rtp pre-dispatch surface before the player is enrolled, fails open (a broken external provider never blocks a teleport), audits every refusal at WARNING (REQ-RTP-S-004), and uses the new configurable messages.yml#pvpInCombat string (REQ-RTP-F-013). Six safety.yml knobs: pvpCheckEnabled, pvpCombatTagSeconds, pvpOnCombat, pvpSource, pvpTagVictim, pvpTagAggressor.
• Bundled combat-tag plugin integrations for the PvP gate (ADR-055). New reflection-based soft-depend adapters for PvPManager, CombatLogX, and Simple Combat Log (rtp-plugin/.../softdepends/pvp/); PvPIntegrations.setup binds the first enabled plugin (priority PvPManager, then CombatLogX, then Simple Combat Log) to PvPCombatStateRegistry via RTPAPI.hooks().pvpCombatState(), gated on isPluginEnabled(...) like the claim integrations. When none is installed (or pvpSource: NATIVE), the native combat tracker answers; a reflective/API-version failure disables the adapter for the session and treats the player as not-in-combat (REQ-RTP-S-004). Wired in both the full and rtp-lite bootstraps. Covered by PvPCombatAdapterTest.
• uniquePlacements is now an integer chunk radius (was boolean; defaults to 0 = off). N >= 1 clears a (2N-1)x(2N-1) chunk square around each used spot so placements spread out; legacy true/false still coerce to 1/0. Retired spots tagged with a dedicated uniquePlacement fail cause.
• Config getters tolerate boolean<->int cross-typing, so a legacy true/false on a now-numeric knob (or 0/1 on a boolean knob) resolves instead of throwing.
• Optional emergency-platform block-restoration timeout (ADR-060). New safety.yml knob platformRestoreSeconds (-1 = disabled default; 0 = restore on first loaded pulse; > 0 = after that many seconds). Restores are chunk-load-aware (never force-loads, S-005), Folia-safe, and persisted across restarts.
• /rtp info now surfaces generation outcomes (REQ-RTP-OBS-007, ADR-052): success/failure rate and a per-cause rejection breakdown, via six new placeholders and three messages.yml lines.
• Live-updating bad-locations map during a world scan: the admin "Region shape" chart now re-renders ~1 Hz from the in-memory bad-keys cache so scan progress is visible without re-issuing the command.
• New bStats charts: language_selection, MSPT-p99 by platform/game-version/plugin-version, and aggregate generation-outcome (success rate + top failure cause). All privacy-safe (bucketised / whitelisted categories).
• /rtp clearcache admin command (permission rtp.admin). Clears the L1 (kept), L2 (unkept), and L3 (backlog) location caches for every region across the board in one shot, releasing any held chunk reservations and dropping the associated persisted rows; the scan/queue machinery refills the caches afterwards. Backed by a new RegionQueueManager.clearCaches().
• rtp.admin permission node declared in plugin.yml (both full and lite), gating /rtp clearcache and grouping the existing admin tooling permissions (rtp.reload, rtp.config, rtp.scan, rtp.info) as children so a single grant covers all admin commands.
• (Pro) Numeric range predicates in the safety-list grammar (ADR-017 amendment). safety.yml::unsafeBlocks / airBlocks now accept block-state comparisons (LAVA[level<=3], FIRE[age>=10], *[level>=8]); multiple bounds AND together. rtp-lite ignores tag/predicate tokens.

Changed

• Region biome visualization now sources its pixels from saved region biome data only. RegionBiomesResolver no longer reads on-disk .mca palettes via RTPWorld.readBiomesInRegionFile; it classifies each in-disk pixel through the new MemoryShape.biomeAt(int, int) / biomeAt(long), a floor-search over the persisted biomeKeysCache / biomePrefixSumsCache accumulated by the scan pipeline (no chunk I/O, S-005-clean). Pixels with no recorded biome render as unsampled (BLACK), so the chart reflects what the scan has actually saved for the region.

transferring from spigotmc resource https://www.spigotmc.org/resources/rtp.94812/

runs on paper and fabric, a few things left to implement on the fabric side of things but the core functionality works.