用途:为 OpenCivilizations(基于网页的 MMORTS)提供架构与代码规范,在实现类任务中自动应用以保持一致性。
技术栈约定:语言为 TypeScript strict;游戏引擎为 Phaser 3;UI 采用 React 或 Vue 作为覆盖层;后端为 Node.js 加 Colyseus;数据库为 MongoDB;缓存为 Redis。
关键文档:docs/architecture.md 描述系统设计;shared/constants.ts 存放游戏平衡数据;shared/types.ts 存放类型定义。
领域模型:Base 为玩家文明布局;Building 为网格上的建筑(TownCenter、Farm、Barracks);Unit 为带 AI 行为的可训练部队;Resource 为 Food、Gold、Oil;Age 为科技时代(Stone、Bronze、Iron 等);Nation 为带独特加成的文明。
项目结构:client/src 下含 assets(精灵、图块、音频)、game(scenes 场景、entities 实体、systems 系统)、ui(React/Vue 覆盖层);server/src 下含 rooms(Colyseus 房间)、models(MongoDB 模式)、mechanics(权威逻辑);shared 存放常量与类型。
代码规范:TypeScript strict,无正当理由不得使用 any;服务器权威,不信任客户端输入;客户端预测,展示乐观更新并与服务器对账;用 Colyseus 模式同步多人状态;MongoDB 持久化基地布局与用户数据;Redis 管理会话、排行榜等。资料未提供安装命令、收费与具体使用步骤。