v2.0-26.1

[EasterGhost]

TeleportCommandsFabric v2.0

What's New:

• Reworked the teleport system for more stable delayed teleports, cooldowns, cancellations, replacement handling, and high-player-count usage
• Add configurable teleport sound and particle effects:
  • /tpc config teleporting effects <true|false>
• Add configurable target chunk preloading:
  • /tpc config teleporting preload <true|false>
  • /tpc config teleporting preloadRadius <chunks>
• Add configurable default target safety-check behavior:
  • /tpc config teleporting defaultSafetyCheck <true|false>
• Add /tpc debug <true|false> to control extra troubleshooting logs
• Add improved /homes and /warps pages with clearer clickable controls
• Add sorting and filtering for home/warp list pages
• Add configurable temporary home expiration time
• Add clearer warp map visibility display, including personal and global visibility states
• Keep direct global warp map visibility control with:
  • /gwarpmap <name> <visible>
• Rebuild /rtp with improved performance for both normal usage and high-concurrency usage
• Add configurable minimum and maximum RTP radius
• Improve RTP destination safety checks
• Improve TPA request handling, expiration cleanup, and request-id handling
• Update Xaero integration for the Minecraft 26.1.x release line
• Improve Xaero waypoint sync for homes and warps
• Improve Xaero waypoint teleport and deletion behavior

Changes:

• Replace the old JSON storage runtime path with a faster and more reliable storage system
• Automatically migrate older storage files on first startup
• Split player, global, and recorded-location data into clearer storage areas
• Improve storage reliability during player quit, server shutdown, and async save flows
• Rework /tpc admin tools with clearer status, help, module enable/disable, config, and debug controls
• Apply supported config changes at runtime without requiring a server restart
• Improve command messages and clickable command output consistency
• Improve behavior when players disconnect or reconnect during teleport actions
• Improve behavior under many simultaneous teleport requests
• Reduce normal log noise; extra diagnostic logs can now be enabled with /tpc debug true
• Keep the mod fully usable as a server-side mod while preserving optional client-side Xaero enhancements
• Update project dependencies for the Minecraft 26.1.x release line
• Improve localization coverage across supported language files

Bug Fix:

• Fix teleport result handling edge cases
• Fix teleport cancellation and replacement behavior under overlapping requests
• Fix previous-location recording failures from interfering with teleport completion
• Fix RTP safety checks around unsafe destination blocks
• Fix RTP result delivery when players disconnect
• Fix TPA invalid request-id handling
• Fix TPA request expiration cleanup behavior
• Fix /back death now respecting whether the back module is enabled
• Fix translation loading fallback edge cases
• Fix player death hook failures so they do not interfere with normal death handling
• Fix invalid home/warp world handling so users receive clearer feedback
• Fix names containing escaped characters in clickable command actions
• Fix several Xaero waypoint sync, teleport, deletion, and command-routing edge cases

Important Behavior Changes:

• Target preloading is disabled by default and can be enabled with /tpc config teleporting preload <true|false>
• Target teleport safety checks only run when target preloading is enabled
• Default behavior of target teleport safety is configurable through /tpc config teleporting defaultSafetyCheck <true|false>
• RTP uses its own independent safety logic and is not affected by the target teleport safety setting
• Old JSON storage is replaced by the new storage system and will be migrated automatically
• /back death is now controlled by the back module enabled/disabled state

Upgrade Notes:

• Back up your server data before upgrading
• Old storage data should migrate automatically on first startup
• Review the new /tpc config teleporting options after upgrading
• Review RTP radius settings if your server uses /rtp heavily
• If troubleshooting is needed, use /tpc debug true

Other:

• Large internal cleanup of command, storage, teleport, RTP, TPA, admin, and Xaero integration code
• Added broader automated test coverage for teleport and CLI behavior
• Updated project documentation and localization resources

---

新增功能：

• 重做传送系统，提升延迟传送、冷却、取消、请求替换和高玩家数量场景下的稳定性
• 添加可配置的传送音效与粒子效果：
  • /tpc config teleporting effects <true|false>
• 添加可配置的目标区块预加载：
  • /tpc config teleporting preload <true|false>
  • /tpc config teleporting preloadRadius <chunks>
• 添加可配置的默认目标传送安全检查行为：
  • /tpc config teleporting defaultSafetyCheck <true|false>
• 添加 /tpc debug <true|false>，用于控制排查问题时的额外调试日志
• 改进 /homes 和 /warps 页面，提供更清晰的可点击控制
• 添加 home/warp 列表页面的排序与筛选支持
• 添加临时 home 过期时间配置
• 改进 warp 地图可见性显示，包括个人与全局可见状态
• 保留直接修改全局 warp 地图可见性的命令：
  • /gwarpmap <name> <visible>
• 重建 /rtp，提升普通使用和高并发使用下的性能表现
• 添加可配置的 RTP 最小半径和最大半径
• 改进 RTP 目标点安全检查
• 改进 TPA 请求处理、过期清理和 request-id 处理
• 更新 Xaero 集成以适配 Minecraft 26.1.x 版本线
• 改进 home 和 warp 的 Xaero 航点同步
• 改进 Xaero 航点传送与删除行为

变更：

• 用更快、更可靠的新存储系统替换旧 JSON 运行时存储路径
• 首次启动时会自动迁移旧版存储文件
• 将玩家数据、全局数据和记录位置数据拆分到更清晰的存储区域
• 改进玩家退出、服务器关闭和异步保存流程中的存储可靠性
• 重做 /tpc 管理工具，提供更清晰的状态、帮助、模块启用/禁用、配置和调试控制
• 支持的配置变更现在会在运行时生效，无需重启服务器
• 改进命令消息和可点击命令输出的一致性
• 改进玩家在传送过程中断线或重连时的行为
• 改进大量玩家同时触发传送请求时的表现
• 减少正常运行时的日志噪音；需要诊断时可使用 /tpc debug true 启用额外日志
• 保持模组可作为纯服务端模组使用，同时保留可选客户端安装带来的 Xaero 体验增强
• 更新项目依赖以适配 Minecraft 26.1.x 版本线
• 改进支持语言文件的本地化覆盖

Bug修复：

• 修复传送结果处理的边缘情况
• 修复重叠请求下的传送取消和替换行为
• 修复上一传送位置记录失败可能影响传送完成的问题
• 修复 RTP 对不安全目标方块的安全检查问题
• 修复玩家断线时 RTP 结果返回处理的问题
• 修复 TPA 无效 request-id 的处理问题
• 修复 TPA 请求过期清理行为
• 修复 /back death 现在会受 back 模块启用状态控制
• 修复翻译加载后备机制的边缘情况
• 修复玩家死亡 hook 失败可能影响正常死亡流程的问题
• 修复 home/warp 目标世界无效时的反馈问题
• 修复可点击命令操作中包含转义字符的名称处理问题
• 修复若干 Xaero 航点同步、传送、删除和命令路由边缘情况

重要行为变化：

• 目标区块预加载默认关闭，可通过 /tpc config teleporting preload <true|false> 启用
• 目标传送安全检查只会在目标区块预加载启用时执行
• 目标传送安全检查的默认行为可通过 /tpc config teleporting defaultSafetyCheck <true|false> 配置
• RTP 使用独立的安全检查逻辑，不受目标传送安全检查设置影响
• 旧 JSON 存储已替换为新的存储系统，并会自动迁移
• /back death 现在受 back 模块启用/禁用状态控制

升级说明：

• 升级前建议备份服务器数据
• 旧存储数据会在首次启动时自动迁移
• 升级后建议检查新的 /tpc config teleporting 相关配置
• 如果服务器大量使用 /rtp，建议检查 RTP 半径设置
• 如需排查问题，可使用 /tpc debug true

其他：

• 大规模清理和优化内部命令、存储、传送、RTP、TPA、管理命令与 Xaero 集成代码
• 添加更完整的传送与 CLI 行为自动化测试覆盖
• 更新项目文档和本地化资源

---

This discussion was created from the release v2.0-26.1.