🚀 TeleportCommands v2.0 — Under-the-hood Rework & NBT Storage Engine Upgrade!

TeleportCommands v2.0 is here! This release brings a massive overhaul of the teleport scheduling architecture alongside a brand-new binary NBT storage engine to deliver unmatched performance, stability, and smoothness.

---

🌟 Key Highlights

📁 1. High-Performance NBT Storage Engine

We have fully replaced the legacy JSON file persistence with Minecraft's native binary NBT format.

• Reduced Server Tick Lag: Heavy file I/O operations are shifted entirely off the server main thread. Player logins, logouts, and auto-saves are now virtually lag-free.
• Automated Seamless Upgrades: Upgrading from v1.x is completely automated. Legacy storage.json and config.json files are automatically migrated on the first launch without any loss of data.

⏳ 2. Configurable Temporary Home TTL

Server administrators can now customize the Time-To-Live (TTL) duration for temporary homes (/tmphome). Once a temporary home expires, the system automatically removes it to keep server databases clean.

🎯 3. Adaptive Execution RTP

We have completely rewritten the candidate search algorithm for random teleports (/rtp):

• Dynamic Load Balancing: The mod now seamlessly switches between low-overhead serial searches under normal loads and concurrent virtual-thread-based searches when the request queue is backlogged.

🗺️ 4. Restored Native Xaero Waypoint Sync

Restored full native waypoint synchronization and command interception compatibility for Minecraft 1.21.1 / Fabric 26.1.2 and the latest Xaero Minimap/Worldmap 26.1.2, making waypoint navigation and sync flows smoother than ever.

---

📝 Full Changelog

Added

• NBT-based Storage Engine: Migrated the storage system to a high-performance NBT-based profile storage engine, replacing legacy JSON storage for superior persistence stability.
• Legacy Migrators: Built integrated Storage v5 and Config v3 migrators, ensuring seamless automated upgrades of historical JSON settings from older versions.
• Adaptive Execution RTP Service: Implemented a new RTP random teleport service supporting adaptive scheduling, seamlessly switching between serial ticks-throttled checks and parallel virtual-thread-based searches under backlog pressure.
• Configurable Temporary Home TTL: Added configurable Time-To-Live (TTL) support for Temporary Homes with automated cleanup upon expiration.
• Native Version Updates: Built native compatibility for Xaero Minimap/Worldmap 26.1.2.

Changed

• Storage Layer Reorganization: Reorganized the storage package, separating responsibilities into dedicated modules for NBT codecs, disk I/O limiters, and managers for player, global, and recorded location profiles.
• Shared Operation Flow: Introduced a unified TeleportOperation model, centralizing teleport state-transitions, chunk preloading, and cooldowns within a shared TeleportOperationManager.
• Shared Query Infrastructure: Refactored command arguments to share common parsing, sorting, and dimension/prefix filtering nodes across warp and home queries.
• Asynchronous CLI Page Rendering: Completed the CLI rendering layer under WaypointPages to assemble paged Component outputs asynchronously.
• Unified Config Applier: Wired runtime settings adjustments to update live services dynamically via ConfigApplier.
• Lifecycle Decoupling: Moved server lifecycle event subscriptions out of the primary ModInitializer into a dedicated Lifecycle Manager.
• Normalized Safety Toggles: Unified command safety toggle argument names across all packages to Disable Safety.

Fixed

• Translation Quality: Cleaned localizations to resolve translation key overlaps, and resolved a concurrency issue during translation loading to prevent circular nested cache initialization.
• Heavy Concurrency Hardening: Strengthened state checks and boundaries for teleport operations and waypoints updates under multi-player concurrency.

---

⚠️ Upgrade & Compatibility Notes

• No Manual Migration Required: Just swap your old jar file with the new v2.0 jar. The mod handles all database upgrades automatically.
• As a general best practice for server administrators, it is always recommended to take a backup of your world and config directory before major mod updates manually, though a backup will be proceeded automatically.

---

---

🌟 版本核心亮点

📁 1. 全新二进制 NBT 存储引擎

我们彻底淘汰了原有的 JSON 文本存读文件，改用 Minecraft 原生的二进制 NBT 格式。

• 极大降低卡顿：移出了主线程的 I/O 阻塞，玩家进出游戏与数据保存更加平滑。
• 平滑迁移：内置了自动迁移器，当您从旧版升级时，遗留的 storage.json 和 config.json 会在首次启动时自动且安全地无损迁移。

⏳ 2. 可配置的临时家 (Temporary Home TTL)

现在，管理员可以在配置文件中自定义 /tmphome 的有效时长（TTL）了！过期的临时家地标会在到期后由系统执行自动清理，非常适合生存服玩家或临时组队使用。

🎯 3. 自适应 RTP 随机传送服务

我们重写了 /rtp 的底层寻点算法，引进了自适应并发调度机制：

• 智能切换：低负载下串行逐 Tick 限速检查，而在高并发积压时，自动切换为虚拟线程并行批量寻点，极大缩短高负载下 RTP 响应时间。

🗺️ 4. 恢复 Xaero 地图同步原生适配

恢复了对最新版 Xaero Minimap/Worldmap 26.1.2 的原生同步与指令拦截支持，让地图导航与同步恢复流畅使用。

---

📝 完整更新日志 (Changelog)

新增 (Added)

• 二进制存储引擎：引入基于 NBT 的玩家个人配置和存储引擎，数据读写性能大幅提升。
• 兼容性自动迁移：集成 Config v3 及 Storage v5 迁移器，保障 1.x 遗留数据在首次启动时自动无缝升级。
• 自适应调度 RTP：重构随机传送，支持待处理队列低负载下串行逐 Tick 限速校验与积压状态下自动切换为虚拟线程并行寻点的自适应调度。
• 临时家 TTL 配置：新增临时家（Temporary Home）有效期（TTL）配置支持，到期自动注销。
• 平台适配：原生兼容适配 Minecraft 1.21.1 / Fabric loader 26.1.2 以及 Xaero Minimap/Worldmap 26.1.2 同步。

变更 (Changed)

• 存储层重构与模块化：重组了 storage 包，将编解码器（codecs）、磁盘 I/O 限制器（limiters）以及玩家、全局和坐标记录 profile 管理器独立，实现清晰的职责分离。
• 共享传送操作流：设计了统一的 TeleportOperation 模型，将传送、区块预载、冷却及延时统一托管在 TeleportOperationManager 中，加固了传送生命周期。
• 查询基础设施复用：重构指令参数，实现了家与地标在分页查询、排序、前缀及维度过滤上的底层命令节点共享复用。
• 异步 CLI 分页渲染：整合了交互式命令行（CLI）文本流拼接与页面组件模型，交由 WaypointPages 底层执行异步拼装与渲染。
• 动态配置生效：通过 ConfigApplier 集中实现配置更新的运行时动态热载入生效。
• 生命周期重构：将服务器加载、卸载及 Tick 事件绑定从主初始化类中剥离，移入 Lifecycle 管理器中。
• 参数命名规范化：标准化了所有传送模块中跳过安全检测的布尔参数命名为统一的 Disable Safety。

修复 (Fixed)

• 本地化语言修复：修正了各语言包中的翻译 Key 缺失与重叠，修复了并发加载语言包时可能导致的翻译缓存嵌套死循环问题。
• 高并发状态防抖：强化了多玩家并发操作时传送与地标数据更新的瞬态边界拦截，保障状态安全。

---

⚠️ 升级与兼容性提示

• 本版本不需要手动处理数据。直接用 v2.0 的 jar 包替换旧版，Mod 会自动完成所有历史地标、家的配置无缝自升级。
• 即便有自动备份，仍然建议服务器管理员手动备份一次原有的数据文件夹作为常规安全防护。