🎒 编辑离线背包

InvSync 内置编辑只针对离线背包和末影箱，不是实时跨服 invsee。

前置条件

• 操作者在游戏内，拥有 invsync.command。
• 目标玩家全网离线，数据未被锁定，且存在同步记录。
• 先做数据库备份，避免误操作不可撤销。
• 编辑期间阻止目标登录；同一玩家只允许一名管理员编辑。

/invsync edit 玩家名 INVENTORY
/invsync edit 玩家名 ENDER_CHEST

打开界面后修改合法槽位，关闭界面提交保存。补齐出来的屏障槽位不是有效存档槽位，不要放物品。编辑容量按当前服务器实际背包/末影箱容量，跨服容量应一致。

并发与保存结果

打开前会检查在线与锁状态，但当前没有覆盖整个编辑期间的跨节点编辑租约。关闭后的提交为异步保存，界面消息不等于跨节点事务已完成。操作后检查日志并让目标重新登录验证，不要同时在其他节点编辑或恢复。

常见问题

• 提示在线：让玩家全网退出；在线管理使用 CMI 等工具并验证兼容。
• 提示锁定：先确认是否正在切服/保存或其他节点仍在线，不强行解锁。
• 数据不存在：确认玩家名、UUID、共享库以及是否曾成功初始化。
• 物品解析失败：核对自定义附魔/插件与 MC 版本，保留原数据；不要直接用 skip 再关闭编辑界面把空槽写回。

物品过滤与失败策略 · 备份恢复