YuRandomTeleport | Cross-Version · High Performance · Universal Compatibility
Supported Versions: 1.8.x – 1.26.x
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.
  
  
• Active Maintenance & Community
  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
# 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.