gameStarterKit — 游戏开发期基础框架

核心定位

开发期游戏基础框架

gono（gameStarterKit）把客户端、服务端和 shared 组织在同一份 monorepo 中，提供可替换的玩法接缝、本地调试和分层验证基础。

核心边界

源码与生成镜像分离
协议与公式单一真源
引擎接缝可替换
开发期规则可机检

SOURCE AVAILABLE · MIT查看仓库

架构地图

四层，各司其职

从源码入口到外部身份服务，职责边界先于业务扩张。

CLIENT纯 TS + Cocos 壳

SHARED协议 / 公式 / 错误码

SERVERRoom / RPC / 数据原语

HTTP账号契约隔离

MONOREPO ARCHITECTURE

契约同步链

一份 shared，抵达两个运行面

生成镜像可校验，源码入口始终明确；不在镜像目录手改文件。

SHAREDapps/shared/srcCLIENTapps/client/src/sharedCOCOSassets/src/shared

sync:shared · sync:clientverify:sync

REPLACEABLE DEMO

ballMove + 技能结算

用小球移动跑通登录、选服、进大厅、加入房间和状态同步；它是实现样例，不是通用玩法实现。

ROOM / GAME · PLAYING

Cocos · Colyseus · 60 FPS targetDEV ONLY

工程护栏

让约定可以被机器验证

类型、同步、FGUI、vendor 与性能基线共同守住开发期契约。

typecheck ENFORCED

verify:sync ENFORCED

test:client ENFORCED

test:fgui ENFORCED

LOCAL BASELINE12 guardrails

QUICK START

四步进入本地预览

安装依赖、同步 shared、启动本地栈，再打开 Cocos 工程。

INSTALLnpm install安装依赖
SYNCsync:shared刷新双端镜像
STACKstack + db:bootstrapRedis / MySQL
OPENnpm run dev + Cocos进入预览

4 steps

客户端

View / Logic 分层

View 绑定 Cocos/FairyGUI；Logic 保持纯 TypeScript，页面按需动态加载。

SOURCEapps/client/src源码真相
VIEWCocos + FairyGUI绑定与渲染
LOGICTypeScript行为与编排
UI LOADdynamic import按需加载

CLIENT BOUNDARY750 × 1624

服务端

Room / RPC 与写入原语

Colyseus 0.17 承载房间与 RPC；lock、fence、outbox 约束写入。

ROOMColyseus 0.17Lobby + Game
RPCtyped routes契约校验
DATARedis / MySQL热档与权威数据
GUARDSlock · fence · outbox写入一致性

SERVER RULESLOCAL STACK

CLEAR BOUNDARIES

这里是开发骨架，不是生产承诺

不构成部署、商业化承诺：支付、渠道、GM、多区拓扑、Unity、配表与托管属于额外参考；不会被说明站包装成已交付能力。

CORE SCOPEREFERENCE ONLYMIT LICENSETHIRD_PARTY_NOTICES.md

让 AI 更容易做游戏