ВЕРСИИ (14)

🎉 YuTP 传送插件 v2.0.1.5 燃情更新 1. 修复actionbar颜色符号异常bug 2. 修复actionbar传送成功后不显示100%进度的bug

Fixed bug.

Fixed some bugs.

🎉 **YuTeleport 2.0.1.0 Changelog** 🎉 --- 📦 **Version Upgrade**: `2.0.0.0` → `2.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 ❤️

# 🚀 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 ❤️

fix teleport cooldown after teleport interruption

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

fix wait messages

fix messages

# 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: ```yaml teleport: wait-seconds: 5 cancel-on-move: true ``` New permission: ```text 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. ```yaml 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. ```yaml 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: ```yaml 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: ```yaml language: default: en_US use-player-locale: true ``` Server owners who want Simplified Chinese as the default language can set: ```yaml 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: ```text 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: ```yaml 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: ```yaml language: default: zh_CN use-player-locale: true ``` ```yaml teleport: wait-seconds: 5 cancel-on-move: true ``` ```yaml world-whitelist: [] ``` ```yaml default: cost: 0.0 safety: allowed-materials: [] ``` If your server only allows RTP in a resource world, whitelist mode is recommended: ```yaml 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.

🐛 Bug Fixes Fixed an issue where safe locations were frequently not found in the Nether Improved the height range calculation for Nether safe location searches, ensuring the search area properly respects actual world height limits, including nether roof and lava lake environments. Resolved no_safe_location errors caused by incorrect height calculations. Fixed an issue where safe locations could not be found in the Overworld on versions 1.8.x – 1.12.x Adapted to legacy behavior where World#getHighestBlockYAt returns the Y-level of an air block above the surface. Added a downward calibration step to ensure the actual solid ground block is identified. Added proactive chunk loading before height queries to prevent inaccurate results from unloaded chunks. Eliminated frequent console spam of 脚下方块不合格: AIR ("Invalid block under feet: AIR") on older versions, ensuring players are consistently teleported to safe surface locations.

# YuRandomTeleport Update Log ## Version 1.1.0.0 → 1.1.1.0 Release Notes ### ✨ New Features - **Teleport Interruption Protection** While searching for a safe location, the teleport will now be automatically canceled if the player moves, takes damage, chats, or performs any interactive actions. This prevents accidental teleports. You can disable this behavior in the configuration file. - **World Whitelist Mode** A new world whitelist setting has been added. When enabled, only worlds listed in the whitelist can be used for random teleports. The whitelist takes priority over the existing world blacklist. - **Standable Block Whitelist** In addition to the existing dangerous block blacklist, you can now define a "whitelist of allowed standing blocks." A location will only be considered safe if the block beneath the player matches the specified types, giving you finer control over teleport safety. - **Per-World Pricing** You can now set different teleport costs for individual worlds (e.g., higher prices for the Nether or the End), overriding the global default cost. ### 🛠 Fixes & Improvements - **Fixed Teleport Prompt Commands Not Triggering** Previously, configured commands such as title messages or chat prompts during teleport would sometimes fail to execute. This has been fixed to ensure prompts like "Searching for a safe location..." and "Teleport successful!" appear on time. - **Fixed Reload Command Not Refreshing Economy Status** When using `/yurtp reload`, the plugin now correctly updates the enabled/disabled status of the economy system without requiring a server restart. --- ### 📝 Upgrade Notes - If you are using a customized configuration file, please check the newly added options in `config.yml` after updating, including `world-whitelist`, `cancel-on-move`, and the `cost` field under the `worlds` section. - This update is fully compatible with older configuration files, and the plugin will automatically perform incremental updates as needed. --- ### 💬 Community & Support Join our official community for feedback, suggestions, or to connect with other server administrators: **QQ Group: 1080918424**