多人游戏与网络同步 / 系统课时
把输入变成可重放战斗指令
把输入变成可重放战斗指令
战斗输入如果只以“按下技能键”的瞬时事件存在,就无法可靠地发送、重试、复盘或重放。更实用的做法是把一次输入冻结成带序号、时间和操作参数的战斗指令,使客户端、服务端和调试工具都能引用同一份事实。
学习目标
- 设计能够唯一定位和排序的战斗指令结构
- 区分原始输入、战斗指令与执行结果的职责
- 用同一批指令完成记录与确定性重放
一条指令应该保存什么
可重放指令描述的是“玩家当时要求系统做什么”,而不是“最后发生了什么”。最小结构通常至少包含 seq、时间信息、操作者、技能标识以及执行技能必需的输入参数。
seq 是客户端会话内单调递增的输入序号。它比随机 ID 更适合解决排序、累计确认和重放边界问题。例如服务端确认到 seq=41 后,客户端就知道 41 及以前的指令已经处理,不需要再次重演。
时间字段用于复盘和延迟补偿,但不要把客户端时间直接当成服务端权威时间。客户端可以记录 clientTimeMs,服务端收到请求后再记录自己的接收 Tick 或服务器时间,通过时钟映射决定它能参与哪些判定。
一个适合记录和网络传输的指令可以写成普通数据对象:
const command = {
seq: 41,
clientTimeMs: 12540,
actorId: "player-7",
skillId: "dash",
input: {
direction: { x: 1, y: 0 },
heldMs: 120
}
};这是数据结构示例,不单独执行。它的关键约束是:字段可以序列化,含义稳定,并且不引用按键对象、场景节点、网络连接等运行时对象。

为什么不要把结果写进输入指令
假设玩家释放冲刺技能,客户端最后移动到了 x=14.2。如果把这个位置直接作为“指令”发送,服务端收到的是客户端算出的结果,而不是可验证的意图。碰撞、体力和 Buff 状态稍有不同,两端就会产生无法解释的分叉。
更稳妥的边界是:指令保存方向、技能和持续时间等输入;模拟器根据当前权威状态计算位置、伤害、冷却等结果。这样同一条指令既能在客户端做预测,也能在服务端重新执行。
用序号建立可重放历史
下面的完整 Node.js 示例创建三条指令,将它们序列化保存,再从 JSON 恢复并交给同一个纯函数重放。为了让结果可复现,模拟函数只依赖初始状态和指令内容,不读取 Date.now() 或随机数。
const initialState = { x: 0, stamina: 100 };
const commands = [
{ seq: 1, clientTimeMs: 1000, skillId: "move", input: { dx: 2 } },
{ seq: 2, clientTimeMs: 1033, skillId: "dash", input: { dx: 5 } },
{ seq: 3, clientTimeMs: 1066, skillId: "move", input: { dx: -1 } }
];
function applyCommand(state, command) {
const next = { ...state };
if (command.skillId === "move") {
next.x += command.input.dx;
} else if (command.skillId === "dash") {
if (next.stamina < 20) return next;
next.x += command.input.dx;
next.stamina -= 20;
}
return next;
}
function replay(initial, history) {
return history
.slice()
.sort((a, b) => a.seq - b.seq)
.reduce(applyCommand, { ...initial });
}
const stored = JSON.stringify(commands);
const restored = JSON.parse(stored);
const result = replay(initialState, restored);
console.log(`commands=${restored.length}`);
console.log(`lastSeq=${restored.at(-1).seq}`);
console.log(`x=${result.x}, stamina=${result.stamina}`);预期输出:
commands=3
lastSeq=3
x=6, stamina=80这里故意按 seq 排序后再执行,因此即使记录文件或网络接收顺序发生变化,也能恢复发送方定义的逻辑顺序。真实项目还应检测重复序号和缺口,而不是发现异常后静默排序。
重放为什么仍可能不同步
“保存了指令”并不自动等于“重放一定一致”。如果模拟过程读取帧率相关的 deltaTime、未经固定种子的随机数、当前系统时间,或者客户端与服务端使用不同的碰撞规则,相同指令仍会得到不同结果。
因此排查不同步时,至少同时记录指令序号、客户端时间、服务端 Tick、关键模拟版本以及执行前后的状态摘要。发现差异后先定位第一条产生状态分叉的 seq,比只比较最终角色位置更容易找到真正根因。
可重放战斗指令的价值就在于把一次瞬时操作变成稳定证据:网络层可以发送和重试,服务端可以验证和排序,客户端可以依据确认序号重演,日志系统也能精确回答“从哪一条输入开始不同步”。