YuRTP

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.)

📚 Wiki / DOC: WIKI

🎉 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

Admin Commands

Permission Nodes

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.