Перейти к содержимому
Mineforgian

YuTeleport

Fancy Teleport Pulgin.Compatible Server Types: Spigot / Paper / Folia / Purpur / Leaves / All Hybrid Forks (Mohist, Magma, Arclight, Youer, etc.)

Загрузки
298
Подписчики
0
Обновлён
9 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 15 апреля 2026 г.

🎲 YuTeleport / YuTP – Cross-Version Safe Teleport Plugin

🛡️ Safe Landing | 🧭 Random Teleport | 📍 Warp | 🏠 Home | 🤝 TPA | 🔙 Back | 📡 Coordinate Sharing | 🧵 Folia Support

😱 Worried that random teleport might drop players into lava, underwater, inside blocks, at the void edge, or onto dangerous platforms in the Nether?
🧭 Want to manage resource‑world scatter points, public waypoints, player homes, TPA, /back, and coordinate sharing all in one plugin?
🐌 Don't want traditional teleport plugins to lag the main thread while searching for chunks, nor maintain cooldowns, costs, permissions, and messages separately?
🔧 Don't want multiple plugins fighting over /warp, /home, /tpa, /back, and having to debug conflicts one by one?

YuTeleport (YuTP) is a cross‑version, safe teleport suite for Minecraft Java servers.
It is not just a single RTP tool, but a complete teleport system: random teleport, public warps, player homes, TPA‑based mutual teleport, /back return, coordinate sharing, economy integration, permission groups, PlaceholderAPI, a public Java API, Folia/Paper compatibility – all processed through the same teleport pipeline.

Current version: 2.0.1.2
Config version: config‑version 20


🚀 Core Features

  • 🧭 Random Teleport (RTP): Per‑world configuration for radius, height range, center point, square/circle distribution, block rules, and biome filtering.
  • 📍 Warp (Public Waypoints): Supports public, private, and restricted types; includes description, rename, delete, max amount limits, and fine‑grained permissions.
  • 🏠 Home (Player Homes): Each player saves homes independently; supports multiple homes, public homes, cross‑player access, descriptions, and quantity expansion.
  • 🤝 TPA (Player‑to‑Player Teleport): Supports /tpa, /tpahere, accept, deny, cancel, ignore requests, and global tpahere.
  • 🔙 Back (Return System): Records death points, pre‑teleport locations from plugin teleports, and external teleport origins; supports /back, /back death, /back list, /back clear.
  • 📡 Coordinate Sharing: After a successful teleport, players can share their current location to all online players; others can click to teleport.
  • 🧩 Unified Teleport Pipeline: All handling – wait, interrupt, cooldown, cost deduction, refund, safety re‑check, events, status tracking, and hooks – is processed uniformly.
  • Asynchronous Safe‑Point Search: On Paper 1.13+ can use async chunk loading to reduce main‑thread stress; falls back to sync mode automatically when unsupported.
  • 📦 Landing‑Point Pre‑caching: Background preparation of safe landing points; when cache is hit, online search wait time is reduced.
  • 🌿 Biome Filtering: Supports black/whitelists, * wildcards, and single‑use biome:<pattern> specification.
  • 💰 Vault / PlayerPoints Economy: Prices are set per teleport type, per world, and per permission group; failed, cancelled, or Folia‑retired scenarios automatically refund.
  • 👥 Permission Group Overrides: Use yuteleport.group.<group> to configure different cooldowns, costs, warp limits, and home limits per group.
  • Multi‑Channel Countdown: Chat, BossBar, ActionBar, or silent wait – freely combinable; move, damage, interact, chat, and command interruptions can be toggled individually.
  • 🎵 Full Audio‑Visual Feedback: Countdown sounds, success arpeggios, fail/cancel/cost/refund sounds, titles, particles, click‑to‑retry, and hover coordinates.
  • 📊 PlaceholderAPI Extension: Provides module states, cooldowns, costs, home/warp counts, teleport stats, and back status.
  • 🧑‍💻 Java API & Events: External plugins can initiate teleports, read module data, listen to and cancel teleport lifecycle events.
  • 🧵 Folia Scheduling Adaptation: Uses Region / Entity / Global Schedulers to avoid cross‑region entity access issues.

🧠 Design Philosophy

YuTeleport's goal is not merely to "move a player", but to make every teleport request controllable, rollback‑able, and observable – from request to arrival.

  • Does the player have permission?
  • Is the target world allowed?
  • Is the cooldown active?
  • Does a countdown need to be waited?
  • During the countdown, did the player move, take damage, chat, or execute commands?
  • Is a cost required? How to handle balance changes during the wait?
  • Is the target point safe? Is the target world still loaded?
  • Should the cost be refunded on failure, cancellation, or entity retirement?
  • Can third‑party plugins listen to, cancel, or read the result?
  • Can the player return to their death point or previous location before teleport?

These logic pieces are no longer scattered across multiple plugins or modules; they are handled by the unified teleport pipeline. Server owners can use it as the foundational teleport system for production servers, not just a temporary scatter tool.


🧩 Feature Modules

🧭 Random Teleport (RTP)

Ideal for resource worlds, wilderness exploration, new player spawning, event maps, and servers that need to reduce spawn crowding.

  • Each world has independent radius, cost, height range, safety rules, and search strategy.
  • Customizable random center, not fixed to (0, 0).
  • Supports square ring or circular ring distributed by area.
  • World black/whitelist with * wildcard support.
  • Block black/whitelist – exclude lava, fire, cactus, sweet berry bushes, cobwebs, etc.
  • Biome black/whitelist – e.g., *OCEAN*, *FOREST*.
  • Supports Paper async chunk loading, Folia region scheduling, and sync fallback.
  • Background safe‑landing pre‑caching to reduce online search overhead for high‑frequency teleports.

Common commands:

/yuteleport
/ytp
/rtp
/yuteleport biome:*FOREST*
/yuteleport <player>
/yuteleport <player> <world> biome:*PLAINS*

📍 Warp (Public Waypoints)

Suitable for spawns, resource world entrances, event venues, shopping districts, dungeon entrances, and player‑built public points.

  • /setwarp <name> to create or update a warp.
  • public warps are visible and usable by all players.
  • private warps are manageable only by the creator and admins.
  • restricted warps require yuteleport.warps.<name> to be visible and usable.
  • Supports description, rename, public/unpublic, and deletion.
  • Default limit, permission‑based limit, and groups.<group>.warp.max‑warps for expansion.
  • Exceeding the limit after permission expiry locks the warp temporarily; re‑granting permission restores access.
  • Create‑public, use‑public, and normal warp teleports can each have separate costs.

Common commands:

/warp
/warp <name>
/warp public
/warp public <name> true
/warp rename <old> <new>
/warp desc <name> <description>
/setwarp <name> [restricted|public|private] [description]
/delwarp <name>

🏠 Home (Player Homes)

Suitable for survival, retirement, RPG, skyblock, and servers where players need to manage their own return points.

  • /sethome [name] sets a personal home; default name is home.
  • /homes lists your own homes.
  • Players can make homes public; other online players can view and teleport to them.
  • Each home can have a description.
  • Supports rename, description change, public/unpublic, and deletion.
  • Admins can view or use online players' homes.
  • Default home limit, permission‑based limit, and groups.<group>.home.max‑homes for expansion.
  • Excess homes after permission expiry are locked temporarily.
  • Worlds where home setting is forbidden can be configured (e.g., event worlds, mining worlds).
  • Each player's homes are saved in individual files; loaded on join, unloaded on quit.

Common commands:

/home
/home <name>
/home list
/home public
/home public <name> true
/home rename <old> <new>
/home desc <name> <description>
/home <player>:<name>
/homes
/homes <player>
/sethome [name] [public|private] [description]
/delhome <name>
/delhome <player>:<name>

🤝 TPA (Player‑to‑Player Teleport)

Ideal for player visits, team exploration, event gatherings, and regular survival servers.

  • /tpa <player> – request to teleport to that player.
  • /tpahere <player> – request that player to teleport to you.
  • /tpaccept [player] – accept a request.
  • /tpdeny [player] – deny a request.
  • /tpacancel – cancel your outgoing request.
  • /tpaignore – temporarily ignore incoming TPA requests.
  • /tpaall or /tpahere all – send a tpahere request to all online players.
  • Requests expire automatically; send again if expired.
  • New request replaces your last outgoing request to avoid an endless request book.
  • Target player receives clickable accept/deny buttons.
  • In tpahere, the receiver is moved, but cost and cooldown belong to the requester.

Common commands:

/tpa <player>
/tpahere <player>
/tpahere all
/tpaccept [player]
/tpdeny [player]
/tpacancel
/tpaignore
/tpaall

🔙 Back Return System

/back is suitable for death recovery, rollback after accidental teleport, and returning to the original location after cross‑plugin teleportation.

  • /back – returns to the most recent available location.
  • /back death – returns to the last death point.
  • /back list – shows the return history; with interactive chat enabled, click any record to teleport.
  • /back clear – clears your own back history.
  • Records pre‑teleport positions from internal plugin teleports, player death points, and pre‑teleport positions from external plugins.
  • Filters by distance – moves less than the threshold (default 3 blocks) are not recorded to prevent spam.
  • Configurable maximum history size (default 5).
  • Configurable expiry time (default 1800 seconds).
  • Persistent storage – back history saved to data/back.
  • Independent warm‑up, cooldown, cost, safety rescue, world black/whitelist, and hooks.
  • Priority configuration – default prefers death points first, then plugin pre‑teleport, then external pre‑teleport.

Common commands:

/back
/back death
/back list
/back clear

Core configuration:

teleports:
  back:
    enabled: true
    commands:
      back: [back]
    warmup-seconds: 5
    cooldown-seconds: 10
    cost: 0.0
    safety-rescue: true
    max-history: 5
    expire-seconds: 1800
    persist: true
    capture:
      plugin-teleports: true
      death: true
      external-teleports: true
      include-types: [random, warp, home, tpa, share, back]
      min-distance: 3.0
    priority: [death, teleport, external]

📡 Coordinate Sharing

Ideal for temporary rally points, resource discoveries, event coordinates, team gatherings, and exploration sharing.

After a successful teleport, the success message can include a "Share Current Location" button. Clicking it broadcasts the coordinate share to all online players, who can click to teleport.

  • Shares have an expiry time; they are automatically invalid after expiry.
  • Shares have their own cooldown.
  • Maximum number of active shares in memory to prevent long‑term buildup.
  • Sharing and teleporting via share can be separately charged.
  • Coordinate sharing inherits or individually configures world black/whitelist.

Common commands:

/yuteleport share
/yuteleport join <share_id>

🛡️ Safe Landing & Rescue

YuTeleport checks the following before a random teleport:

  • Is the block below the player solid enough?
  • Is there enough space for the player's body and head?
  • Is the extra headroom above meeting the configuration?
  • Dangerous blocks: water, lava, fire, cactus, cobwebs, magma blocks, etc.
  • Void, world min/max height, world border.
  • Biome black/whitelist.
  • Vertical candidate positions in complex dimensions like the Nether.

This reduces the risk of:

  • Players stuck inside blocks or walls.
  • Landing in lava, underwater, or hazardous blocks.
  • Teleporting outside the world border or exactly on the border.
  • Landing at the void edge or floating in the air.
  • Nether random landing on a platform without a solid foothold.

Fixed‑point modules (warp, home, tpa, share, back) respect the stored coordinates by default and do not force a new random safe‑point search. If you worry about points being broken, enable safety-rescue for that module to perform a stuck‑rescue after arrival.


🌍 World Access & Per‑Module Configuration

YuTeleport supports a global default world‑access rule, which can be overridden per module:

teleports.defaults.world-access
teleports.rtp.world-access
teleports.warp.world-access
teleports.home.world-access
teleports.tpa.world-access
teleports.share.world-access
teleports.back.world-access

World lists support * wildcards:

lobby
resource_*
*_nether
*event*
*

Typical use cases:

  • Overworld: moderate radius, low cost, exclude oceans.
  • Resource world: huge radius, high cost, enable async search and pre‑caching.
  • Nether: restrict height, increase attempts, set allowed‑block whitelist.
  • Event worlds: allow only specific modules or block entirely.
  • Lobby world: disable /back or all player‑initiated teleports.

⚡ Async Search & Pre‑caching

Traditional RTP sync‑loads new chunks during teleport, causing lag during peak times. YuTeleport offers two optimizations.

Asynchronous Safe‑Point Search

teleports:
  rtp:
    search-mode: async

On Paper 1.13+ and compatible cores, the plugin uses async chunk loading to find random landing points. If the current server does not support it, it automatically falls back to sync mode and logs a hint. On Folia, the plugin respects the region‑scheduling model and does not rely on traditional main‑thread assumptions.

Landing‑Point Pre‑caching

teleports:
  rtp:
    precache:
      enabled: true
      size: 3

The plugin can pre‑generate 1–16 safe landing points per world in the background. When a player requests random teleport and the cache is hit, the online search phase is skipped – only final verification and the remaining pipeline are executed.


⏳ Countdown, Interruptions & Feedback

All teleport modules can use the unified wait countdown.

teleports:
  defaults:
    warmup-seconds: 5
    countdown-display: actionbar
    cancel-on-move: true
    cancel-triggers:
      move: true
      damage: true
      interact: true
      chat: true
      command: true

Display channels:

  • Chat
  • BossBar
  • ActionBar
  • Silent wait

Interruption conditions:

  • Move
  • Damage
  • Interact
  • Chat
  • Execute command

Players with yuteleport.bypass.wait skip the wait.
Players with yuteleport.bypass.cooldown skip cooldowns.
Players with yuteleport.bypass.cost skip costs.


💰 Economy System

economy:
  enabled: true
  provider: vault # vault or playerpoints

Features:

  • Vault coin economy.
  • PlayerPoints currency economy.
  • RTP priced per world.
  • Warp / Home / TPA / Share / Back priced per module.
  • Permission‑group cost overrides.
  • Insufficient balance notification.
  • Second balance check after the wait ends.
  • Automatic refund on failure, cancellation, or Folia retirement.
  • Duplicate teleport protection to avoid double charges.

PlayerPoints uses integer currency; costs are rounded up, and refunds follow the same rounding logic.


👥 Permission Group Overrides

groups:
  vip:
    rtp:
      cooldown-seconds: 10
      cost: 5.0
    warp:
      cooldown-seconds: 2
      max-warps: 40
    home:
      cooldown-seconds: 2
      max-homes: 20
    tpa:
      cooldown-seconds: 5
      cost: 0.25
  mvp:
    rtp:
      cooldown-seconds: 0
      cost: 0.0
    warp:
      cooldown-seconds: 0
      cost: 0.0
      max-warps: 100
    home:
      cooldown-seconds: 0
      cost: 0.0
      max-homes: 50
    tpa:
      cooldown-seconds: 0
      cost: 0.0

Players with the permission yuteleport.group.vip or yuteleport.group.mvp automatically receive the corresponding configuration. If multiple groups match, the first one in the config file order is applied.

Examples:

  • Default players get standard cooldowns and costs.
  • VIP players get reduced cooldowns and more homes/warps.
  • MVP players have no cooldowns and free teleports.
  • Temporary discounts for a group during events.

🧰 Command Overview

RTP

/yuteleport
/ytp
/rtp
/yuteleport biome:<pattern>
/yuteleport <player>
/yuteleport <player> <world>
/yuteleport <player> <world> biome:<pattern>
/yuteleport reload
/yuteleport help

Warp

/warp
/warp <name>
/warp public
/warp public <name> true
/warp rename <old> <new>
/warp desc <name> <description>
/setwarp <name> [restricted|public|private] [description]
/delwarp <name>

Home

/home
/home <name>
/home list
/home public
/home public <name> true
/home rename <old> <new>
/home desc <name> <description>
/home <player>:<name>
/homes
/homes <player>
/sethome [name] [public|private] [description]
/delhome <name>
/delhome <player>:<name>

TPA

/tpa <player>
/tpahere <player>
/tpahere all
/tpaccept [player]
/tpdeny [player]
/tpacancel
/tpaignore
/tpaall

Back

/back
/back death
/back list
/back clear

Coordinate Sharing

/yuteleport share
/yuteleport join <share_id>

Command names and aliases can be changed in the configuration. When a module is disabled, its commands are not registered, avoiding unnecessary conflicts with plugins like EssentialsX or CMI.


🔑 Permission Quick Reference

Permission Description Default
yuteleport.use Use random teleport Everyone
yuteleport.biome Use biome:<pattern> to specify target biome OP
yuteleport.teleport.others Teleport other players via main command OP
yuteleport.reload Reload configuration OP
yuteleport.warp.use Use warps Everyone
yuteleport.warp.set Create or update a warp Everyone
yuteleport.warp.delete Delete your own warp Everyone
yuteleport.warp.public Make your warp public or unpublic Everyone
yuteleport.warp.admin Edit/delete all players' warps OP
yuteleport.warp.limit.<number> Increase warp limit dynamically Assigned by permission plugin
yuteleport.warp.limit.unlimited Unlimited warp count Assigned by permission plugin
yuteleport.warp.limit.bypass Ignore warp limit expiry lock OP
yuteleport.warps.<name> Use the specified restricted warp OP
yuteleport.home.use Use homes and view your own homes Everyone
yuteleport.home.set Create or update a home Everyone
yuteleport.home.delete Delete a home Everyone
yuteleport.home.others View or use online players' homes OP
yuteleport.home.public Make your home public or unpublic Everyone
yuteleport.home.limit.<number> Increase home limit dynamically Assigned by permission plugin
yuteleport.home.limit.unlimited Unlimited home count Assigned by permission plugin
yuteleport.home.limit.bypass Ignore home limit expiry lock OP
yuteleport.tpa.use Use tpa, tpaccept, tpdeny, tpacancel Everyone
yuteleport.tpa.here Use tpahere Everyone
yuteleport.tpa.ignore Ignore incoming TPA requests Everyone
yuteleport.tpa.all Send tpahere to all online players OP
yuteleport.share Share current location after successful teleport Everyone
yuteleport.back.use Use /back Everyone
yuteleport.back.death Use /back death Everyone
yuteleport.back.clear Clear your own back history Everyone
yuteleport.back.admin Reserved admin permission for back OP
yuteleport.bypass.cooldown Skip teleport cooldowns OP
yuteleport.bypass.cooldown.others Ignore target cooldown when admin‑teleporting others OP
yuteleport.bypass.cost Skip teleport costs OP
yuteleport.bypass.wait Skip wait countdown OP
yuteleport.group.<group> Apply the corresponding group configuration Assigned by permission plugin

📊 PlaceholderAPI, Java API & Events

After PlaceholderAPI is installed, you can use %yuteleport_*% placeholders.

Common examples:

%yuteleport_version%
%yuteleport_platform%
%yuteleport_search_mode%
%yuteleport_random_enabled%
%yuteleport_warp_enabled%
%yuteleport_home_enabled%
%yuteleport_tpa_enabled%
%yuteleport_share_enabled%
%yuteleport_back_enabled%
%yuteleport_cooldown_random%
%yuteleport_cooldown_warp%
%yuteleport_cooldown_home%
%yuteleport_cooldown_tpa%
%yuteleport_cooldown_share%
%yuteleport_cooldown_back%
%yuteleport_cost_random%
%yuteleport_cost_warp%
%yuteleport_cost_home%
%yuteleport_cost_tpa%
%yuteleport_cost_share%
%yuteleport_cost_back%
%yuteleport_home_count%
%yuteleport_home_max%
%yuteleport_visible_warp_count%
%yuteleport_tpa_pending_count%
%yuteleport_success_rate%

Useful for:

  • Scoreboards
  • TAB lists
  • Menu plugins
  • Quest plugins
  • Achievement systems
  • Statistics panels

Developers can obtain the public Java API via Bukkit's ServicesManager:

RegisteredServiceProvider<YuTeleportApi> registration =
        Bukkit.getServicesManager().getRegistration(YuTeleportApi.class);
YuTeleportApi api = registration == null ? null : registration.getProvider();

The API can initiate random teleports, warp teleports, home teleports, back teleports, and TPA requests; read module enable states, cooldowns, costs, warp/home lists, and teleport statistics.

Lifecycle events:

  • PlayerTeleportStartEvent
  • PlayerTeleportDestinationEvent
  • PlayerTeleportCancelEvent
  • PlayerTeleportCompleteEvent

Commands and the API share the same entry points, so third‑party plugins cannot bypass permissions, world access, cooldowns, waiting, economy, or safety rules.


🧱 Compatibility

Minecraft Versions

The plugin targets cross‑version compatibility for Minecraft 1.8.x – 1.26.x Bukkit / Spigot / Paper ecosystems.

Different features are auto‑detected and downgraded:

  • BossBar: 1.9+ supported; falls back to other countdown channels otherwise.
  • ActionBar / Title: enabled when supported; older versions skip or downgrade automatically.
  • Particle effects: 1.9+ supported; does not affect teleport if unavailable.
  • &#RRGGBB hex colors: natively displayed on 1.16+; older versions downgrade to legacy colours.
  • Paper async chunk loading: used for async search and pre‑caching when available; falls back to sync search otherwise.
  • 1.18+ world heights: reads min/max heights automatically, compatible with negative‑height worlds.

Server Softwares

  • CraftBukkit / Spigot
  • Paper / Purpur / Leaves and most Paper forks
  • Folia
  • Youer / Arclight / Mohist / CatServer and other hybrid servers
  • Any server that follows the Bukkit / Spigot / Paper API

Soft Dependencies

  • Vault: used when coin economy is enabled.
  • PlayerPoints: used when points economy is enabled.
  • PlaceholderAPI: automatically registers %yuteleport_*% placeholders when installed.

If any soft dependency is missing, the plugin still runs independently; the corresponding features are skipped with clear log hints.


⚙️ Configuration Example

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

economy:
  enabled: true
  provider: vault

cooldowns:
  persist: true

teleports:
  defaults:
    warmup-seconds: 5
    countdown-display: actionbar
    cancel-on-move: true
    cancel-triggers:
      move: true
      damage: true
      interact: true
      chat: true
      command: true
    world-access:
      blacklist:
        - lobby
        - "playerworld*"
      whitelist: []

  rtp:
    enabled: true
    warmup-seconds: -1
    cooldown-seconds: 5
    search-mode: async
    precache:
      enabled: true
      size: 3
    worlds:
      default:
        cost: 15.0
        shape: circle
        center:
          x: 0
          z: 0
        radius:
          min: 500
          max: 10000
        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*"
          allowed-materials: []
          blocked-biomes:
            - "*OCEAN*"
          allowed-biomes: []

  warp:
    enabled: true
    warmup-seconds: 5
    cooldown-seconds: 3
    cost: 0.0
    max-warps: 1
    public:
      enabled: true
      publish-cost: 0.0
      teleport-cost: 0.0

  home:
    enabled: true
    warmup-seconds: 5
    cooldown-seconds: 3
    cost: 0.0
    max-homes: 2
    world-blacklist: []
    public:
      enabled: true
      publish-cost: 0.0
      teleport-cost: 0.0

  tpa:
    enabled: true
    request-timeout-seconds: 60
    warmup-seconds: 5
    cooldown-seconds: 10
    cost: 0.0

  share:
    enabled: true
    cooldown-seconds: 60
    expire-seconds: 120
    max-active: 256
    cost: 0.0
    teleport-cost: 0.0

  back:
    enabled: true
    warmup-seconds: 5
    cooldown-seconds: 10
    cost: 0.0
    safety-rescue: true
    max-history: 5
    expire-seconds: 1800
    persist: true

effects:
  sounds:
    enabled: true
  titles:
    enabled: true
  particles:
    enabled: true
  smooth-bossbar: true
  interactive-chat: true

🎯 Suitable for These Servers

  • Survival servers
  • Retirement/community servers
  • Resource‑world servers
  • RPG large‑map servers
  • Skyblock with extra dimensions
  • Tech / Slimefun servers
  • Servers with many shops, spawns, and public facilities
  • Event‑world servers
  • Hardcore / Battle‑Royale style servers
  • High‑performance Paper / Purpur servers
  • Folia multithreaded servers
  • Bukkit hybrid servers
  • Servers needing a unified teleport system and player distribution

🔗 Official Links


🎲 YuTeleport

Not just a random coordinate generator, nor a patchwork of scattered commands – but a safe teleport system designed for production servers.

🧭 Random Teleport, 📍 Warp, 🏠 Home, 🤝 TPA, 🔙 Back, 📡 Coordinate Sharing, 💰 Economy integration, 👥 Group Permissions, ⏳ Unified Countdown, 🛡️ Safe Landing, 🧵 Folia Scheduling, 📊 PAPI placeholders, and 🧑‍💻 Java API – all integrated into YuTeleport.

Upgrade your server's teleport from "functional" to "unified, controllable, and maintainable".

Ченджлог

2.0.1.2Релиз26.1.1, 26.1.2, 26.2 · 9 июля 2026 г.

Fixed some bugs.

2.0.1.1Релиз26.1.1, 26.1.2, 26.2 · 8 июля 2026 г.

🎉 YuTeleport 2.0.1.0 Changelog 🎉


📦 Version Upgrade: 2.0.0.02.0.1.0

🔥 Key Highlight: New /back return module – retrace your every step!


New Features

🔹 Return Command Family

  • /back – Return to the last returnable location 📍
  • /back death – Return to your last death point 💀
  • /back list – View your return history; click to teleport (requires interactive chat enabled) 📋
  • /back clear – Clear your own back history 🗑️

🔹 Broader Tracking

  • Records plugin teleports, death locations, and external plugin teleport positions 🔄

🔹 Data Persistence

  • Saves up to 5 recent records by default
  • Automatically expires after 30 minutes

🔹 Independent Configuration

  • /back has its own settings for: warm‑up, cooldown, economy cost, safe landing, world whitelist/blacklist, and hooks ⚙️

🔹 New Permission Nodes

  • yuteleport.back.use – Use permission
  • yuteleport.back.death – Death return permission
  • yuteleport.back.clear – Clear permission
  • yuteleport.back.admin – Admin permission 👑

🔹 PlaceholderAPI Support

  • Added a placeholder for the back module toggle 🧩

🔹 API Extensions

  • Added Back teleport type and request interface 🧬

🛠️ Adjustments & Fixes

  • Config version upgraded to config-version: 20 📄
  • Added teleports.back config section, enabled by default ✅
  • 🐛 Fixed: Empty world whitelist/blacklist at module level not correctly overriding default restrictions
  • Cooldown backend refactored to use shared YuLib bucket‑based cooldown implementation, with a separate back‑specific bucket 🪣

⚠️ Upgrade Notes

  1. Before updating, we recommend backing up:

    • plugins/YuTeleport/config.yml
    • The data directory (plugins/YuTeleport/data/)
  2. If you do not need /back:

    • Set teleports.back.enabled: false in the config to disable it 🚫
  3. For servers with custom permission groups:

    • Check whether you need to grant or restrict the new back‑related permissions 🔐

🚀 Enjoy the plugin, and may your teleports be flawless! Feel free to report any issues.
— YuTeleport Dev Team ❤️

2.0.0.0Релиз26.1.1, 26.1.2, 26.2 · 8 июля 2026 г.

🚀 YuTeleport 2.0.0.0 Update Announcement

📢 Attention all server owners — YuTeleport has been upgraded from 1.3.0.1 to 2.0.0.0! 🎉

This is a major version update — the plugin has evolved from a simple random teleport tool into a complete teleportation system 💪 The original /yuteleport, /ytp, and /rtp random teleport commands remain fully functional, so you can continue using them as before.


✨ Major Updates

🧭 New warp Public Waypoint Module

  • Full command support: /warp, /setwarp, /delwarp
  • Create waypoints as public, private, or restricted
  • Supports descriptions, renaming, quantity limits, and permission-based access

🏠 New home Player Home Module

  • Full command support: /home, /homes, /sethome, /delhome
  • Supports multiple homes, public homes, group-based home limits, and permission-based expansion

🤝 New tpa Player-to-Player Teleport Module

  • Full command support: /tpa, /tpahere, /tpaccept, /tpdeny, /tpacancel, /tpaignore, /tpaall
  • Complete player teleport request management

📍 New Coordinate Sharing Feature

  • Players can share their current location after teleporting
  • Other players can click the message to teleport directly to that location ✨

⚙️ Unified Teleport Pipeline

  • Random teleport, warp, home, and tpa now share a single unified teleport pipeline
  • Unified handling of: cooldowns ⏱️, countdown timers ⏳, movement cancellation 🚫, economy charges 💰, refunds 🔄, safe landing 🛡️, Folia/Paper scheduling, and teleport status

📄 Configuration Upgrade

  • Configuration structure upgraded to config-version: 19
  • Old configurations are automatically migrated with backup 📦

🔌 API & Placeholder Expansion

  • New PlaceholderAPI placeholders for module status, warp/home counts, cooldowns, costs, and more
  • Java API expanded for easier development and integration

💎 Economy System Support

  • Supports both Vault and PlayerPoints economy plugins
  • Random teleport, warp, home, and tpa can be individually configured with separate costs and cooldowns

⚠️ Upgrade Notes (Please Read Carefully)

  1. 📁 Back up the entire plugins/YuTeleport/ folder before upgrading
  2. 🔄 Replace the jar file during off-peak hours and start the server — the plugin will automatically migrate config.yml and create a backup
  3. ⚡ If your server already has plugins like EssentialsX or CMI that use /warp, /home, or /tpa, rename the commands in teleports.<module>.commands or disable the conflicting modules
  4. 📂 New data files include:
    • warps.yml
    • data/homes/<uuid>.yml
    • cooldowns.yml
      ⚠️ Do not manually edit these files while the server is running
  5. 💰 If enabling economy features, verify that economy.enabled, economy.provider, and Vault/PlayerPoints are correctly installed
  6. 🔑 After upgrading, review the new permission nodes, especially for warp/home/tpa, public points, quantity limits, and admin permissions

💡 Final Notes

This update maintains backward compatibility with the old random teleport functionality. However, since many new modules have been added, we strongly recommend testing command conflicts, configuration migration, and economy logic on a test server first before deploying to production 🧪✅

Happy hosting! 🎮🎊

— YuTeleport Development Team ❤️

1.3.0.1Релиз26.1.1, 26.1.2, 26.2 · 5 июля 2026 г.

fix teleport cooldown after teleport interruption

1.3.0.0Релиз26.1.1, 26.1.2, 26.2 · 4 июля 2026 г.

New Features (Five Major Modules)

Teleport Core

  • Asynchronous search mode
  • Destination pre-caching
  • Circular distribution with customizable center point
  • Biome whitelist/blacklist support with /yurtp biome:<mode> parameter
  • World border awareness
  • World list with wildcard (*) support

Countdown & Audio/Visual Feedback

  • Multi-channel countdown: Chat, BossBar, ActionBar, or Silent mode
  • BossBar color transition from Green → Yellow → Red
  • Individually configurable interruption conditions (5 toggleable checks)
  • Full-stage sound effects (countdown pitch ramp-up and success arpeggio)
  • Built-in localized titles
  • Departure and arrival particle effects
  • Click-to-retry messages with hoverable coordinates
  • &#RRGGBB hexadecimal color support

Automatic Random Teleport

  • Random teleport on first join
  • Random teleport on respawn (optionally respecting beds and respawn anchors)

Economy & Cooldowns

  • PlayerPoints provider support
  • Group-based cooldowns and teleport costs
  • Cooldowns persisted in cooldowns.yml to prevent reset after server restarts
  • Automatic refunds on failed teleports
  • Duplicate teleport protection

PlaceholderAPI

  • Expanded placeholders from 17 to 45+
  • Includes success rate, cooldown progress bar, group, cost, parameterized world placeholders, localized _display suffixes, and offline support
1.2.0.2Релиз26.1.1, 26.1.2, 26.2 · 23 июня 2026 г.

fix wait messages

1.2.0.1Релиз26.1.1, 26.1.2, 26.2 · 20 июня 2026 г.

fix messages

1.2.0.0Релиз26.1.1, 26.1.2, 26.2 · 18 июня 2026 г.

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.

Комментарии

Загружаем…