🎲 RTP: The Ultimate Random Teleport Plugin

Tired of spawn camping? Need a quick escape to the unknown?

RTP (Random Teleport) is the sleek, powerful plugin that instantly throws players into a new, safe, and completely random location—even across dimensions! Forget clunky commands; our customizable GUI makes exploration effortless and fun. RTP supports custom worlds/multiple worlds but you will have to install a separate world manager plugin for this to work (Worlds, Multiverse, World Manager)

---

✨ Key Features That Redefine Adventure

• ⚡ Instant, Safe Teleportation: Use the simple /rtp command to open a beautiful GUI and launch your players into the wild.
• 🌍 World Hopping (or Not!): Players can choose to be teleported randomly within the Overworld, Nether, or The End. You have full control to enable or disable any world through the config.
• 🚫 Respects World Borders: Never worry about players glitching out! The plugin intelligently selects a random location that respects the World Border of the target world.
• 🎯 Beautiful & Simple GUI: Your players will love the clean, easy-to-use interface. All item materials, names, slots, and lore are fully customizable.

---

⚙️ Total Control & Customization

The RTP plugin gives server owners and administrators comprehensive control over the player experience.

• ⏱️ Advanced Rank-Based Cooldowns: Implement a tiered cooldown system using permissions. Give your VIP ranks (e.g., rtp.cooldown.rank1) shorter cooldowns to reward them!
• 📜 Custom Messages & Sounds: Customize every single message, from the teleport countdown to cancellation notices, ensuring the plugin perfectly fits your server's style.
• 🛡️ Safety & Immersion: Configure teleport settings like a customizable countdown timer, and easily enable/disable movement or damage cancellation.
• 🎉 Visual Flair: Enhance the experience with configurable teleport sounds and particle effects (like PORTAL) to make every warp feel special.

---

💻 Commands & Permissions

Command	Description	Permission	Default
/rtp	Opens the World Selection GUI for random teleportation.	rtp.use	True
/rtpreload	Reloads the plugin configuration.	rtp.reload	OP

Cooldown Permissions

Cooldowns are customizable in the config, allowing you to set different timers for different player ranks using permissions like this:

Permission Example	Effect
rtp.cooldown.rank1	Uses the custom cooldown time set for rank1 (120s in example).
rtp.cooldown.vip	(Create your own!) Set a shorter time for VIPs!

⚙️ Config Example

# === RTP GUI Plugin Configuration ===
# CUSTOM WORLDS ARE NOT SUPPORTED NATIVELY!!!
# If you want custom world support, please download
# a plugin for initializing worlds such as Worlds,
# Multiverse, World Manager, etc.

# GUI Settings
gui:
  title: "<gradient:green:yellow>Select a World to Teleport</gradient>"
  size: 9 # 9 per row. 2 rows = 18, 3 rows = 27, and so on
  open-sound: "UI_BUTTON_CLICK"
  click-sound: "BLOCK_NOTE_BLOCK_PLING"
  disabled-sound: "ENTITY_VILLAGER_NO"
  items:
    overworld:
      world-name: "world"
      min-radius: 0
      max-radius: 0 # Leave this 0 to just teleport based on world-border
      enabled: true
      slot: 2
      material: GRASS_BLOCK
      name: "<green>Overworld"
      lore:
        - "<gray>Click to teleport randomly in the Overworld!"
    nether:
      world-name: "world_nether"
      # The logic for this does not teleport you to coordinates 10,000 to 11,000. It uses a mathematical calculation
      # that converts this to a circular band instead of a square.
      min-radius: 10000
      max-radius: 11000
      enabled: false
      slot: 4
      material: NETHERRACK
      name: "<red>Nether"
      lore:
        - "<gray>Click to teleport randomly in the Nether!"
    end:
      world-name: "world_the_end"
      min-radius: 0
      max-radius: 0
      enabled: false
      slot: 6
      material: END_STONE
      name: "<yellow>The End"
      lore:
        - "<gray>Click to teleport randomly in the End!"

cooldown:
  default:
    cooldown: 180
    # This is the default cooldown if players don't
    # have any rtp.cooldown.<rankname> permissions.
  rank1:
    permission: "rank1" # rtp.cooldown.rank1
    cooldown: 120
  rank2:
    permission: "rank2" # rtp.cooldown.rank2
    cooldown: 60

teleport:
  # I strongly suggest not increasing max-attempts from 100 as it might cause massive tps drops or server crashes.
  max-attempts: 100    # maximum # of attempts to find a safe location to teleport to
  countdown: 5         # seconds before teleport happens
  move-cancel: true    # cancel teleport if player moves
  damage-cancel: true  # cancel teleport if player takes damage
  countdown-sound: "UI_BUTTON_CLICK"

# Teleportation effects
effects:
  teleport-sound: "ENTITY_ENDERMAN_TELEPORT"
  teleport-particle: "PORTAL"
  particle-count: 40

# Blacklisted blocks (blocks a player won't teleport on).
blacklist-blocks:
  - "LAVA"
  - "FIRE"
  - "CACTUS"
  - "MAGMA_BLOCK"
  - "CAMPFIRE"
  - "SOUL_CAMPFIRE"
  - "SOUL_FIRE"
  - "WATER"

# Messages
messages:
  teleported: "<green>Teleported to a random location in the %world%<green>!"
  cooldown: "<red>You must wait <yellow>%time%s</yellow> before using RTP again!"
  countdown: "<yellow>Teleporting in %countdown%s..."
  cancel-move: "<red>Teleport cancelled because you moved!"
  cancel-damage: "<red>Teleport cancelled because you took damage!"
  no-permission: "<red>You have no permission to use /rtp reload!"
  scanning: "<aqua>Scanning for a safe teleport location. <gray>(Attempt#%attempt%)"

Ready to give your players the gift of the unknown? Install RTP today!