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.