跳转到内容

Apollo轻量副本制多人在线游戏服务器引擎

C++20 运行时,面向塔防、合作玩法、竞技场和副本;MMO 是可能的产品形态,当前优先副本玩法,预留无缝地图设计。

Apollo

目标架构 ​

业务消息经 gateway 直达所属 Base 或当前 cell;world 管理分配与拓扑。实线表示业务请求与结果,虚线表示注册与管理。

Apollo 进程架构:world 为管理端(注册/拓扑/容量/迁移),cellServer 为独立模拟执行端(Scene/Avatar/AOI/战斗/Lua),二者经 960 注册/961 裁决/962 分配/963 retire/967 自报 协调;Base 管玩家档案与基础业务并经 database 持久;gateway 直达 Base 与 cell;interfaces 接平台回调;machined 拉起并监督各进程;logger/admin 收集日志与指标。Apollo 进程架构:world 为管理端(注册/拓扑/容量/迁移),cellServer 为独立模拟执行端(Scene/Avatar/AOI/战斗/Lua),二者经 960 注册/961 裁决/962 分配/963 retire/967 自报 协调;Base 管玩家档案与基础业务并经 database 持久;gateway 直达 Base 与 cell;interfaces 接平台回调;machined 拉起并监督各进程;logger/admin 收集日志与指标。
目标设计图;实际接线与实现状态以应用说明为准。查看矢量原图

外部 HTTP 回调与开发入口 ​

支付和渠道回调由可选 interfaces 的 HTTP/HTTPS 入口接收;可靠保存后,按稳定玩家身份解析当前 Base,由 Base 校验并经 database 幂等发货。玩家离线不依赖 gateway 会话,Base 承载迁移后重新解析归属。游戏 WS/WSS 属于 gateway 的游戏消息入口,与 TCP 共用同一条已验收的游戏帧路径,不进入 HTTP handler。

Apollo 外部回调与发货:interfaces 可靠受理链、按归属代次解析当前 Base 与幂等发货模块已落地;渠道验签与进程间接线规划中;apolloc init 脚手架已交付,CI 在仓库执行。Apollo 外部回调与发货:interfaces 可靠受理链、按归属代次解析当前 Base 与幂等发货模块已落地;渠道验签与进程间接线规划中;apolloc init 脚手架已交付,CI 在仓库执行。
目标设计图;实际接线与实现状态以应用说明为准。查看矢量原图

实现状态:gateway 游戏 TCP/WS/WSS 入口已验收(含 WSS 证书链/主机名错误拒绝与密钥配置负例);interfaces 受理链(原始请求帧逐字节保留、请求超时与受理队列预算、有界单写者)与渠道验签 gate(HMAC-SHA256 按剥离签名头行的原始帧验签,缺签/改签/改体 401,签名格式与体长声明错误 403,摘要定长比较)、订单事务域(持久受理与待办、按归属代次解析当前 Base、发货去重凭据原子提交)与 apolloc init 脚手架均已落地并有测试覆盖;渠道回调 → 订单受理接线与发货 executor、base 写权生命周期(奖励落账)仍规划中。对照证据见 Mistlane 与旧 FOGS 核对,开发任务见根目录 todo.md。

进程、工具与 CI ​

  • 运行进程:gateway、login、base、world、database、interfaces、machined;cell 为 world 二进制的执行角色。gateway 提供游戏 TCP/WS/WSS 入口(已验收),interfaces 提供 HTTP/HTTPS 回调入口(受理链已落地)。
  • CLI 工具:apolloc(项目初始化 init,已交付)、fleetctl(编队量测断言)、admin 与 logger(观测辅助)——都是开发工具,不是在线业务进程。
  • CI:GitHub Actions(构建/测试、契约、文档)在仓库执行,不参与在线业务。

项目定位 ​

Apollo 是轻量副本制多人在线游戏服务器引擎,适合塔防、合作 PvE/PvP、竞技场和副本。MMO 是可能的产品规模或产品形态,不是服务端架构名称;当前不实现无缝地图,预留同 Space 多 Cell、邻接可见性与权威交接。

目标链路:客户端经 gateway 分别访问所属 Base 的基础业务和当前 cell 的场景模拟;Base 经 database 读写长期资料,login 提供认证与目录,machined 按需监督本机进程。跨服只改变场景位置,保留原存储归属,Base 承载按独立调度更新。

文档入口 ​

主题文档
目标架构架构总览
目标名称与边界概念与命名
当前程序原型服务器应用
World 和跨服迁移设计副本制 GameServer 设计
代码构建构建指南
BigWorld 与 Apollo 体系对照职责、概念与代码映射
外部引擎对照MMO 框架比较

BigWorld/KBEngine 的 BaseApp、CellApp 等真实名称保留用于外部比较。Apollo 固定使用 base 管长期资料、world 管 Space/Cell,cell 管模拟,完整名称见词汇表。

基于 MIT 许可发布