- 本示例适合作为游戏服务端的基础脚手架,开发者们可在此示例基础上发展出自己的游戏服务端方案。
- 示例中没有使用数据库,进程重启会还原所有数据
- 客户端演示分为两种:
robot_client
为go实现的游戏压测客户端,使用tcp/protobuf
协议nodes/web/view/
为h5实现的游戏客户端,使用websocket/protobuf
协议
- 欢迎开发者一起入群讨论(
QQ群:191651647
),构建更好的cherry
生态。
- GO >= 1.18
- nats.io >= 2.0
- 参数配置文件在
../config/demo-cluster.json
- 策划配置文件在
../config/data/
git clone https://github.com/cherry-game/cherry.git
- 或者点击github.com页面的
code
按钮Download zip
下载源码包 - 打开项目源码,找到
demo_cluster
目录 - 请参考环境安装与配置 进行准备工作
nats为高性能的分布式消息中间件,详情可通过
https://github.com/nats-io/nats-server
进行了解。 本框架中所有节点都基于 nats 进行消息通信。 正式环境请使用集群 nats-streaming-server 进行部署https://github.com/nats-io/nats-streaming-server
- Windows:
3rd/nat-server/run_nats.bat
- Mac:
nats-server
窗口显示
Listening for client connections on 0.0.0.0:4222
代表 nats 启动成功,nats 默认监听4222
端口
- 找到
demo_cluster/nodes/main.go
,所有节点都从main.go
启动 VSCode
用户在左侧栏找到运行和调试(Debug)
按钮,启动gc-master
、gc-center
、gc-web-1
、gc-gate-1
、gc-game-10001
GoLand
用户配置启动参数(Program arguments
)如下:gc-master
master --path=./config/demo-cluster.json --node=gc-mastergc-center
center --path=./config/demo-cluster.json --node=gc-centergc-web-1
web --path=./config/demo-cluster.json --node=gc-web-1gc-gate-1
gate --path=./config/demo-cluster.json --node=gc-gate-1gc-game-10001
game --path=./config/demo-cluster.json --node=10001
- 使用 go 实现客户端,通过 tcp 协议连接 gate 网关进行压力测试
- 使用 h5 实现客户端,通过 websocket 协议连接 gate 网关进行功能的展示
- 找到
demo_cluster/robot_client/main.go
文件,并执行 - 机器人执行逻辑为:
注册帐号
,登陆获取token
、连接网关
、用户登录游戏服
、查看角色
、创建角色
、进入角色
- 默认设定为创建1000个帐号,可自行调整
maxRobotNum
参数进行测试 - 执行完成后,从game节点的
Console
可以查看到onlineCount = 50000
字样
- 直接访问
http://127.0.0.1:8081
,按照界面步骤提示操作。- 端口以 web 进程打印的具体的值为准,如果发现端口被占用,请搜索并替换。
-
internal
内部业务逻辑code
定义一些业务的状态码component
组件目录,check_center
组件, 用于在启动前节点先检查center
节点是否已启动
constant
一些常用定义data
策划配表包装的struct,用于读取../config/data
目录的策划配表event
游戏事件guid
生成全局idpb
protobuf生成的协议结构protocol
protobuf结构定义目录rpc
跨节点rpc函数封装session_key
一些session相关的常量定义token
登录token逻辑,包含生成token、验证tokentypes
各种自定义类型封装,方便struct从配置文件、数据库读取数据时进行序列化、反序列化
-
nodes
分布式节点目录center
节点game
节点gate
节点master
节点web
节点(为了演示方便,包含了h5客户端)
-
robot_client
压测机器人(tcp/protobuf协议) -
build_protocol.bat
生成protobuf结构代码到internal/pb/
目录
- master 节点主要用于实现最基础的发现服务,基于nats构建。
- 正式环境也可配置为etcd方式提供发现服务。
- 相关的代码在
demo_cluster/master/
目录。
- center 节点目前主要用于处理帐号相关的业务或全局唯一的业务
- web 节点主要对外提供一些http的接口,可横向扩展,多节点部署。
- 目前用于开发者帐号注册、区服列表、sdk登陆/支付回调、验证token生成等业务。
- gate 节点为游戏对外网关,可横向扩展,多节点部署。
- 主要用于管理客户端的连接、消息路由与转发。
- game 节点为具体的游戏逻辑业务,根据业务需求可多节点部署。
- 在分服的游戏中可提供游戏内的各种逻辑实现。