跳转到内容

KBE 参考原则 ​

参考 KBEngine 的机制与工程边界,Apollo 的职责和命名以当前架构决策为准。外部引擎进程名保留其真实含义,不作为 Apollo 的候选进程清单。

运行时与生命周期 ​

借鉴统一启动入口、公共服务运行时和明确的启停顺序。Apollo 复用现有宿主和模块装配能力,业务应用通过组合接入服务;避免让各入口分别实现依赖、生命周期与关停语义。

目标进程固定为 gateway、loginServer、baseServer、worldServer、cell、database、machined。Base 管长期资料,World 管 Space/Cell 拓扑,cell 管模拟,database 管实际存储访问,loginServer 托管认证与目录;具体接线见服务器应用。

实体、契约与脚本 ​

借鉴实体元数据驱动属性、远程调用、脚本绑定和客户端代码的思路。Apollo 使用 XML/XSD 契约和生成器,服务端与客户端围绕同一契约生成产物。

线上契约、存储形式和脚本执行机制保持各自边界。契约声明或生成产物存在,不代表真实消息路径已经采用某种编码、版本协商已经完成,或数据库已经接入。

Lua 使用现有 ScriptRuntime 和 C API 绑定。脚本不能从网络或后台线程直接改写 Scene,也不能通过容器字符串查找绕过启动期服务注入。

模拟与可见性 ​

借鉴空间运行时持有实体、AOI 和可见性状态的边界,Apollo 的对应对象是 Scene。Instance 关联 Scene,负责临时副本起止,复用既有八态生命周期。

跨服仍使用 World / Scene / Instance,保留玩家原区服归属并显式交接权威。跨服场景可以是持续场景,也可以关联临时 Instance;它不要求 Ghost、空间分片或无缝地图。详见跨服场景设计。

通信与权威 ​

消息传输、受理、模拟执行和持久确认是不同结果,需要各自的关联与失败语义。可靠链路不提供业务恰好执行一次,迁移和结算仍需幂等键及权威代次。

长期资料由唯一 Base 修改,场景状态由唯一 Cell 权威执行者模拟;两类数据边界分别交接。跨服不移动 Base/数据库归属;待接管场景目标保持不活动,提交结果不明先对账,禁止双端模拟。

运维与恢复 ​

借鉴监督、结构化观测和受控管理入口,复用 machined、日志、指标和运行时内省原语。监督重启不等于恢复活动副本,目录重建不等于恢复玩家的唯一写权。

故障演练必须使用当前应用链路,验证档案、权威、路由和玩法结果;不能用旧进程拓扑的测试记录作为当前验收证据。

当前范围与预留 ​

Apollo 当前默认每 Space 一个 Cell;worldServer 管理分配,cell 执行模拟。预留无缝地图、Ghost 和同空间拓扑扩展,暂不实施切分与复制算法。保留现有 Scene 代码名,按 Space 语义对照,不新增同义容器。

机制是否采用取决于当前玩法、容量与故障恢复需求。未启用的跨服部署、外部存储和观测基建继续按照根目录任务清单中的触发条件实施。

基于 MIT 许可发布