Описание
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
1. Place `DonutRTP.jar` inside your server's `plugins/` folder.
2. Start the server to generate the configuration files.
3. Open `config.yml` and customize the RTP behavior for your server.
4. Configure distance limits, excluded blocks, world rules, warmups, cooldowns, and other options.
5. Run `/rtp reload` after making changes to apply them without restarting the server.
# Why Choose DonutRTP?
1. **Safe Teleports** — Built-in location checks help prevent players from being sent into dangerous terrain.
2. **Flexible Configuration** — Customize worlds, distances, excluded blocks, warmups, cooldowns, and search behavior.
3. **Modern Server Support** — Designed for Spigot, Paper, and Folia environments.
4. **World-Specific Control** — Configure different teleport behavior for different worlds.
5. **Responsive Searching** — Folia-compatible asynchronous location searching helps keep teleport handling responsive.
6. **Easy Administration** — Reload configuration changes without restarting the server.
7. **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](https://discord.gg/TJc3CxR4jK)
* GitHub: https://github.com/MeherBenSalem
* Website: [https://nightbeam.dev](https://nightbeam.dev/)
* Store: [https://nightbeam.dev/store](https://nightbeam.dev/store)
* CurseForge: [https://www.curseforge.com/members/nightbeamstudio/projects](https://www.curseforge.com/members/nightbeamstudio/projects)
* Modrinth: [https://modrinth.com/organization/nightbeam](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.