YuRandomTeleport 1.2.0.0 Update Notice
From 1.1.2.2 to 1.2.0.0: Safer, More Stable, and Better for Production Servers
Hello server owners,

YuRandomTeleport has been updated to version 1.2.0.0.

This is an important stability and feature update focused on three key goals:

Safer teleportation, easier configuration management, and stronger compatibility.

Server owners currently using 1.1.2.2 or earlier are strongly encouraged to upgrade.

1. Update Highlights
1. Greatly Improved Safe Landing Algorithm
The new version introduces stricter safety checks for random teleport landing locations.

YuRandomTeleport now checks:

• Whether the block under the player is reliable
  
  
• Whether the player’s feet and body space are safe
  
  
• Whether there is enough air above the player
  
  
• Whether nearby blocks include lava, water, fire, cactus, cobweb, portals, magma blocks, or other dangerous blocks
  
  
• Whether the landing block is an unstable surface such as slabs, stairs, fences, carpets, pressure plates, and similar blocks
  
  
• Whether Nether terrain contains narrow caves, dangerous platforms, or floating risks
  

Compared with older versions, 1.2.0.0 greatly reduces the chance of players being teleported into walls, dangerous blocks, lava edges, water caves, or unsafe Nether platforms.

2. New Teleport Countdown and Cancellation System
The new version supports a configurable waiting time before teleportation.

After a player runs /rtp, they can enter a countdown state before the teleport actually happens.
During this waiting period, teleportation can be automatically cancelled if the player:

• Moves
  
  
• Takes damage
  
  
• Interacts
  
  
• Chats
  
  
• Executes commands
  
  
• Goes offline
  

This feature is especially useful for production servers, as it helps prevent players from abusing random teleportation during combat, dangerous situations, or other special scenarios.

New related configuration:

teleport:
wait-seconds: 5
cancel-on-move: true

New permission:

yurtp.bypass.wait

Players with this permission can skip the waiting time.

3. New World Whitelist Mode
Older versions mainly relied on the world blacklist.
The new version adds a world whitelist mode.

If you only want random teleportation to be available in resource worlds, wilderness worlds, or event worlds, you can now use whitelist mode directly.

world-whitelist: []

When the whitelist is not empty, only worlds listed in it will allow random teleportation, and the blacklist will be ignored.

4. Independent Teleport Cost Per World
The new version supports different RTP costs for different worlds.

For example, the main world can be free, the resource world can charge a fee, and the Nether can have its own separate cost.

default:
cost: 0.0

worlds:
resource:
cost: 10.0

Economy support still requires Vault and a compatible economy plugin.

5. New allowed-materials Landing Block Whitelist
In addition to the existing dangerous block blacklist, the new version adds a landing block whitelist.

When allowed-materials is not empty, the plugin will only allow players to land on the specified block types.

This is useful for special server setups, such as:

• Only allowing teleportation onto grass blocks
  
  
• Only allowing teleportation onto stone or dirt
  
  
• Only allowing Nether teleportation onto netherrack, soul sand, basalt, and similar blocks
  
  
• Restricting valid landing blocks in event worlds
  

Wildcard matching with * is supported, for example:

allowed-materials:
- "GRASS_BLOCK"
- "DIRT"
- "*DEEPSLATE*"

6. Upgraded Multi-Language System
The new version includes a built-in language system with support for:

• Simplified Chinese
  
  
• English
  
  
• Custom language files
  
  
• Automatic language selection based on the player’s client language
  

Configuration:

language:
default: en_US
use-player-locale: true

Server owners who want Simplified Chinese as the default language can set:

language:
default: zh_CN

Existing customized Chinese messages from older messages.yml files will be preserved as much as possible.

7. New PlaceholderAPI Support
If PlaceholderAPI is installed on the server, the new version can register %yurtp_*% placeholders.

These placeholders can be used in menus, scoreboards, variable displays, status messages, and other plugin integrations.

Commonly available information includes:

• Plugin version
  
  
• Current platform type
  
  
• Player cooldown time
  
  
• Whether the player is currently teleporting
  
  
• The player’s latest teleport status
  
  
• Latest teleport coordinates
  
  
• Success / failure / cancellation statistics
  

8. New Public Java API and Event System
YuRandomTeleport 1.2.0.0 provides a more complete developer interface for integration with other plugins.

New capabilities include:

• Requesting random teleportation through the API
  
  
• Cancelling an active random teleport
  
  
• Checking a player’s teleport state
  
  
• Checking remaining cooldown time
  
  
• Getting the latest teleport snapshot
  
  
• Tracking success, failure, and cancellation statistics
  

New teleport lifecycle events include:

• Random teleport start event
  
  
• Target location confirmation event
  
  
• Teleport cancellation event
  
  
• Teleport completion event
  

This is useful for menu plugins, quest plugins, event systems, permission plugins, or custom server-side systems.

9. Improved Folia / Paper Compatibility
The new version includes a platform scheduler layer supporting:

• Bukkit / Spigot standard scheduling
  
  
• Paper async teleportation
  
  
• Folia Entity Scheduler
  
  
• Folia Region Scheduler
  
  
• Folia Global Scheduler
  

This means YuRandomTeleport 1.2.0.0 should perform more reliably on Folia and other newer server architectures.

10. Improved Configuration Upgrade Experience
The new version introduces smart configuration update logic.

During upgrades, the plugin will try to:

• Automatically add missing new configuration nodes
  
  
• Preserve existing configuration values
  
  
• Preserve existing comments and formatting
  
  
• Avoid escaping Chinese characters
  
  
• Automatically back up and rebuild broken configuration files
  
  
• Fix YAML reading issues caused by characters incompatible with older server versions
  

However, server owners are still advised to manually back up the following before upgrading:

plugins/YuRandomTeleport/config.yml
plugins/YuRandomTeleport/messages.yml
plugins/YuRandomTeleport/lang/

2. Upgrade Recommendation
Recommended Upgrade Steps

1. Stop the server.
   
   
2. Back up the plugins/YuRandomTeleport/ folder.
   
   
3. Remove the old jar and place YuRandomTeleport-1.2.0.0.jar into the plugins folder.
   
   
4. Start the server and let the plugin automatically add the new configuration options.
   
   
5. Check the new language, waiting, whitelist, and landing block whitelist settings in config.yml.
   
   
6. If you want Simplified Chinese as the default language, set:
   

language:
default: zh_CN

1. Run /yurtp reload to reload the configuration, or restart the server.
   

3. Configuration Items to Check After Upgrading
After upgrading, it is recommended to check the following configuration sections:

language:
default: zh_CN
use-player-locale: true

teleport:
wait-seconds: 5
cancel-on-move: true

world-whitelist: []

default:
cost: 0.0
safety:
allowed-materials: []

If your server only allows RTP in a resource world, whitelist mode is recommended:

world-whitelist:
- resource

4. Servers That Should Upgrade First
If your server has experienced any of the following issues, upgrading to 1.2.0.0 is strongly recommended:

• Players occasionally getting stuck in walls after random teleportation
  
  
• Unstable Nether random teleportation
  
  
• Players landing in water, near lava, or beside dangerous blocks
  
  
• Need for a teleport countdown
  
  
• Need to cancel teleportation when players move or take damage
  
  
• Need to set different costs for different worlds
  
  
• Need integration with menus, placeholders, quests, or other plugins
  
  
• Running Folia / Paper / hybrid server software
  

5. Summary
YuRandomTeleport 1.2.0.0 is not just a small patch.
It is a stability-focused upgrade designed for real production server usage.

This update makes random teleportation safer, more controllable, and easier for server owners to customize based on their gameplay needs.

All users running 1.1.2.2 or earlier are recommended to upgrade.

YuRandomTeleport
Let players explore with confidence. Let server owners worry less.