Simple Minecraft plugin that teleports players to a random location within a radius
❇️ This plugin belongs to the Simple Plugins collection, check out other similar and compatible plugins here
Features
- /rtp command that teleports a user randomly
- Within a customizable perimeter starting from (0, 0)
- Never in the air or on the Nether roof
- You can make the command usable only once
- World filter: limits in which worlds the user can use the command
- If disabled (default): the user can use it in all worlds
- If enabled: the user can only do so in the worlds defined in the config
- Configurable radius (default 1000 blocks) and cooldown (0 = no cooldown)
- Optional cost (Vault + economy plugin): player pays cost-amount to use /rtp
- All configuration is read from config.yml
- Configurable prefix for plugin messages (prefix)
- Minecraft color codes supported using &
Commands
- /rtp Randomly teleports the user
- /srtp reload Reloads the plugin configuration
Permissions
- srtp.rtp: Allows the user to use the RTP command
- srtp.rtp.once: Allows the user to execute the RTP command only once
- srtp.toggle: Enables the user to use the /rtp reload command
Configuration
prefix: "&7[&6SimpleRTP&7] &r"
world-filter-enabled: false
worlds:
- "world"
radius: 1000
cooldown: 0
cost-enabled: false
cost-amount: 100.0
messages:
teleporting: "&fTeleporting..."
success: "&aTeleport successful!"
failed: "&cCould not find a safe location. Try again."
no-permission: "&cYou do not have permission to use this command"
reload-no-permission: "&cYou do not have permission to reload the configuration"
world-not-found: "&cThe RTP world(s) could not be found. Contact an administrator"
world-not-allowed: "&cYou can only use /rtp in these worlds: %worlds%"
used-once: "&cYou have already used random teleport"
cooldown: "&cYou must wait %seconds% seconds before using /rtp again"
cost-insufficient: "&cYou do not have enough money. Cost: %cost%"
cost-no-vault: "&cRTP cost is enabled but no economy is available"
player-only: "&cThis command can only be executed by a player"
reload-success: "&aConfiguration reloaded"
- prefix: Prefix prepended to all plugin messages. Use & for color codes. Empty string = no prefix
- world-filter-enabled: false = /rtp works in any world; true = only in worlds listed in worlds
- worlds: List of world names where /rtp is allowed when world filter is enabled
- radius: Side of the area from (0,0) in blocks. Teleport is within [-radius, radius] on X and Z
- cooldown: Seconds between uses per player. 0 = no cooldown
- cost-enabled / cost-amount: When cost is enabled, player must pay the amount
- messages: All plugin messages. Placeholders: %worlds%, %seconds%, %cost%
[!] 'Cost enabled' requires Vault + economy plugin
Requirements
- Java 21 (LTS)
- Paper or Spigot server on the latest supported version
Internal behaviour
- The player always spawns on a solid block (never in the air)
- In the Nether, the player never spawns on or above the roof (never above Y 124)
- The "once" permission (srtp.rtp.once) is stored persistently per player (PersistentDataContainer)
