Sakura Random Teleport

A configurable random teleport plugin by SakuraZ, featuring an optional GUI, direct teleport commands, safe-location checks, and persistent cooldowns.

Features

• Optional GUI: use a world-selection menu or command-only mode.
• Three destinations: Overworld, Nether, and The End.
• Configurable areas: customize world names, area widths, and center coordinates.
• Safe-location checks: check terrain, headroom, hazards, and world borders.
• Asynchronous chunk loading: load destination chunks asynchronously.
• Custom countdown: configure teleport delays, Actionbar messages, and sounds.
• Instant mode: setting cooldown-seconds: 0 disables cooldowns and skips the countdown. Safe-location checks still apply.
• Persistent cooldowns: cooldowns survive reconnects and server restarts.
• Movement handling: moving within the same block does not cancel RTP. Crossing an X or Z block boundary cancels it.
• Hidden coordinates: the default success message displays only the destination name.

Commands

Command	Description
/rtp	Opens the GUI, or shows command usage when the GUI is disabled
/rtp overworld	Teleports to the configured Overworld
/rtp nether	Teleports to the configured Nether
/rtp the_end	Teleports to the configured End
/rtp reload	Reloads configuration in-game; requires admin permission

Alias: /randomteleport

Direct destination commands work in both GUI and command-only modes.

Configuration

Enable the world-selection GUI:

rtp-gui: true

Disable the GUI and use destination commands:

rtp-gui: false

Default teleport timings:

countdown-seconds: 5
cooldown-seconds: 60

Set countdown-seconds: 0 to skip the countdown while keeping cooldowns.

Set cooldown-seconds: 0 to disable cooldowns and skip the countdown.

Apply configuration changes using /rtp reload in-game. Existing configurations without rtp-gui keep GUI mode enabled.

Permissions

Permission	Default
randomteleportplugin.use	Everyone
randomteleportplugin.admin	Operators

Installation

1. Stop your server.
2. Place the plugin JAR in the plugins folder.
3. Start the server.
4. Edit plugins/RandomTeleportPlugin/config.yml.
5. Run /rtp reload in-game.

When updating, replace the previous JAR. Do not keep multiple versions installed.

Compatibility

Designed for Paper and Purpur 1.21–26.2, using one plugin JAR.

• Minecraft 1.21.x: Java 21.
• Minecraft 26.x: Java 25.
• Bukkit, Spigot, and Folia: not supported.

Version 1.1.0 passed server-side compatibility checks on 14 Paper releases and 13 Purpur releases.

Version 1.1.2 passes build and command-parsing/configuration tests. The full server-version compatibility matrix has not been repeated for this release.

Terrain checks reduce unsafe landings but cannot guarantee protection from mobs, traps, or later world changes.

Created by SakuraZ