YuRTP

YuRandomTeleport | Cross-Version · High Performance · Universal Compatibility

Compatible Server Types: Spigot / Paper / All Hybrid Forks (Mohist, Magma, Arclight, etc.) Compatible Server Types: Spigot / Paper / All Hybrid Forks (Mohist, Magma, Arclight, etc.)

---

🎉 Promotional Text

✦ Escape the Crowd. Explore the Unknown. — YuRandomTeleport

Tired of overcrowded spawn points? Struggling to find untouched, pristine land? YuRandomTeleport is an intelligent random teleportation plugin built for Minecraft servers, delivering a safe, smooth, and highly customizable teleport experience.

✨ Why Choose YuRandomTeleport?

- Ultimate Cross-Version Compatibility From 1.8 to the latest 1.26.x, it runs seamlessly on Spigot, Paper, and all hybrid server forks—one plugin for every version.

- Smart & Safe Location Algorithm Automatically avoids lava, cacti, the void, fire, and other hazardous blocks. Players always land on solid ground with open sky above—safe upon arrival.

- Granular Per‑World Configuration Each world can have independent radius, height limits, safety rules, and blocked material lists. Perfectly tailored for Overworld, Nether, and End dimensions.

- Seamless Economy & Cooldown Integration Supports Vault economy deductions and customizable cooldowns. Granular permission nodes keep everything under control and prevent abuse.

- Programmable Command Hooks Execute custom commands (including JSON titles and particle effects) before and after teleportation, taking your server’s interactivity to the next level.

- Zero‑Fuss, Out‑of‑the‑Box Default configurations work immediately. No complex setup required—even novice server admins can deploy it effortlessly.

- 1080918424 The plugin is under continuous development. Join our official community 1080918424 to report issues, request features, or just chat with fellow admins.

🚀 Join Us

Official Community Group: 1080918424 Bug Reports · Update Announcements · Tech Support · Customization Inquiries

---

📖 User Manual

1. Installation Guide

1. Place `YuRandomTeleport-<version>.jar` into your server's `plugins` folder. 2. Restart the server or load the plugin using a plugin manager. 3. The plugin will automatically generate `config.yml` and `messages.yml` inside `plugins/YuRandomTeleport/`. 4. (Optional) Edit the configuration files as desired and apply changes with `/yurtp reload`.

2. Commands & Permissions

Player Commands

| Command | Description | Permission | |---------|-------------|------------| | `/yurtp` or `/rtp` | Randomly teleports yourself within your current world. | `yurtp.use` | | `/yurtp <player>` | Randomly teleports the specified player within their current world (requires permission). | `yurtp.teleport.others` | | `/yurtp <player> <world>` | Randomly teleports the specified player to the specified world (requires permission). | `yurtp.teleport.others` | | `/yurtp help` | Displays the help menu. | None |

Admin Commands

| Command | Description | Permission | |---------|-------------|------------| | `/yurtp reload` | Reloads the configuration files (`config.yml` and `messages.yml`). | `yurtp.reload` |

Permission Nodes

| Permission | Default | Description | |------------|---------|-------------| | `yurtp.use` | Everyone | Allows use of random teleport. | | `yurtp.teleport.others` | OP | Allows teleporting other players. | | `yurtp.bypass.cooldown` | OP | Bypasses the cooldown timer. | | `yurtp.bypass.cost` | OP | Bypasses economy charges. | | `yurtp.reload` | OP | Allows reloading the plugin configuration. |

3. Configuration Quick Reference

Core Options in `config.yml`

```yaml

Economy settings (requires Vault)

economy: enabled: false cost: 0.0

Cooldown in seconds

cooldown: seconds: 3

Worlds where teleportation is forbidden

world-blacklist: - lobby

Default parameters (inherited by all worlds unless overridden)

default: radius: min: 500 max: 2000 height: min: -64 # Leave blank to auto-detect from world max: 320 safety: check: true allow-void: false allow-water: false allow-lava: false max-attempts: 32 min-air-above: 8 blocked-materials: - "MAGMA*" - "CACTUS" - "SWEET_BERRY_BUSH" - "COBWEB" - "*FIRE*"

Per‑world overrides

worlds: world_nether: radius: min: 200 max: 800 safety: allow-lava: true

Custom commands to execute (supports placeholders: {player}, {x}, {z}, etc.)

commands: on-teleport: - "title {player} title {"text":"Searching for a safe location...","color":"yellow"}" on-success: - "title {player} title {"text":"Teleport Successful!","color":"green"}" on-fail: - "title {player} title {"text":"Teleport Failed","color":"red"}" ```

Notes on `messages.yml`

All frontend messages support color codes (`&` in place of `§`) and can be fully translated or customized. After editing, run `/yurtp reload` to apply changes.

4. Frequently Asked Questions

Q: Why can't a player teleport? A: Verify that the world is not listed in `world-blacklist`, the player has the `yurtp.use` permission, and cooldown/balance requirements are met.

Q: The teleport locations aren't ideal. How can I improve them? A: Adjust the `radius` range, `height` limits, or relax the `blocked-materials` rules for the specific world. Enable `debug: true` in the config to view detailed location‑search logs in the console.

Q: Does the plugin support sounds on 1.8? A: Yes. A built‑in cross‑version sound compatibility layer ensures sounds work across all supported versions without errors or silence.

Q: Is Moonrise asynchronous server supported? A: Moonrise is not currently supported due to conflicts between its asynchronous architecture and some core plugin logic. We will evaluate potential compatibility in future updates.

5. Community & Support

- QQ Group: 1080918424 Bug reports · Feature suggestions · Update notifications · Technical discussions

- Documentation & Updates The latest version and detailed documentation are always available within the community group.

---

YuRandomTeleport — Every journey begins with anticipation.