Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs: RC11 N5 authoritative host lands — the replication campaign core is complete

esenginef9a6adace350
diff --git a/docs/REARCHITECTURE.md b/docs/REARCHITECTURE.md
index fd3c01a5b..f09387465 100644
--- a/docs/REARCHITECTURE.md
+++ b/docs/REARCHITECTURE.md
@@ -223,11 +223,12 @@ TS 驱动的主 pass clear 退出边界,`clear` 家族退出公共 RHI:
### RC6 资产管线 — 📋 已立项(设计文档)
见 [`REARCH_RC6_ASSETS.md`](./REARCH_RC6_ASSETS.md):面向微信/移动端的资产管线根治——GPU 压缩纹理(keystone)、内容寻址身份、显存预算 + LRU 驱逐、运行时分包/流式 + 微信分包映射。属"能力/平台错配"根治,区别于 RC1–RC5 的"正确性根因"。
-### RC11 网络复制 — 🟡 N0–N4 已落地(2026-07-08);剩 N5 宿主故事
+### RC11 网络复制 — ✅ N0–N5 已落地(2026-07-08);余项为编辑器联调工作流与需求驱动的后置
设计文档 `REARCH_REPLICATION.md`(本地 gitignore,同 RC6 约定);四维度审计后拍板**服务器权威状态复制**(lockstep 需全 gameplay 确定性、回滚需物理可 rewind——Box2D v3 官方无 rollback;均与底座冲突)。
- **N0 声明底座**:RC9-1 P4 尾巴收口——EHT 发射 `replicatedFields`/`skipSerializeFields`(`animatableFields` 同款范式,注解不进 ABI hash);`defineComponent` 收 `replicatedFields` metadata(未知字段名 fail-loud);`getReplicatedFields()` 统一 builtin/user 两权威源。Transform 局部姿态 + Velocity 首批注解。顺带根修 PrefabServer 在 build 期捕获 stale Assets 的 bug(play/cooked 下 uuid prefab 实例化走错解析通道)。
- **N1 传输收编**:socket 创建收进 `PlatformAdapter.createSocket?`(web/wechat 已接,'node' 预留),`createSocket` 工厂不再嗅探 `globalThis.wx`;`NetChannel` 增二进制面(1 字节 channel id,与 JSON 控制面共享一条 transport);`MemoryTransport` 进程内对(manualFlush 模拟时序/丢包)= 双 App 对拍测试基石。
- **N2 复制核心(keystone)**:复制运行时 = 普通 plugin + 现有调度(FixedPre 收/应用、FixedPost 采样/广播,与物理同 cadence;无第二 tick 循环——FSM/BT 统一裁定的延续);`Time.fixedTick` 新增为仿真时间轴。单一声明驱动全管线:wire 表按名排序自 `getReplicatedFields` 构建、字段 shape 自组件 defaults 派生;握手比对 协议版本+ABI hash+逐字段 schema,不一致拒连。状态走二进制 delta 帧(per-field dirty mask,服务端 shadow diff;WebSocket 可靠有序故无需 ack);spawn/despawn 走 JSON 控制面,spawn 载荷复用场景序列化原语(新 `serializeEntityComponents`)→ 校验/out-of-band codec 免费、late joiner 拿到当前态。Entity 句柄不过网——NetId 双端映射(entity-ref 字段重写含内)。`Replicated`/`NetGhost` 纯 TS 组件;`NetSession` 角色资源门控,plugin 无条件安装、offline 零开销。验证:14 用例进程内双 App 对拍(握手负例/spawn/delta/静默/late-joiner/despawn/codec 往返)+ **真边界用例**(C++ Transform 注解在两个 wasm Registry 间 f32 精确复制);全套 2938 + desktop tsc + 24 examples 绿。
- **N3 快照插值**:delta 帧落进 per-field 时间序列(稀疏 delta 无需重建全快照);渲染时钟落后最新服务器 tick 一个可配延迟(默认 2),PostUpdate 逐帧采样——f32 标量/向量叶 lerp、四元数就近 cover nlerp、离散值 hold 到样本时刻;时钟按渲染时间推进 + 向目标软纠偏(burst 抖动弯时间而非瞬移),钳在最新数据(不外推)故静默后精确收敛到终值。`interpolationDelayTicks:0` = N2 立即语义(N2 闸门测试钉住)。
- **N4 输入上行 + ownership**:客户端 seq 戳输入命令走控制面(乱序旧包永不覆盖新态);服务器按连接存最新、`inputOf(connectionId)` 暴露给 gameplay(FixedUpdate 里对 `Replicated.owner` 的实体应用输入 = 普通 ECS 代码);客户端 `ownsEntity()` 判"这个 ghost 是不是我的"。全环路测试:客户端输入 → 服务器积分 → ghost 落在权威结果上。验证累计 26 复制用例 + 全套 2949 绿。
-- **待续(N5 宿主故事)**:node 平台适配器(fetch/readFile/instantiateWasm 薄层 + `createSocket` 的 ws 侧)+ `createHeadlessApp`(createWebApp 减渲染装配)+ 真 WebSocket e2e(node 权威服务器 + headless 客户端;服务器侧 ws 库选型待拍板)+ 编辑器多 PlayRealm 联调(`PlayRealm.ts` 单例改实例,审计确认无结构障碍)。另有已识别的后置项:ghost 物理/AI 让位门控语义(RigidBody ghost 是否强制 kinematic)待真实 demo 驱动拍板;`#pragma switch` 用户 shader 手写孪生残余(WGSL 战役遗留,与本战役无关)。
+- **N5 权威宿主**:同一 wasm + 同一 gameplay 代码跑无头 Node 游戏服务器。新 `esengine/node` 入口——node 平台适配器(文件系统优先的资产访问、socket 走全局 WebSocket(Node≥22)、静音 `NullAudioBackend`、无 DOM,渲染性能力 fail-loud)、`loadEsengineModule`(emscripten glue 原生跑 Node)、`createHeadlessApp`(全仿真栈:assets/prefabs/scenes/timers/AI/replication,零渲染/管线/输入/UI)+ `runHeadless` 墙钟循环;`lifecyclePlugin` 不再假定 DOM。服务器侧 ws 拍板:SDK 零运行时依赖——宿主自选接收端(`ws` 仅 devDependency 供 e2e),任意 socket 包成 `NetTransport` 即 `attachConnection`。验证:真网络栈 e2e(无头服务器+真 wasm 接受 `ws` 连接 → 注解 builtin Transform + 用户组件复制到 `GameSocket` 客户端 → 输入回传)+ 纯 Node 冒烟(dist 入口加载引擎 wasm 起权威服务器步进)。
+- **余项**:编辑器多 PlayRealm 本地联调工作流(`PlayRealm.ts` 单例改实例 + utilityProcess 起本地服务器,审计确认无结构障碍——独立的编辑器 UX 工作项);headless 资产模式(服务器加载含纹理场景需"跳过纹理/音频驻留"通道,现为 fail-loud);ghost 物理/AI 让位门控语义(RigidBody ghost 是否强制 kinematic)待真实 demo 驱动;本端预测+和解、relevancy/兴趣管理、C++ 批量快照优化、带宽量化——全部需求驱动不抢跑。