外观
🔑 命令与权限
游戏内加 /，控制台不加。根命令要求 invsync.command，子权限在其基础上追加。
日常命令
| 命令 | 用途 | 备注 |
|---|---|---|
/invsync | 当前子命令帮助 | 根据安装版本查看 |
/invsync reloadLang | 重载语言文件 | 不是重载 Redis/数据库与全部配置 |
/invsync edit 玩家 INVENTORY | 编辑离线背包 | 玩家执行；目标全网离线未锁定 |
/invsync edit 玩家 ENDER_CHEST | 编辑离线末影箱 | 同上 |
/invsync backup 在线玩家 | 手动备份 | 玩家执行；额外 invsync.backup；备份已开启；目标本服在线 |
/invsync restore 玩家 | 打开历史与恢复界面 | 玩家执行；额外 invsync.restore；备份已开启 |
/invsync migrator 来源 all | 迁移支持的数据 | 维护时执行，前置条件见迁移指南 |
/invsync migrator 来源 statistic | 统计单项迁移 | 部分迁移器不支持 |
/invsync compress | 主表 v1→v2 | 仅 MySQL |
/invsync compressBackup | 旧备份表转换 | 仅 MySQL，避免重复执行 |
来源标识：HuskSync、NoneBase64、KTG4、MysqlPlayerDataBridge、PlayerDataSQL、MySqlPlayerBridge、PlayerSync，不区分大小写。
排查命令
下列额外需要 invsync.dev，只给可信管理员。
| 命令 | 作用 |
|---|---|
/invsync dev serverName | 预加载通信方式与实际子服名 |
/invsync dev playerDataFolder | 玩家数据目录探测结果 |
/invsync dev save 在线玩家 | 提交在线玩家保存；提示不代表 Future 已完成，检查日志 |
/invsync dev debug | 调试开关，另受 OP 限制 |
/invsync dev debug 在线玩家 | 玩家级调试，另受 OP 限制 |
高风险或开发诊断
不是修复按钮
冻结不等于分布式数据锁；解冻不等于恢复正确数据。预保存和预读会操作交接状态。删除会移除主存档，不应作为加载失败的常规解决方式。
| 命令 | 风险 / 条件 |
|---|---|
/invsync dev delete 玩家 | 删除 Redis 与后端主存档，执行前确认全网离线与备份；不会自动把历史备份恢复回来 |
/invsync dev freeze 在线玩家 true | 冻结本服玩家操作 |
/invsync dev freeze 在线玩家 false | 解冻，须先查明冻结原因 |
/invsync dev preload 玩家 | 目标侧预加载诊断，目标应在本服离线 |
/invsync dev prequit 在线玩家 | 源侧提前保存交接，可能冻结玩家，仅测试账号 |
/invsync dev testPdc | 写入测试 PDC，仅玩家 |
/invsync dev lookPdc | 查看测试 PDC，仅玩家 |
在线玩家参数由命令框架解析，可用玩家名，部分入口支持 @a、@p、@s、@r；针对本服在线玩家，不是全网广播。控制台不具有玩家身份的选择器勿盲用。