!Servers !Players

🌍 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: /plugins/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.