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.