Language

RTP

RTP

Modrinth

Very simple /rtp plugin inspired by DonutSMP

30.6k downloads 14 followers updated 7mo ago
latest v1.6 Modrinth
Bukkit Folia Paper Purpur Spigot 1.21 – 1.21.11 AdventureGame-mechanicsUtility

🎲 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!

Versions

Release
1.6
bukkit, folia, paper · 1.21, 1.21.1, 1.21.2 · 7mo ago
- Added min-radius and max-radius per world. - Added config option for maximum teleport attempts. - Added config option to blacklist blocks in order to avoid…
28.3k
Release
1.5
folia, paper · 1.21, 1.21.1, 1.21.2 · 7mo ago
- Fixed RTP to nether brings the player to the nether roof. - Added messages in the config. _(**Have to delete old config** if you don't **manually want to…
1.1k
Release
1.4
bukkit, folia, paper · 1.21, 1.21.1, 1.21.2 · 7mo ago
- Added bStats
219
Release
1.4
folia, paper · 1.21.4, 1.21.5, 1.21.6 · 7mo ago
- Revamped config (need to delete old config, sorry :( ) - Fixed the issue where if a player has multiple cooldown ranks, cooldowns dont work correctly. -…
201
Release
1.3.0
folia · 1.21, 1.21.1, 1.21.2 · 7mo ago
- Added customizable permission-based cooldowns!
182
Release
1.2.0
folia, paper · 1.21, 1.21.1, 1.21.2 · 8mo ago
355

Comments 0

No comments yet. Be the first to share your thoughts.