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