v2.0.1.2

Fixed some bugs.

v2.0.1.1

🎉 YuTeleport 2.0.1.1 更新日志 🎉

---

📦 版本升级：2.0.0.0 → 2.0.1.1

🔥 核心亮点：新增 /back 返回模块，追忆你的每一步！

---

✨ 新增内容

🔹 返回指令全家桶

• /back —— 返回最近一次可返回位置 📍
• /back death —— 返回最近死亡点 💀
• /back list —— 查看可返回历史，点击即可传送（需开启交互聊天）📋
• /back clear —— 清空自己的 back 历史 🗑️

🔹 记录更全面

• 支持记录：插件传送、死亡位置、外部插件传送位置 🔄

🔹 数据持久化

• 默认保存最近 5 条记录
• 默认 30 分钟 自动过期 ⏳

🔹 独立配置支持

• /back 拥有独立的：暖场时间、冷却时间、经济消耗、安全落点检测、世界黑白名单、Hooks 配置 ⚙️

🔹 新增权限节点

• yuteleport.back.use —— 使用权限
• yuteleport.back.death —— 死亡返回权限
• yuteleport.back.clear —— 清空权限
• yuteleport.back.admin —— 管理员权限 👑

🔹 PlaceholderAPI 支持

• 新增 back 模块开关占位符 🧩

🔹 API 扩展

• 新增 Back 传送类型 & 请求接口 🧬

---

🛠️ 调整与修复

• 配置文件版本升级至 config-version: 20 📄
• 新增 teleports.back 配置节，默认启用 ✅
• 🐛 修复：模块级世界黑白名单中空列表无法正确覆盖默认限制的问题
• 冷却底层重构为共用 YuLib 分桶冷却实现，并新增 back 独立冷却桶 🪣

---

⚠️ 升级提示

1. 更新前建议备份：

   • plugins/YuTeleport/config.yml
   • 数据目录（plugins/YuTeleport/data/）

2. 若不需要 /back：

   • 在配置中设置 teleports.back.enabled: false 即可关闭 🚫

3. 自定义权限组的服主请注意：

   • 检查是否需要开放或限制新的 back 相关权限 🔐

---

🚀 祝您使用愉快，传送无忧！如有问题欢迎反馈～
—— YuTeleport 开发组 ❤️

v2.0.0.0

🚀 YuTeleport 2.0.0.0 更新公告

📢 各位服主请注意 —— YuTeleport 已从 1.3.0.1 重磅升级至 2.0.0.0！🎉

本次是 主版本大更新，插件已从单一的随机传送工具，全面进化为 完整传送系统 💪 原有的 /yuteleport、/ytp、/rtp 随机传送功能继续保留，放心使用～

---

✨ 主要更新内容

🧭 新增 warp 公共传送点模块

• 支持 /warp、/setwarp、/delwarp 完整指令体系
• 可设置 公开、私有、受限 三种传送点类型
• 支持传送点 描述、重命名、数量限制 与 权限控制

🏠 新增 home 玩家家模块

• 支持 /home、/homes、/sethome、/delhome 全套指令
• 支持 多 home、公开 home、分组 home 上限 和 权限扩容

🤝 新增 tpa 玩家互传模块

• 支持 /tpa、/tpahere、/tpaccept、/tpdeny、/tpacancel、/tpaignore、/tpaall
• 完整的玩家传送请求管理体验

📍 新增坐标分享功能

• 玩家传送成功后 自动分享当前位置，其他玩家可 点击消息直接传送 ✨

⚙️ 统一传送管线

• 随机传送、warp、home、tpa 现在 共用同一套传送管线
• 统一处理：冷却 ⏱️、等待倒计时 ⏳、移动打断 🚫、经济扣费 💰、退款 🔄、安全落点 🛡️、Folia/Paper 调度和传送状态

📄 配置升级

• 配置结构升级到 config-version: 19，旧配置 自动迁移并备份 📦

🔌 API & 占位符扩展

• PlaceholderAPI 新增模块状态、warp/home 数量、各类传送冷却、费用等占位符
• Java API 同步扩展，方便二次开发

💎 经济系统支持

• 支持 Vault 与 PlayerPoints 双经济插件
• 随机传送、warp、home、tpa 可 分别设置费用和冷却，灵活管理

---

⚠️ 升级须知（请仔细阅读）

1. 📁 升级前建议备份 整个 plugins/YuTeleport/ 文件夹
2. 🔄 低峰期替换 jar 后启动服务器即可，插件会自动迁移 config.yml 并生成备份
3. ⚡ 如服务器已有 EssentialsX、CMI 等插件占用 /warp、/home、/tpa，请在 teleports.<模块>.commands 中 改名 或 关闭对应模块
4. 📂 新增数据文件包括：
   • warps.yml
   • data/homes/<uuid>.yml
   • cooldowns.yml
     ⚠️ 运行中 不建议手动编辑
5. 💰 如启用经济功能，请确认 economy.enabled、economy.provider 以及 Vault/PlayerPoints 已正确安装
6. 🔑 升级后建议检查新权限节点，尤其是 warp/home/tpa、公开点、数量上限和管理权限

---

💡 最后的话

本次更新保持旧版随机传送主要行为兼容，但新增模块较多，建议服主 先在测试服确认命令冲突、配置迁移和经济扣费逻辑 后再投入正式服使用 🧪✅

祝各位服主开服愉快！🎮🎊

—— YuTeleport 开发团队 ❤️

v1.3.0.1

fix wait time

v1.3.0.0

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

v1.2.0.2

fix wait messages

v1.2.0.1

fix messages

v1.2.0.0

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

7. 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.