Описание
# 🎲 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
```yaml
# === 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: "Select a World to Teleport"
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: "Overworld"
lore:
- "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: "Nether"
lore:
- "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: "The End"
lore:
- "Click to teleport randomly in the End!"
cooldown:
default:
cooldown: 180
# This is the default cooldown if players don't
# have any rtp.cooldown. 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: "Teleported to a random location in the %world%!"
cooldown: "You must wait %time%s before using RTP again!"
countdown: "Teleporting in %countdown%s..."
cancel-move: "Teleport cancelled because you moved!"
cancel-damage: "Teleport cancelled because you took damage!"
no-permission: "You have no permission to use /rtp reload!"
scanning: "Scanning for a safe teleport location. (Attempt#%attempt%)"
```
**Ready to give your players the gift of the unknown? Install RTP today!**