Simple RTP

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)