🌍 YuRandomTeleport Random Teleport Plugin

🛡️ Safe Landing · 🚀 Powerful Compatibility · 🌐 Multi-Language · 🔌 API Integration · ⚡ Folia Support

Still worried that random teleportation might throw players into lava, walls, underwater caves, Nether cliffs, or dangerous blocks? 🔥🌋
Still manually maintaining teleport points just to spread players across resource worlds, survival maps, or wilderness areas? 🗺️⛏️

YuRandomTeleport is a high-performance, highly compatible random teleport plugin designed for Minecraft Java servers.
It does more than simply generate random coordinates — it focuses on sending players to locations that are truly safe, stable, and controllable.

🎯 Wide Compatibility · One Plugin for the Mainstream Server Ecosystem

✅ Tested Minecraft Versions

📦 Vanilla Protocol Compatibility Range

Minecraft 1.8.x ～ 1.26.x+

Tested and verified across multiple mainstream server versions:

✅ 1.8.x
✅ 1.9.x
✅ 1.10.x
✅ 1.11.x
✅ 1.12.x
✅ 1.13.x
✅ 1.14.x
✅ 1.15.x
✅ 1.16.x
✅ 1.17.x
✅ 1.18.x
✅ 1.19.x
✅ 1.20.x
✅ 1.21.x
✅ 1.22.x
✅ 1.23.x
✅ 1.24.x
✅ 1.25.x
✅ 1.26.x

Whether you are running a classic legacy server or a newer Minecraft version, YuRandomTeleport is built to provide a smooth compatibility experience.

🖥️ Supported Server Software

🟢 Bukkit-Based Servers

✅ CraftBukkit
✅ Spigot

⚡ Paper-Based Servers

✅ Paper
✅ Purpur
✅ Leaves

✅ Folia
✅ Most Paper forks

Supported scheduler systems:

• Region Scheduler
• Entity Scheduler
• Global Scheduler
• Native Folia scheduling logic

YuRandomTeleport includes dedicated Folia adaptation, not just basic compatibility.

🔥 Hybrid Servers

✅ Mohist
✅ Arclight
✅ Youer
✅ CatServer
✅ NeoForge / Fabric / Forge hybrid compatibility environments

🌟 Other Compatible Cores

✅ Most server cores that follow the Bukkit / Spigot / Paper API ecosystem

✨ Why Choose YuRandomTeleport?

🛡️ Stricter Safe Landing Algorithm

YuRandomTeleport checks:

✅ The block under the player
✅ The player’s body space
✅ The space above the player
✅ Nearby dangerous environments

It avoids, as much as possible:

🔥 Lava
🌊 Water
🔥 Fire
🌵 Cactus
🕸️ Cobweb
♨️ Magma blocks
🌀 Portals
🕳️ Void
⚠️ And many other dangerous blocks

For complex dimensions such as the Nether, YuRandomTeleport performs safety scanning better suited for caves and platform-like terrain, further reducing the chance of:

❌ Getting stuck in walls
❌ Being teleported into the air
❌ Falling into lava
❌ Landing on dangerous edges

🧭 Independent Per-World Configuration

Different worlds can have completely different RTP rules:

🌍 Independent teleport radius
📏 Independent height limits
💰 Independent teleport cost
🛡️ Independent safety rules
🚫 Independent blocked landing blocks
✅ Independent allowed landing blocks

Overworld, Nether, End, resource worlds, and event worlds can all be managed separately.

⏳ Teleport Countdown and Action Cancellation

YuRandomTeleport supports a waiting period before teleportation.

During the waiting period, teleportation can be automatically cancelled if the player:

🚶 Moves
⚔️ Takes damage
🖱️ Interacts
💬 Chats
⌨️ Executes commands

This helps reduce:

❌ Escaping from combat
❌ Abusing RTP to avoid danger
❌ RTP abuse in PvP scenarios

A permission bypass is also available for players who should skip the waiting time.

💰 Vault Economy Support

YuRandomTeleport supports Vault-based economy systems.

You can easily create:

💵 Paid RTP
💎 Free teleportation for VIP players
🌍 Paid teleportation in resource worlds
🎉 Restricted event-world teleportation

Flexible enough to fit different server economy setups.

🌍 World Blacklist / Whitelist

Supports both:

✅ World whitelist mode
✅ World blacklist mode

You can:

🏰 Disable RTP in lobby worlds
🏙️ Disable RTP in spawn cities
⚔️ Disable RTP in dungeon worlds
🌲 Allow RTP only in resource worlds

World control becomes simple and intuitive.

🌐 Multi-Language System

Built-in languages:

🇨🇳 Simplified Chinese
🇺🇸 English

Supports:

✅ Automatic player client language detection
✅ Custom language files
✅ Multi-language server deployment

YuRandomTeleport is also suitable for international servers.

🔌 PlaceholderAPI + Java API + Event System

YuRandomTeleport provides powerful extension capabilities:

✅ PlaceholderAPI placeholders
✅ Java API
✅ Lifecycle events

It can be deeply integrated with:

📋 Menu plugins
🎯 Quest plugins
📊 Statistics plugins
🏆 Achievement plugins
⚙️ Custom server plugins

⚙️ Smart Folia / Paper / Spigot Scheduler Compatibility

The plugin includes a built-in cross-platform scheduler compatibility layer.

Supported systems:

✅ Bukkit Scheduler
✅ Spigot Scheduler
✅ Paper Async Teleport
✅ Folia Region Scheduler
✅ Folia Entity Scheduler
✅ Folia Global Scheduler

Whether your server runs on:

🟢 Spigot
⚡ Paper
🚀 Purpur
🍃 Leaves
🔥 Folia
🔧 Mohist
🔨 Arclight
🌟 Youer

YuRandomTeleport is designed to provide stable and reliable performance.

🧩 Smart Configuration Upgrade

When upgrading the plugin, YuRandomTeleport can automatically:

✅ Add missing configuration nodes
✅ Preserve existing configuration values as much as possible
✅ Preserve comments and formatting as much as possible
✅ Back up configuration files automatically
✅ Recover abnormal or broken configurations automatically

Plugin upgrades become easier and safer.

📌 Suitable For These Servers

✅ Survival servers
✅ Casual survival servers
✅ RPG large-map servers
✅ Resource-world servers
✅ Slimefun servers
✅ Skyblock servers
✅ Sandbox / box-world servers
✅ Event-world servers
✅ Hybrid servers
✅ High-performance Folia servers
✅ Paper / Purpur ecosystem servers
✅ Any server that needs safe random teleportation

🚀 Command Overview

👤 Player Commands

🔹 /rtp or /yurtp
➡️ Randomly teleport yourself

🔹 /yurtp <player>
➡️ Randomly teleport a specified player

🔹 /yurtp <player> <world>
➡️ Randomly teleport a specified player to a specified world

🛠️ Admin Commands

🔹 /yurtp reload
➡️ Reload configuration and language files

⚙️ Simple Configuration Example With Comments

# Default language
language:
  default: en_US
  # Whether to automatically switch language based on the player's client language
  use-player-locale: true

# Economy system, requires Vault
economy:
  enabled: true
  # Cost for each random teleport
  cost: 100.0

# Cooldown time, in seconds
cooldown:
  seconds: 30

# Teleport waiting settings
teleport:
  # Waiting time before teleportation
  wait-seconds: 5

  # Cancel teleportation when the player moves
  cancel-on-move: true

  # Cancel teleportation when the player takes damage
  cancel-on-damage: true

# World blacklist
world-blacklist:
  - lobby
  - spawn

# World whitelist, leave empty to disable
world-whitelist: []

# Default settings inherited by all worlds
default:

  # Random teleport range
  radius:
    min: 500
    max: 5000

  # Height limits
  height:
    min: -64
    max: 320

  # Safety checks
  safety:
    check: true

    # Whether teleporting into the void is allowed
    allow-void: false

    # Whether landing in water is allowed
    allow-water: false

    # Whether landing in lava is allowed
    allow-lava: false

    # Maximum search attempts
    max-attempts: 64

    # Minimum air blocks required above the player
    min-air-above: 2

    # Allowed landing blocks, leave empty for no restriction
    allowed-materials: []

    # Blocked landing blocks
    blocked-materials:
      - "CACTUS"
      - "MAGMA*"
      - "*FIRE*"
      - "COBWEB"
      - "SWEET_BERRY_BUSH"

# Per-world configuration
worlds:

  # Nether example
  world_nether:

    radius:
      min: 300
      max: 1500

    safety:
      # Detect and avoid unsafe lava-side platforms in the Nether
      allow-lava: false

  # Resource world example
  resource:

    # Independent cost
    cost: 500.0

    radius:
      min: 1000
      max: 10000

# Commands executed during teleportation
commands:

  # When teleportation starts
  on-teleport:
    - "title {player} title {\"text\":\"Searching for a safe location...\",\"color\":\"yellow\"}"

  # When teleportation succeeds
  on-success:
    - "title {player} title {\"text\":\"Teleport successful!\",\"color\":\"green\"}"

  # When teleportation fails
  on-fail:
    - "title {player} title {\"text\":\"No safe location found\",\"color\":\"red\"}"

🔗 Official Links

📚 Plugin Documentation: https://vicuna-main.github.io/YuPluginHub/

📦 Modrinth Download Page: https://modrinth.com/plugin/yurandomteleport

🐞 Issue Tracker: https://github.com/Vicuna-main/YuRandomTeleport/issues

💬 Official QQ Group: 1080918424

🌟 YuRandomTeleport

🚀 More than random coordinates — every journey starts with a safer, smarter, and more stable algorithm.

🛡️ Safe random teleportation starts here.

🌍 One plugin, built to cover the mainstream Bukkit / Paper / Folia / hybrid server ecosystem as much as possible.

⚡ Supports Minecraft 1.8.x ～ 1.26.x, designed for highly compatible and high-performance servers.