Minecraft 热还原与玩家数据保留

准备游戏侧协调与目标版本，核对玩家数据保留选项，再执行并验证 Minecraft 热还原。

Host 管理的还原

MineRewind 用配置级 RestoreCoordinator 接收全部受影响来源、OperationId 和 Restore／Checkout／Merge 类型，协调活动世界保存、退出及 session.lock 释放。多个活动世界、握手失败或来源仍占用时拒绝，不绕过环境检查。

准备完成后调用一次 Host continuation；实际写入、Safe Restore 和恢复事务由 Host 管理。插件返回后不能继续写 live 世界。Merge／Checkout 同样协调环境，但不启用普通还原玩家保留；零写入合并无需退出。

目标和模式

Alt+Ctrl+Z 或 file 省略的 RESTORE 使用活动分支唯一尖端的 Quick Restore。状态已精确匹配时 NoChanges，不选择上一个时间包。远程默认 Clean，部分捕获强制 Overwrite；指定 file 使用可解析的历史目标并验证依赖。

cmd=RESTORE;current_save=true;preserve_player_data=true;from=panel;request_id=restore-001

玩家保留

PreservePlayerData 本地默认 false；preserve_player_data 省略继承，true／false 明确覆盖当前操作。普通 Restore 在锁定只读 Current／Target 视图中生成相对文件提案，Host 整批验证并应用到暂存，不在还原后补写 level.dat。

对全部 UUID 保留位置、背包、经验等选定 NBT 字段；备份中缺少该玩家时保留当前完整 NBT。统计／进度仍随备份恢复。单人嵌入 Player 与服务器 playerdata／players 布局按实现处理；跨 26.1 布局保留或不支持显式 override 时阻断。修改结果 Workspace baseline 为 Derived。

完成与恢复状态

归档写入成功与自动重进成功是不同结果，重进失败可产生 SuccessWithWarnings。RecoveryRequired／CommittedRecoveryRequired 禁止自动重进，应检查恢复诊断再操作。不能对未知提交状态重复点击还原。

先在副本验证多个玩家、显式 false、缺失玩家、布局异常、取消、部分捕获和游戏重进。NBT 夹具通过不证明真实游戏加载成功。

单次路径强保留

普通 Java Restore 可使用 restore_preserve_paths，路径相对于唯一受管世界根；相对文件或以 / 结尾的目录保留当前完整状态，包括当前删除。它不同于玩家字段保留，且不会扩大 SourceScope；Checkout／Merge 不应用此参数。边界、歧义和暂存限制见过滤指南。

cmd=RESTORE;current_save=true;restore_preserve_paths=data/local.dat,datapacks/;preserve_player_data=false;from=panel;request_id=restore-preserve-001

示例路径必须实际位于受管世界根内；不能借此保护世界根外的实例目录。Bedrock 不使用 Java 热协调或 NBT 玩家保留，请关闭游戏后走普通文件还原。