Перейти к содержимому
Mineforgian

Donut RTP & RTP Zone

A powerful and polished teleportation plugin designed for Minecraft servers.

Загрузки
13K
Подписчики
4
Обновлён
21 августа 2026 г.
Лицензия
Apache-2.0

Опубликован 9 марта 2026 г.

Исходный кодСообщить об ошибке

About

DonutRTP

Support Nightbeam Studio

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.

Discord YouTube GitHub CurseForge Modrinth

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

Upgrade to Premium

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

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.

Join the Nightbeam Community

Ченджлог

1.5.1Релиз26.1.1, 26.1.2, 26.2 · 21 августа 2026 г.

DonutRTP Patch Notes

1.5.1

Bug Fixes

  • RTP zone no longer cancels when you jump. Countdown tracks the height where it started; jumping in place keeps it running. Walking out still cancels.
  • "Failed to find a safe location" is far less frequent. Surface finder scans from the true surface (ignoring leaf canopies) and lands feet on solid ground.

Platform

  • bStats metrics (plugin ID 33560)
  • Modrinth update check for donut-rtp-and-rtp-zone with console warning and donutrtp.admin join notify (update-check.*)
  • Confirmed support matrix: Bukkit / Spigot / Paper / Purpur / Folia on Minecraft 1.20.1–26.2
  • Apache-2.0 OSS cleanup (LICENSE, NOTICE, README, contributor docs)

Behaviour Notes

  • rtp-zone.countdown.cancel-on-move only reacts to horizontal movement. Jumping never counts as moving.

Upgrade Notes

  1. Replace the jar with 1.5.1. Keep plugins/DonutRTP/.
  2. Optional new keys under update-check are backfilled by defaults if missing.

1.5.0

Store release covering early zone/safe-location work. Prefer 1.5.1 for the complete jump-tolerant countdown, safer landings, bStats, and update check.

1.4.0

New Features

  • WorldGuard RTP zone — configure an existing WorldGuard region as an RTP pad
    • /donutrtp zone set <region> or /donutrtp zone set <world> <region>
    • /donutrtp zone remove, /donutrtp zone info, /donutrtp zone reload
    • Trigger on region enter (ENTER / BOTH); no re-trigger while remaining inside
    • Zone-specific cooldown, action-bar countdown, and messages
  • WorldGuard is an optional softdepend — the plugin starts without it and only disables region zones

Configuration

  • New rtp-zone section in config.yml (enabled by default; region empty until set)
  • Legacy rtp-zones cuboid zones still work when no WorldGuard region is configured

Permissions

  • donutrtp.zone.admin — manage zone commands (default: op)
  • donutrtp.cooldown.bypass — bypass cooldown when rtp-zone.cooldown.bypass-enabled is true

Commands

  • /rtp alias: donutrtp
  • /donutrtp zone set|remove|info|reload

Notes

  • INTERACT trigger mode disables region-entry RTP only; the /rtp GUI remains available
  • There is still no physical in-world RTP block/head interact listener

1.3.0

New Features

  • RTPZone mechanic — configurable cuboid zones that start a title/subtitle countdown on entry and random-teleport players when it completes

Configuration

  • New rtp-zones section in config.yml (disabled by default)
  • Per-zone: world, center, half-size (X/Y/Z), countdown-seconds, world-type, optional permission

Permissions

  • donutrtp.zone.use — allows triggering RTP zones (default: true)

1.2.1

Bug Fixes

  • Fixed frequent "Failed to find a safe location" by loading chunks before checks, using world-aware height scanning (Nether cave scan), and allowing passable decorative blocks at feet/head

Configuration

  • Default cooldown-seconds changed from 30 to 300
  • Default max-attempts increased from 30 to 60
  • Existing servers: update cooldown-seconds: 300 in your config.yml to apply the new cooldown

1.2.0

Added

  • HeadDatabase ID support — GUI items can use a HeadDatabase head via material: "hdb-<id>" (requires HeadDatabase plugin). Existing material and head block formats are unchanged.
  • Action bar cooldown sound — Optional sound played each second during the warmup countdown (actionbar-cooldown in config.yml). Disabled by default for backwards compatibility.
  • Instant teleport option — Set instant-teleport: true to skip the warmup countdown and teleport immediately after a safe location is found.

Configuration

  • New instant-teleport key in config.yml (default: false)
  • New actionbar-cooldown section in config.yml (see inline comments for examples)
  • HeadDatabase example under gui.items in config.yml
  • Missing config keys are backfilled with sensible defaults on reload

1.1.0

Added

  • Configurable GUI items — Per-world RTP buttons (Overworld, Nether, End) can be customized in config.yml:
    • Slot, display name, and lore
    • Any valid Minecraft material as the icon
    • Custom player heads via texture hash, full base64 value, UUID, or player name
  • Configurable teleport sound — Play a sound on successful RTP with adjustable volume and pitch (teleport-sound in config.yml)
  • Action bar warmup countdown — Remaining seconds are shown on the action bar during the teleport warmup (configurable via countdown-actionbar in messages.yml)

Changed

  • Warmup countdown no longer spams chat each second; the "don't move" warning still appears once in chat
  • Invalid materials, player heads, sounds, or GUI slots log a console warning and fall back to defaults

Configuration

  • New gui.items section in config.yml (see inline comments for examples)
  • New teleport-sound section in config.yml
  • New countdown-actionbar key in messages.yml

1.0.1

  • Folia compatibility improvements for async teleport handling

1.0.0

  • Initial release: DonutSMP-style RTP GUI for Paper and Folia
1.5.0Релиз26.1.1, 26.1.2, 26.2 · 14 августа 2026 г.

DonutRTP v1.5.0

Bug Fixes

  • RTP zone no longer cancels when you jump. The warmup countdown now tracks the height where it started, so jumping in place (or any vertical-only movement) keeps the countdown running. Walking out of the zone still cancels as before.
  • "Failed to find a safe location" is far less frequent. The surface finder had an off-by-one that placed the player's feet inside the ground block, causing ordinary flat terrain to be rejected. It now scans downward from the true surface (ignoring leaf canopies) and correctly lands players on solid ground.

Behaviour Notes

  • rtp-zone.countdown.cancel-on-move now only reacts to horizontal (walking) movement. Jumping never counts as moving. Leaving the zone always cancels regardless of the setting.
  • Surface scanning uses MOTION_BLOCKING_NO_LEAVES plus a short downward window, improving success in forests, snowy biomes, and on carpets/slabs.

Compatibility

  • Same loaders as 1.4.0 (Paper / Folia / Purpur family, api-version 1.20). Folia-safe: safe-location search and per-player countdowns still run on the correct region/entity threads.

Upgrade Notes

  1. Replace the DonutRTP jar with 1.5.0. Keep your existing plugins/DonutRTP/ folder.
  2. No config changes are required. The cancel-on-move comment was clarified but the key and default (false) are unchanged.
  3. If you previously saw frequent "no safe location" errors, verify your world radius and min-y still make sense; the finder is now more reliable within those bounds.
1.4.0Релиз26.1.1, 26.1.2, 26.2 · 10 июля 2026 г.

New Features

  • WorldGuard RTP zone — configure an existing WorldGuard region as an RTP pad
    • /donutrtp zone set <region> or /donutrtp zone set <world> <region>
    • /donutrtp zone remove, /donutrtp zone info, /donutrtp zone reload
    • Trigger on region enter (ENTER / BOTH); no re-trigger while remaining inside
    • Zone-specific cooldown, action-bar countdown, and messages
  • WorldGuard is an optional softdepend — the plugin starts without it and only disables region zones

Configuration

  • New rtp-zone section in config.yml (enabled by default; region empty until set)
  • Legacy rtp-zones cuboid zones still work when no WorldGuard region is configured

Permissions

  • donutrtp.zone.admin — manage zone commands (default: op)
  • donutrtp.cooldown.bypass — bypass cooldown when rtp-zone.cooldown.bypass-enabled is true
1.3.0Релиз26.1.1, 26.1.2, 26.2 · 22 июня 2026 г.

New Features

  • RTPZone mechanic — configurable cuboid zones that start a title/subtitle countdown on entry and random-teleport players when it completes

Configuration

  • New rtp-zones section in config.yml (disabled by default)
  • Per-zone: world, center, half-size (X/Y/Z), countdown-seconds, world-type, optional permission

Permissions

  • donutrtp.zone.use — allows triggering RTP zones (default: true)
1.2.1Релиз26.1.1, 26.1.2, 26.2 · 18 июня 2026 г.

Bug Fixes

  • Fixed frequent "Failed to find a safe location" by loading chunks before checks, using world-aware height scanning (Nether cave scan), and allowing passable decorative blocks at feet/head

Configuration

  • Default cooldown-seconds changed from 30 to 300
  • Default max-attempts increased from 30 to 60
  • Existing servers: update cooldown-seconds: 300 in your config.yml to apply the new cooldown
1.2.0Релиз26.1, 26.1.1, 26.1.2 · 10 июня 2026 г.

Added

  • HeadDatabase ID support — GUI items can use a HeadDatabase head via material: "hdb-<id>" (requires HeadDatabase plugin). Existing material and head block formats are unchanged.
  • Action bar cooldown sound — Optional sound played each second during the warmup countdown (actionbar-cooldown in config.yml). Disabled by default for backwards compatibility.
  • Instant teleport option — Set instant-teleport: true to skip the warmup countdown and teleport immediately after a safe location is found.

Configuration

  • New instant-teleport key in config.yml (default: false)
  • New actionbar-cooldown section in config.yml (see inline comments for examples)
  • HeadDatabase example under gui.items in config.yml
  • Missing config keys are backfilled with sensible defaults on reload
1.1.0Релиз26.1, 26.1.1, 26.1.2 · 9 июня 2026 г.

Added

  • Configurable GUI items Per-world RTP buttons (Overworld, Nether, End) can be customized in config.yml:
    • Slot, display name, and lore
    • Any valid Minecraft material as the icon
    • Custom player heads via texture hash, full base64 value, UUID, or player name
  • Configurable teleport sound Play a sound on successful RTP with adjustable volume and pitch (teleport-sound in config.yml)
  • Action bar warmup countdown Remaining seconds are shown on the action bar during the teleport warmup (configurable via countdown-actionbar in messages.yml)

Changed

  • Warmup countdown no longer spams chat each second; the "don't move" warning still appears once in chat
  • Invalid materials, player heads, sounds, or GUI slots log a console warning and fall back to defaults

Configuration

  • New gui.items section in config.yml (see inline comments for examples)
  • New teleport-sound section in config.yml
  • New countdown-actionbar key in messages.yml
1.0.1Релиз1.21.11, 26.1, 26.1.1 · 3 апреля 2026 г.
  • fixed TP on Folia didn't work properly.

Комментарии

Загружаем…