Skip to content

v2.0-26.1

Choose a tag to compare

@EasterGhost EasterGhost released this 06 Jun 17:52
· 111 commits to main since this release
054b1f1

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 行为自动化测试覆盖
  • 更新项目文档和本地化资源