CivGenesis
文档
Quickstart
设计
协议
SDK
Protobuf
观测
Jobs
IPC
Nacos
gRPC
Dispatcher
集成
GitHub
文档
Quickstart
设计
协议
SDK
Protobuf
观测
Jobs
IPC
Nacos
gRPC
Dispatcher
集成
GitHub
  • 指南

    • Quickstart(示例工程)
    • CivGenesis 设计(草案)
    • 协议与会话(草案)
    • Protobuf:消息定义与生成(Java / Unity / TypeScript)
    • 可观测性:Prometheus Metrics + OpenTelemetry Tracing
    • 后台任务(本地 / 分布式)
    • 客户端 SDK(Unity / Cocos / LayaAir)
    • Dispatcher 与注解路由(草案)
    • 进程间通信(IPC)与服务发现(草案)
    • Nacos 注册中心(默认实现)
    • gRPC(与 Node.js 战斗进程互通)
    • 时间轮定时系统(草案)
    • 配置项建议(草案)
    • 安全基线(草案)
    • 系统消息(protobuf)草案
    • 集成指南(不含业务逻辑)
    • 热更新(兼容 Arthas redefine)草案

Quickstart(示例工程)

本仓库提供最小示例:examples/echo-server/(不包含任何玩法逻辑)。

1) 运行服务端

./gradlew :examples-echo-server:run

默认监听:

  • WS:ws://127.0.0.1:8888/ws

2) 推荐交互流程(客户端)

示例流程(协议层):

  1. ClientHello(msgId=1)
  2. Resume(msgId=3),token 传 1 或 p:1(示例鉴权实现会解析为 playerId=1)
  3. 业务请求 Echo(msgId=1000):
    • 请求/响应:examples/echo-server/src/main/proto/echo.proto 的 EchoReq/EchoResp
  4. 触发全量快照 Sync(msgId=4):
    • 服务端会 PUSH(SyncSnapshotPush)(可用于演示断线恢复与可靠推送)

注意:本仓库的 Unity/TypeScript SDK 是“协议层 SDK”;业务 Protobuf(如 EchoReq/EchoResp)需要你在客户端侧自行生成并在业务层解析。

Edit this page
最近更新: 2025/12/31 16:07
Contributors: cuihairu
Next
CivGenesis 设计(草案)