AdvancedRTPQueue

AdvancedRTPQueue v3.2

Release Date: 2026-04-06 ---

Highlights

* Rebuilt the RTP location search pipeline for production workloads. * Fixed unsafe async world access that caused lag spikes and inconsistent results. * Hardened safe-teleport checks, especially for Nether roof / bedrock scenarios. * Improved fallback and cache behavior for reliable teleports under heavy load. ---

Teleport Engine Rewrite

Replaced legacy search loop with a shared per-world search future model*. * Chunk loading now uses PaperLib.getChunkAtAsync(...). All block/world checks are safely executed on the main thread*. Added strict world-border validation* during candidate selection. * Implemented: * Cache warmup * Periodic cache refill Added configurable cache refresh cadence*. ---

Safe Teleport Improvements

Added Nether roof protection*: `teleport.prevent-nether-roof` (default: true)* `teleport.nether-roof-min-y` (default: 120)* * Improved standability validation: * Solid ground check * Passable head/feet space * Enhanced hazard detection using configurable radius. * Enforced claim protection during location validation. ---

Fallback Improvements

* Improved spawn fallback scanning: `teleport.fallback-search-radius` (default: 64)* `teleport.fallback-search-attempts` (default: 48)* * Added forced fallback option: `teleport.force-spawn-on-failure` (default: false)* ---

Performance & Stability

* Optimized particle handling: * Now sent only to nearby players instead of global broadcasts. * Added silent queue removal API: * Prevents unnecessary message spam during teleport handoff. * Fixed async chat cancellation: * Now safely scheduled back on the main thread. * Claim protection state now properly refreshes on plugin reload. * Teleport manager now supports: * Clean reload handling * Cache reinitialization ---

Commands & UX

Added `/rtpqueue cancel` (alias of /rtpqueue leave)* * Updated command usage in plugin.yml ---

New Config Keys

teleport.cache-refresh-interval-ticks: 100
teleport.fallback-search-radius: 64
teleport.fallback-search-attempts: 48
teleport.force-spawn-on-failure: false
teleport.safety-check-radius: 1
teleport.prevent-nether-roof: true
teleport.nether-roof-min-y: 120

---

New Message Keys

messages.cancelled-not-enough
messages.cancelled-invalid-world
messages.cancelled-disconnect
messages.cancelled-force