Перейти к содержимому
Mineforgian

RTP

Very simple /rtp plugin inspired by DonutSMP

Загрузки
34K
Подписчики
17
Обновлён
21 ноября 2025 г.
Лицензия
MIT

Опубликован 19 октября 2025 г.

Исходный код

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

Ченджлог

1.6Релиз1.21.9, 1.21.10, 1.21.11 · 21 ноября 2025 г.
  • 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 teleporting on top of them.

Please delete your old config (or rename it to copy your own values to the new config)

1.5Релиз1.21.8, 1.21.9, 1.21.10 · 4 ноября 2025 г.
  • 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 replace your messages with the ones below)

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%)"
1.4Релиз1.21.8, 1.21.9, 1.21.10 · 4 ноября 2025 г.
  • Added bStats
1.4Релиз1.21.6, 1.21.7, 1.21.8 · 1 ноября 2025 г.
  • Revamped config (need to delete old config, sorry :( )
  • Fixed the issue where if a player has multiple cooldown ranks, cooldowns dont work correctly.
  • Added a /rtpreload command to reload config files without restarting the server
  • Added a rtp.use permission (All players have this permission by default, if you dont want players to use rtp, set rtp.use to false manually "/lp group default permission set rtp.use false")
1.3.0Релиз1.21.8, 1.21.9, 1.21.10 · 23 октября 2025 г.
  • Added customizable permission-based cooldowns!

Комментарии

Загружаем…