Skip to main content

KnotLink 与联动模组

MineRewind 的热备份/热还原依赖 KnotLink 通道与联动模组配合。

源码映射​

能力核心方法位置
命令声明GetKnotLinkCommandDefinitions()MinecraftSavesPlugin.KnotLink.cs
命令分发TryHandleKnotLinkCommandAsync(...)MinecraftSavesPlugin.KnotLink.cs
握手响应处理HandleHandshakeResponseAsync(...)MinecraftSavesPlugin.KnotLink.cs
保存完成信号HandleWorldSavedAsync(...)MinecraftSavesPlugin.KnotLink.cs
退出完成信号HandleWorldSaveAndExitCompleteAsync(...)MinecraftSavesPlugin.KnotLink.cs
重进结果信号HandleRejoinResultAsync(...)MinecraftSavesPlugin.KnotLink.cs

你需要准备​

  • FolderRewind + MineRewind（版本满足插件最小宿主要求）
  • 联动模组（可响应握手、保存、重进事件）
  • KnotLink 服务可用（收发链路正常）

命令矩阵（外部 -> MineRewind）​

命令参数说明典型响应
BACKUP_CURRENT可选注释触发当前活跃世界备份OK:Backup started...
LIST_BACKUPS_CURRENT无列出当前世界备份文件OK:file1;file2;...
RESTORE_CURRENT_LATEST无热还原到最新备份OK:Hot restore triggered...
RESTORE_CURRENTbackup_file热还原到指定备份OK:Hot restore triggered...

若无活跃世界或参数缺失，响应通常以 ERROR: 开头。

事件协议（MineRewind -> 外部）​

  • event=handshake：请求握手与版本协商
  • event=pre_hot_backup：请求保存世界再备份
  • event=pre_hot_restore：请求保存并退出后还原
  • event=restore_finished：还原阶段结果
  • event=rejoin_world：请求重进世界
  • event=hot_restore_complete：整条热还原链路完成状态

内部回传命令（外部 -> MineRewind）​

这些命令通常由联动模组回发给插件：

  • HANDSHAKE_RESPONSE <mod_version>
  • WORLD_SAVED
  • WORLD_SAVE_AND_EXIT_COMPLETE（或兼容别名 SHUTDOWN_WORLD_SUCCESS）
  • REJOIN_RESULT <success|failure> [reason]

最小联调脚本（建议顺序）​

  1. 发送 BACKUP_CURRENT，确认最短链路可运行。
  2. 发送 LIST_BACKUPS_CURRENT，确认备份结果可查询。
  3. 发送 RESTORE_CURRENT_LATEST，确认热还原主链路。
  4. 最后验证 RESTORE_CURRENT <backup_file> 的精确还原。

兼容性关注点​

  • 插件内部有最低模组版本判断
  • 握手不通过时会回退或中止相应流程
  • 命令返回统一建议采用 OK: / ERROR: 前缀

握手负载中包含 min_mod_version，建议联动侧显式记录该值以便排查版本问题。

实操建议​

  • 先执行 BACKUP_CURRENT 验证最短链路
  • 再测试 RESTORE_CURRENT_LATEST，观察保存-退出-重进全流程
  • 使用指定备份前先执行 LIST_BACKUPS_CURRENT

请求/响应示例​

示例 1：列出备份​

请求：

LIST_BACKUPS_CURRENT

响应：

OK:world_2026-02-27_19-00.7z;world_2026-02-28_09-30.7z

示例 2：握手回传​

请求：

HANDSHAKE_RESPONSE 1.2.0

响应：

OK:Handshake received. Version 1.2.0 (compatible)

相关链接​