Obscure RTPQ

ObscureRTPQ

ObscureRTPQ is a high-performance, asynchronous matchmaking queue extension built for modern Spigot and Paper Minecraft server platforms targeting Minecraft 1.21+.

It provides a competitive "Crystal PvP" style matchmaking loop that pairs players using non-blocking concurrent collection arrays. Matched players are seamlessly distributed into identical random coordinates with a structural safety coordinate offset. The plugin features full runtime customization using an in-game GUI inventory menu that interfaces natively with both default server worlds and custom worlds managed by Multiverse-Core.
🛠️ Features Implemented

Thread-Safe Matchmaking Queue: Backed by an isolated ConcurrentLinkedQueue sequence inside the QueueManager to manage swift entry updates cleanly without thread contention, memory deadlocks, or lag spikes.
Asynchronous Coordinate Processing (RtpProvider): Offloads heavy world block verification calculations to a background CompletableFuture worker thread, ensuring main-thread TPS remains unaffected while processing teleport safety frames.
Seamless Multiverse-Core Integration: Built to load post-world (POSTWORLD), allowing it to automatically recognize, register, and interface with custom imported or generated Multiverse worlds right out of the box.
In-Game Admin Configuration GUI Menu: Administrators can execute /rtpq config to pull up an interactive chest inventory displaying all active worlds. Clicking options dynamically updates and saves active matching worlds to the server disk in real-time.
Strict World Guard Restrictions: Restricts queue actions via dedicated runtime validation checks. Players cannot join the queue from unlisted worlds, and players who shift between worlds while sitting in the queue are automatically filtered out safely.
Isolated Administrative Debug Layer: Admins can trigger /rtpq debug to toggle a solo matching script. While active, joining the queue simulates finding a dummy match instantly to test chat strings, target locations, offsets, and audio sound mechanics completely alone.