v1.5.2-1.21.11

TeleportCommandsFabric v1.5.2

What's New:

• No new gameplay features in this release

This version focuses on fixing and stabilizing storage migration introduced in recent UUID-based home and warp updates

Changes:

• Update storage schema version to 4

• Refine storage migration pipeline by separating legacy normalization (v3) and UUID-based upgrades (v4)

• Improve migration flow clarity to avoid inconsistent upgrade states across different historical versions

Bug Fix:

• Fix incorrect storage version progression for data generated by 1.5.1 and related builds

• Fix legacy DefaultHome migration producing invalid empty UUID entries in storage.json

• Fix missing HiddenWarpUuids field during migration by automatically repairing and initializing it

• Improve robustness of migration logic when handling partially upgraded or inconsistent storage data

Other:

• Further improve internal storage reliability and forward compatibility

• Ensure all existing data converges correctly to UUID-based storage format

---

新增功能：

• 本版本未添加新的功能

本次更新主要用于修复和稳定近期引入的基于 UUID 的 home 和 warp 存储迁移逻辑

变更：

• 更新存储结构版本至 4

• 优化存储迁移流程，将旧版标准化处理（v3）与 UUID 升级（v4）明确拆分

• 改进迁移逻辑结构，避免不同历史版本之间出现不一致的升级状态

Bug修复：

• 修复 1.5.1 等版本生成的存储数据在版本升级过程中无法正确迁移的问题

• 修复旧版 DefaultHome 迁移时可能写入空 UUID 的问题

• 修复迁移过程中缺失 HiddenWarpUuids 字段的问题，现在会自动补全

• 增强迁移逻辑对部分升级/不完整数据的兼容性和稳定性

其他：

• 进一步提升存储系统的稳定性与向前兼容能力

• 确保所有历史数据能够正确收敛到基于 UUID 的统一格式

v1.5(.1)-1.21.11

TeleportCommandsFabric v1.5

What's New:

• Add /updatehome and /updatewarp to update existing locations without recreating them
• Add pagination support and page navigation for /homes and /warps
• Add Xaero map visibility control for warp and home waypoints
• Add /gwarpmap admin command to manage global map visibility for warps
• Add /back tp command to return to the location before the last teleport
• Add Xaero death waypoint teleport integration with /back death

Changes:

• Refactor shared command execution, suggestions, pagination, and UI helpers
• Split ConfigManager responsibilities and update command registration mechanism
• Improve internal storage concurrency with async file I/O and safer shared state handling
• Adjust Xaero waypoint sync behavior and teleport interception for better accuracy and cleaner default waypoint sets
• Modify Xaero waypoint deletion to silently map to mapwarp and maphome visibility changes
• Separate global admin control and personal map visibility management for warps

Bug Fix:

• Fix background thread termination issues during server shutdown
• Fix translation fallback to immediately use en_us for missing keys
• Fix teleport state clearing and unsafe block detection reliability
• Fix Xaero waypoint name matching to prevent default waypoints from being misidentified as warp or home
• Fix clickable chat actions (rename, delete, etc.) failing to handle escaped names

Other:

• Continue internal storage concurrency and command flow cleanup

---

新增功能：

• 添加 /updatehome 和 /updatewarp，无需重新创建即可更新现有坐标
• 添加 /homes 和 /warps 列表的分页支持与页码导航
• 添加针对 warp 和 home 航点的 Xaero 地图可见性控制
• 添加 /gwarpmap 管理员命令，用于管理 warp 的全局地图可见性
• 添加 /back tp 命令，允许返回上一次执行传送前的位置
• 添加与 Xaero 死亡航点传送的集成（无缝对接 /back death）

变更：

• 重构共享的命令执行、自动补全、分页和聊天 UI 辅助类
• 拆分 ConfigManager 的核心职责并更新命令注册机制
• 改进内部存储的并发安全性，引入异步文件 I/O 和更安全的共享状态处理
• 调整 Xaero 航点同步行为与传送拦截逻辑，提升识别准确性并保持默认航点集整洁
• 修改 Xaero 航点删除逻辑，现在删除同步航点会静默映射为 mapwarp 和 maphome 的可见性更改
• 分离 warp 的全局管理员控制权与个人地图可见性管理

Bug修复：

• 修复服务器关闭期间后台线程可能意外终止的清理问题
• 修复语言翻译后备机制，缺失的键现在会立即回退使用 en_us
• 修复传送状态清理和不安全方块检测的可靠性问题
• 修复 Xaero 航点名称匹配问题，防止常规默认航点被误判为 warp 或 home
• 修复聊天栏中可点击操作（如 rename、delete 等）无法正确处理转义名称的问题

其他：

• 持续清理与优化内部存储并发和命令流程代码

v1.4-1.21.11

TeleportCommandsFabric v1.4

What's New:

• Add /tpc as a short alias for /teleportcommands
• Add TeleportSafety and TeleportService to centralize teleport safety checks and teleport flow handling
• Add cached language loading through TranslationHelper
• Add support for escaped names in Xaero-triggered home and warp commands

Changes:

• Refactor TPA request handling to use requestId as the main internal key
• Refactor dimension lookup into WorldResolver
• Unify command style across multiple command modules
• Improve admin command usage and related help/status presentation
• Adjust some default config values

Bug Fix:

• Fix cooldown timing being counted before teleport completion
• Fix delayed teleport success messages being sent earlier than expected
• Fix /back deleting death locations before successful teleport
• Fix a high-Y teleport safety issue
• Improve overall teleport safety behavior consistency

Other:

• Clean duplicated and unused code
• Update README and related project docs
• Continue internal command structure cleanup and reorganization

---

新增功能：

• 添加 /tpc 作为 /teleportcommands 的简短别名
• 添加 TeleportSafety 和 TeleportService，统一传送安全检查与传送流程处理
• 添加 TranslationHelper 语言缓存
• 添加对 Xaero 触发的 home 与 warp 命令中转义名称的支持

变更：

• 重构 TPA 请求处理，改为以 requestId 作为主要内部索引
• 将维度查找逻辑重构到 WorldResolver
• 统一多个命令模块的代码风格
• 改进管理员命令的使用方式以及相关帮助/状态展示
• 调整部分默认配置值

Bug修复：

• 修复冷却时间在传送完成前就开始计算的问题
• 修复延迟传送成功消息过早发送的问题
• 修复 /back 在传送成功前删除死亡点的问题
• 修复高 Y 坐标下的传送安全检查问题
• 改进整体传送安全行为一致性

其他：

• 清理重复与无用代码
• 更新 README 和相关文档
• 持续整理和重构内部命令结构

v1.3-1.21.11

TeleportCommandsFabric v1.3

What's New:

• Added Xaero’s Minimap / World Map teleport integration
• Waypoints can now use TeleportCommands teleport logic
• Experimental feature: Pre-load chunks before teleport commands execution

Changes:

• Reworked RTP system
• /wild renamed to /rtp related commands
• RTP search performance improvements
• Added configurable teleport interval
• Admin command backend refactored

Bug Fix:

• Fixed incorrect message when TPA fails
• Fixed dimension change during RTP search
• Fixed offline player related issues
• Fixed storage and timer bugs

Other:

• Config UTF-8 handling improvements
• Invalid home cleanup improvements
• Code cleanup and README update

---

新增功能：

• 集成 Xaero 小地图/世界地图传送功能
• 航点现可使用传送命令框架的传送逻辑
• 实验性功能：在执行传送命令前预加载区块

变更：

• 重构RTP系统
• 将/wild重命名为/rtp相关命令
• 提升RTP搜索性能
• 添加可配置传送间隔
• 重构管理员命令后端

Bug修复：

• 修复TPA失败时的错误提示
• 修复RTP搜索期间维度变更问题
• 修复离线玩家相关问题
• 修复存储与计时器漏洞

其他：

• 优化配置文件UTF-8处理机制
• 改进无效home传送点清理流程
• 代码优化与README文档更新

v1.2-1.21.11

TeleportCommandsFabric v1.2

Useful Infomation can be Found at README!

What's new:

• TPA enhance: Request messages provide clickable [Accept] / [Deny] actions and support precise accept/deny handling via requestId.
• /wild command: Add /wild command to teleport randomly, with its administrative command to define random radius.
• Client-side confirmation optimization: Added a client-side mixin to automatically bypass the “trusted command” confirmation prompt for commands such as tpaaccept, tpadeny, home, warp, back true, and worldspawn true (effective when the client also has this mod installed).
• Structure & configuration cleanup: Further refactored and completed the teleport command structure and configuration system to improve maintainability and extensibility.
• Build & project optimization: Optimized Loom configuration and removed unnecessary sourceSet splitting.
• Documentation & localization updates: Updated the README usage documentation and i18n.

---

新东西：

• TPA 体验增强：请求消息提供可点击的 [Accept] / [Deny]，并支持通过 requestId 精确接受/拒绝请求。
• /wild指令：增加/wild指令以随机传送，并添加其对应的管理员指令来设置随机传送的半径
• 客户端确认优化：新增客户端侧 mixin，对 tpaaccept/tpadeny/home/warp/back true/worldspawn true 等命令自动绕过“受信任命令”确认弹窗（客户端也安装本模组时生效）。
• 结构与配置整理：传送命令结构与配置系统进一步重构/补全，便于维护与扩展。
• 构建与工程优化：优化 Loom 配置，移除不必要的 sourceSet 拆分。
• 文档与本地化更新：README 使用文档与多语言文本更新。