DonutRTP – Modern, Performant Random Teleport


Are your players tired of clunky, slow, or unsafe random teleport commands? Standard /spreadplayers or basic RTP plugins can cause server lag when searching for safe locations and often lack a modern user experience. DonutRTP is the definitive, performance-first solution inspired by the seamless teleport system on popular servers like Donut SMP.

Unlike other RTP plugins that can freeze your server while scanning unloaded chunks, DonutRTP uses a powerful asynchronous and hybrid search method. It guarantees a safe, fast teleportation for your players without ever impacting your server's TPS or MSPT, providing a smooth and professional experience for any survival, factions, or anarchy server.



⚡ Features

• Modern GUI: A clean, intuitive, and universally understood interface. Players simply click the block of the dimension they want to explore (Overworld, Nether, or The End).
  
  
• Lag-Free Performance: The plugin's core is built around an asynchronous engine that finds teleport locations in the background without freezing the main server thread.
  
  
• Guaranteed Safe Teleport: A robust algorithm ensures players will never land inside a wall, underground, in lava, or fall from a fatal height.
  
  
• Intelligent Nether Logic: Prevents players from teleporting on top of the Nether bedrock roof, instead finding a safe location within the main caverns.
  
  
• Fully Configurable: Customize distances, cooldowns, countdown timers, world names, all messages, and sounds directly from the config.yml.
  
  
• Player-Friendly Countdown: A configurable countdown with an on-screen action bar message prevents players from using /rtp to escape combat. Moving cancels the teleport.
  
  
• Admin Controls: A simple /rtp reload command allows you to apply configuration changes instantly without a server restart.

️ Performance Optimization


DonutRTP is engineered to eliminate the lag commonly associated with random teleportation. It uses a hybrid asynchronous search strategy:

1. Fast Path: The plugin first attempts to find a safe location within already-loaded chunks in memory. This is instant and has zero performance impact.
   
   
2. Guaranteed Path: If the fast search fails (on a new or less-explored server), the plugin safely loads a single chunk asynchronously in the background to find a valid spot.

This two-phase method provides the best of both worlds: lightning-fast teleports on active servers and a guaranteed, lag-free teleport on any server, protecting your TPS and MSPT at all times.



Commands & Permissions

• donut.rtp.use - Allows players to use the /rtp command. (Default: true)
  
  
• donut.rtp.admin - Allows usage of the /rtp reload command. (Default: op)
  
  
• donut.rtp.bypass.cooldown - Allows players to bypass the teleport cooldown. (Default: op)
  
  
• donut.rtp.bypass.move - Allows players to move during the countdown without cancelling. (Default: op)
  
  
• /rtp – Opens the main teleportation GUI.
  
  
• /rtp reload – Reloads the configuration file.

Configuration Snippet


YAML
# --- Distance Settings ---
# Minimum distance (in blocks) from 0,0.
min-distance: 1000
# Maximum distance (in blocks) from 0,0.
max-distance: 10000

# --- Optimization Settings ---
# The maximum number of times the plugin will try the "fast path" before using the "guaranteed path".
teleport-retries: 40

# --- World Settings ---
# Define the exact names of your worlds.
worlds:
overworld: "world"
nether: "world_nether"
the_end: "world_the_end"

# --- Messages ---
# All user-facing messages. Fully supports color codes with '&'.
messages:
teleport-countdown: "&7Teleporting in &b{seconds}s"
teleport-success: "&7You teleported to a random location"

This setup provides admins with a powerful, reliable, and high-performance random teleport system that enhances the survival experience without the technical headaches.