DonutRTP is a powerful and polished random teleportation plugin designed for Minecraft servers running Spigot, Paper, or Folia. Whether you're managing a survival world or a large multiplayer environment, DonutRTP provides safe, configurable random teleports with world-specific settings, safety checks, warmups, cooldowns, and modern Folia-compatible teleport handling.
Features
| Feature | Description |
|---|---|
| Random Teleportation | Teleport players to randomized locations within configured world boundaries |
| World-Specific Configuration | Configure teleport behavior independently for different worlds |
| Safe Location Detection | Avoid dangerous locations such as lava, water, and excluded blocks |
| Multiple Search Methods | Choose between simple and advanced location-finding behavior |
| Warmup System | Add a configurable delay before a random teleport begins |
| Cooldown System | Prevent teleport abuse with configurable cooldowns |
| Radius & Distance Controls | Define minimum and maximum teleport distances and specific search radii |
| World Restrictions | Control which worlds can use random teleportation |
| Folia Compatibility | Supports asynchronous and region-safe location searching for Folia environments |
| Configurable Safety Rules | Customize excluded blocks, fallback behavior, world types, and location requirements |
| Reload Support | Apply configuration changes without restarting the server |
| Modern Server Support | Designed for Spigot, Paper, and Folia with Minecraft 1.19+ support |
Random Teleportation
DonutRTP provides a simple random teleport system designed for survival and multiplayer servers.
Players can use /rtp to search for a random location within the configured boundaries of the current or permitted world.
The plugin can be configured to control:
- Minimum teleport distance
- Maximum teleport distance
- Search radius
- World-specific behavior
- Allowed and restricted worlds
- Location search behavior
- Fallback handling
This allows server owners to create different RTP experiences depending on the world or environment.
Safety System
Random teleportation should never place players directly into obvious danger.
DonutRTP includes location checks designed to find suitable destinations before completing a teleport.
Safety Checks
The plugin can be configured to avoid:
- Lava
- Water
- Excluded blocks
- Unsafe terrain
- Restricted locations
- Invalid teleport destinations
Server owners can customize excluded blocks and location-finding behavior through the configuration.
Location Finding
DonutRTP provides configurable location-finding behavior for different server setups.
Depending on the configuration, server owners can choose between simpler or more advanced search methods.
Search Options
- Randomized coordinate selection
- Configurable distance boundaries
- Defined teleport radii
- World-specific search rules
- Excluded block detection
- Safety validation
- Fallback behavior
Folia environments can use asynchronous location searching to avoid unsafe blocking operations.
Warmup & Cooldowns
DonutRTP includes configurable systems to control how frequently players can teleport.
Warmup
A warmup can be applied before teleportation begins.
This gives server owners control over how quickly players can escape or move to a new random location.
Cooldowns
Cooldowns can prevent repeated RTP usage and teleport abuse.
The plugin supports configurable cooldown behavior that can be adapted to the needs of the server.
World Configuration
Different Minecraft worlds may require different teleport rules.
DonutRTP supports world-specific configuration so server owners can adapt random teleportation to different environments.
Configuration can include:
- Distance limits
- World restrictions
- Excluded blocks
- World types
- Search methods
- Safety behavior
- Fallback behavior
This makes DonutRTP suitable for servers using multiple survival or custom worlds.
Advanced Options
DonutRTP provides additional controls for servers that need more than a basic random teleport command.
Advanced options include:
- Teleporting within specific radii
- Defined region behavior
- WorldType configuration for custom landscapes
- Fine-tuned excluded block lists
- Configurable fallback behavior
- World-specific teleport rules
- Multiple location-finding approaches
Performance & Stability
DonutRTP is designed with modern Minecraft server environments in mind.
The plugin includes:
- Folia-compatible teleport handling
- Asynchronous location searching where appropriate
- Safe off-thread operation
- Clean reload behavior
- Clean shutdown routines
- Modern API support
- Logic designed to avoid unnecessary server-thread blocking
These systems help keep random teleportation responsive even on larger multiplayer servers.
Configuration
DonutRTP is configured through config.yml.
Server owners can customize settings such as:
- Minimum teleport distance
- Maximum teleport distance
- Teleport radius
- Warmup duration
- Cooldown duration
- Excluded blocks
- World restrictions
- World-specific settings
- WorldType behavior
- Location-finding method
- Safety rules
- Fallback behavior
After changing the configuration, /rtp reload can be used to apply changes without restarting the server.
Commands
| Command | Description |
|---|---|
/rtp |
Randomly teleport to a valid location |
/rtp reload |
Reload DonutRTP configuration without restarting the server |
Permissions
DonutRTP uses permission-based access to control player and administrative functionality.
Permissions can be used to determine:
- Which players can use random teleportation
- Which staff members can access administrative functionality
- Who can reload plugin configuration
Exact permission nodes may depend on the plugin version and configuration.
Installation
- Place
DonutRTP.jarinside your server'splugins/folder. - Start the server to generate the configuration files.
- Open
config.ymland customize the RTP behavior for your server. - Configure distance limits, excluded blocks, world rules, warmups, cooldowns, and other options.
- Run
/rtp reloadafter making changes to apply them without restarting the server.
Why Choose DonutRTP?
- Safe Teleports — Built-in location checks help prevent players from being sent into dangerous terrain.
- Flexible Configuration — Customize worlds, distances, excluded blocks, warmups, cooldowns, and search behavior.
- Modern Server Support — Designed for Spigot, Paper, and Folia environments.
- World-Specific Control — Configure different teleport behavior for different worlds.
- Responsive Searching — Folia-compatible asynchronous location searching helps keep teleport handling responsive.
- Easy Administration — Reload configuration changes without restarting the server.
- Survival Friendly — Well suited for survival servers and large multiplayer environments.
Compatibility
- Spigot
- Paper
- Folia
- Minecraft 1.19+
- Survival servers
- Multiplayer servers
- Multi-world environments
- Custom world configurations
Requirements
DonutRTP requires a supported Spigot, Paper, or Folia Minecraft server running version 1.19 or newer.
No additional dependency requirements are specified for the core random teleport functionality.
Community & Support
- Discord: https://discord.gg/TJc3CxR4jK
- GitHub: https://github.com/MeherBenSalem
- Website: https://nightbeam.dev
- Store: https://nightbeam.dev/store
- CurseForge: https://www.curseforge.com/members/nightbeamstudio/projects
- Modrinth: https://modrinth.com/organization/nightbeam
If you encounter a bug or have a feature request, please join the Discord community or report it through the appropriate project page.
License
DonutRTP is licensed under the Apache License 2.0.
You are free to use, modify, and redistribute DonutRTP in accordance with the terms of the Apache License 2.0.
