DonutRTP

# 🍩 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`).