跳到主要内容

规则、表现与平台的模块边界

好的游戏架构让你能找到一个规则在哪里决定、一个状态由谁拥有、一个资源什么时候释放。模块数量越多不代表边界越清楚。先让最重要的规则可以独立演算,再用引擎组件连接输入、表现与平台服务。

三个边界帮助降低耦合​

规则层决定生命、命中、波次、收益和胜负;表现层把状态与事件变成节点、动画、音效与UI;平台层处理存储、登录、网络、广告和生命周期。边界不是强制框架,而是帮助你避免多处同时决定一项事实。

输入适配 ──> 规则 update(state,input,dt)
│
├─> 当前状态 ──> 场景/HUD显示
└─> 业务事件 ──> 音效/特效/存档/服务端
平台回调 ──> 明确的规则命令或独立服务结果

本手册案例的 arenaRules.ts 不访问DOM、Cocos节点或平台存储;Cocos的Arena组件负责输入、固定步长、绘制与本地记录。站内Canvas教学版复用同一规则,规则测试可在Node中运行。这证明边界能够带来实际复用,而不是只为将来预留。

状态只有一个可信拥有者​

不要让角色组件、HUD和结算面板各维护一份生命值。规则状态是事实来源,HUD显示事实。临时动画可以有自己的播放进度,但不能据此悄悄改掉业务结果。服务端权威的货币与奖励,则需要与本地即时表现进一步区分。

事件应表达已经发生的事实,例如 enemyDied,并携带必要的ID、位置、攻击ID和时间。不要让监听者反过来依赖发射者的内部字段。事件总线也不是无成本连接器:监听生命周期、执行顺序和错误处理必须可追踪。

组件、状态机与ECS怎样选择​

组件化适合把节点行为按职责组织;状态机适合约束互斥阶段;ECS更强调数据布局与系统批处理。它们可以组合,也各自有成本。小型试炼用一个规则状态加几个适配组件就能清楚运行,不必先引入完整ECS。

当大量同类对象的更新与数据访问成为实测瓶颈,或多人协作需要更严格的系统边界时,再评估相应结构。不要因为AI能生成很多接口,就把一个单实现工具拆成工厂、容器与多层代理。

配置与运行状态分开​

配置决定初始参数与内容,运行状态记录当前生命、位置和计时。远程配置更新需要版本与兼容策略;运行中直接替换一张表,可能让同一局使用不同规则。对于回放、联机与反作弊,规则版本尤其重要。

type EnemySpec={readonly maxHp:number;readonly speed:number};
type EnemyState={id:number;hp:number;x:number;y:number};
function spawnEnemy(id:number,spec:EnemySpec):EnemyState{
return {id,hp:spec.maxHp,x:0,y:0};
}

只读类型表达意图,外部数据仍需运行时验证。不要把同一个可变对象既当配置又当实例状态,也不要把可变运行引用直接保存成历史快照。

架构失败如何识别​

增加一种敌人需要改十多个无关文件,可能说明条件分支散落;暂停后仍有系统更新,可能说明时间拥有者不清楚;换场景后旧奖励弹窗出现,可能说明业务结果与界面生命周期未分开。先根据具体失败找边界问题,再决定是否调整结构。

给AI的架构任务应要求它沿调用链解释,而不是只画漂亮的盒子:

请为本功能指出规则真相、表现状态、平台能力与资源生命周期各由谁负责。
给出最少模块、输入输出和一条从玩家输入到结果的实际调用链。
说明哪些代码可以独立测试,哪些必须在引擎/平台环境验证。
针对当前需求选择简单结构,并解释何种实测条件会触发升级。

验收架构时,尝试替换表现而保持规则测试,或替换存储适配而保持业务语义。若为了这些明确需求仍需复制整套逻辑,就需要重新检查职责;若目前没有这类需求,也不必追求无限可替换。

来源与边界​

核查日期2026-11-17。三边界划分与取舍是本手册的工程方案。