Exploration-Gated Biome Unlocks (NEW)

/rtp biome (new alias: /rtp biomes) can now be a progression system: players must physically
discover a biome before they can travel to it. First contact pops an advancement toast, a chat notice and a sound.

• Opt-in via biome-finder.unlock.enabled — off by default, nothing changes unless you want it to
• Staff bypass permission: roam.biome.bypass-unlock
• Existing discoveries are honoured — enabling the gate never takes anything away from players

Biome Collection GUI (NEW)

Undiscovered biomes render as sealed crystal cards that flip to each biome's own icon once explored — including
54 curated textured heads out of the box.

• Every card shows a description plus a "You'll find:" line — all ~110 bundled biomes curated
• Discovered: N/M progress counter on the menu
• Custom heads supported via icon: "head:<base64>" in biomes.yml

Performance

• Chunk-free candidate screening on Iris worlds — water and biome checks run against Iris' own noise streams
  instead of generating a chunk per rejected candidate
• Adaptive mode (on by default) — an MSPT probe throttles background generation to zero under load and clamps
  search parallelism, so /rtp never piles chunk loads onto a struggling tick loop; each world learns its own search
  difficulty
• Demand-gated location cache — idle worlds stop generating terrain in the background; with warm-chunks, a
  cache hit costs a disk read instead of fresh generation — effectively instant /rtp
• Two-phase chunk preload — teleports block only on the 9 chunks around the player; the outer ring loads after
  arrival
• Per-candidate slot timeouts with replacement — one stuck chunk generation no longer freezes the whole search
• Cached biome rosters and engine handles — tab-complete and the biome menu no longer walk registries on every
  keystroke

Seven Languages, Fully Localized

Russian, Simplified Chinese, Romanian and German join English, Spanish and Brazilian Portuguese. The GUI is part of
the translation set now: one language: setting switches chat and menus together.

Fixes & Hardening

• GUI pagination no longer dies after the first page navigation; border clicks can no longer resolve to a biome
• The "Searching..." boss bar can no longer get stuck on screen after a teleport — full lifecycle rework plus a
  self-healing watchdog
• Search slot timeouts no longer discard valid locations found moments later on slow hardware
• Citizens biome NPCs now respect the unlock gate
• Exception-safe teleport tail, quit-time cleanup, and a professional text pass across every player-facing surface

Removed

• /rtp structure — out of scope for Roam's design

Notes

• The Iris integration is flagged experimental: it works without server lag, but chunk loading on Iris
  teleports is still slow. Mitigations are documented in the README.
• Unified teleport pipeline backed by a 21-test suite that gates every build.
• No config migration needed — every new key ships with a sensible default.

Full changelog: CHANGELOG.md