🍩 DonutRTP

A next-generation, high-performance, and fully configurable Random Teleport (RTP) plugin built for modern Minecraft networks. Supporting everything from traditional Spigot setups to multi-threaded Folia engines, DonutRTP ensures lag-free world exploration with an elegant GUI interface.

✨ What does it do?

DonutRTP allows players to safely teleport to random coordinates within a specified world using a smart, asynchronous location-finding engine.

• Donut-Shaped Search: Avoids teleports too close to spawn by using highly customizable min/max radius boundaries and custom centers ($X/Z$) per world.
• Advanced Safety Engine: Scans vertically for genuine safe spots. Features smart handling for Nether ceilings and automatically screens out dangerous blocks like lava, water, magma, and powder snow.
• Folia & Async Native: Utilizes thread-safe asynchronous chunk-loading, region/global schedulers, and teleportAsync to guarantee zero server lag during searches.
• Interactive GUI Menu (gui.yml): Players can open a completely customizable inventory menu via /rtp with dynamic custom heads, lore placeholders ({world}, {max-radius}), and custom per-button worlds.

🚀 Why should you use it?

• Zero Performance Impact: Location hunting runs entirely in the background, keeping your server's TPS smooth as butter.
• Combat & Economy Ready: Integrated warmup (cancels on move/damage) and global/per-world cooldown systems to prevent PvP escaping and teleport spamming.
• Universal Compatibility: Out-of-the-box support for Spigot, Paper, Purpur, and Folia across modern versions (Minecraft 1.20.x, 1.21.x, and up to 1.26.1.x).

⚠️ Critical Information

• Setup Required: Make sure to adjust your excluded blocks list in config.yml if you use custom world-generation or modded blocks.
• Commands & Perms: * /rtp or /rtp gui opens the main menu (Requires donutrtp.use permission).
  • /rtp reload reloads all configurations without needing a server restart (Requires donutrtp.reload).