zRTP

zRTP is a lightweight random teleport plugin for modern Paper servers, built for safe exploration, clean GUI-based world selection, persistent cooldowns, and Folia-friendly scheduling.

Open /rtp, choose a world, and zRTP will find a safe random location within your configured radius without letting teleport searches grow out of control.

Features

• Safe random teleportation with configurable minimum and maximum radius per world
• GUI world selector with custom items, lore, player counts, and cooldown display
• Multi-world support for Overworld, Nether, End, and custom configured worlds
• Per-world enable/disable controls
• Countdown before teleporting
• Optional cancel-on-move behavior
• Per-world RTP cooldowns
• Global world-change cooldowns
• Persistent cooldown storage with SQLite
• PlaceholderAPI support
• Admin commands for reload, forced RTP, and world toggling
• Configurable sounds, messages, GUI text, blacklist blocks, and world settings
• Folia-supported scheduling using entity and region schedulers

Performance

zRTP is designed to stay controlled under load:

• Safe-location searches are queued instead of running without limits
• Concurrent RTP searches are capped with performance.max-concurrent-searches
• Extra requests are rejected once performance.max-queue-size is reached
• Safe destinations can be pre-cached per world using safe-location-cache
• Cache refills run in the background and are limited per world
• Chunk loading uses async chunk APIs
• Teleporting uses teleportAsync
• SQLite uses WAL mode and async save/load paths for cooldown storage

Commands

• /rtp - Open the RTP menu
• /rtp <world> - Teleport to a configured world
• /wild - Alias for /rtp
• /zrtpadmin reload - Reload the plugin
• /zrtpadmin tp <player> <world> - Start an admin RTP for a player
• /zrtpadmin enable <world> - Enable RTP for a world
• /zrtpadmin disable <world> - Disable RTP for a world

Permissions

• randomtp.use - Allows players to use /rtp and /wild
• randomtp.world.overworld - Allows RTP to the Overworld
• randomtp.world.nether - Allows RTP to the Nether
• randomtp.world.end - Allows RTP to The End
• randomtp.cooldown.bypass - Bypass RTP cooldowns
• randomtp.admin - Access admin commands

Requirements

• Paper 1.21+
• Java 21
• PlaceholderAPI optional