# RillServer-skynet-gameserver-framework-lua

**Repository Path**: guolsh/RillServer-skynet-gameserver-framework-lua

## Basic Information

- **Project Name**: RillServer-skynet-gameserver-framework-lua
- **Description**: RillServer是一套基于skynet的通用游戏服务端框架，适合大作战、棋牌、RPG、策略等多种类型的游戏服务器。设计初衷是为了极大的提高开发效率，减少游戏开发成本
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2026-06-09
- **Last Updated**: 2026-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 说在前面的话 
1、该框架并非本人设计 详细设计思路可以探讨也可以咨询原作者 链接：https://github.com/cloudfreexiao/RillServer
2、在原版本基础上修改如下几点：
   a、完成运行问题的修复，保证基础demo能跑通
   b、测试mysql数据库的使用
   c、修改用户快速登录问题
   d、修改room创建模式，改为lua service pool模式，仿照agent pool修改
   e、框架细微调整

# RillServer
RillServer是一套基于skynet的通用游戏服务端框架，适合大作战、棋牌、RPG、策略等多种类型的游戏服务器。设计初衷是为了极大的提高开发效率，减少游戏开发成本。

总要取个名字，Rill小河，喻意服务畅通无阻，亦表积流成海。假以时日，厚积薄发。


## 整体架构
RillServer采用传统c++服务器的架构方案。服务为1:1对应(agent room) 

### 架构图
整体架构如下图所示，蓝色方框代表skynet节点，黄色方框代表服务，一个节点会开启game、global、login等多种服务。灰色方框代表gateway的转发范围，即客户端连上某个节点的gateway，该gateway只会将消息转发给该节点下的login和game。
![Alt text](./doc/img/1.jpg)

### 各个服务的功能：

* gateway：门，客户端只连接gateway，如果玩家尚未登录，gateway会把消息发给login，如果登录成功会转发给game
* login：登录服，处理登录逻辑
* game：游戏服，处理玩家逻辑
* center：中心服，记录玩家登录状态等信息
* global	全局服，可在此实现跨服战等功能
* dbproxy：数据库代理，使用服务不直接操作数据库，只操作dbproxy
* host：主机，用于集群控制，如热更新、关服，以及web
> ps：
> 1、一个节点的gate只会连接该节点的login和game，login和game可以连接跨节点的center、global和dbproxy。
> 2、暂时未实现cache层。
> 3、框架尽量不修改skynet代码，以便后续升级，但有些功能需要插入到原来代码里，升级时候务必修改这一部分。这些修改不会涉及核心部分，一般是增加控制台功能。若升级skynet，应该把这一部分抽出来。
>skynet/lualib/debug.lua
>skynet/service/debug_console.lua
>skynet/service/launcher.lua

### 文件目录
* config：策划配置文件夹
* etc：服务配置文件夹
* luaclib：一些c模块, .so文件
* lualib：lua模块
* lualib-src：c模块代码
* mod：游戏逻辑模块
* proto：protobuf文件，若使用pb协议需要把proto文件放在里面
* run：记录pid等信息
* service：服务入口地址，服务开启后会读取mod里对应模块
* skynet：skynet框架，这里尽量少改动它，以便后续更新
* test：例子

## 入门
入门章节将会介绍开启服务器以及实现echo程序，若还不太熟悉skynet和服务端编程，欢迎参考 [游戏研究院](https://zhuanlan.zhihu.com/pyluo) 中的文章。

### 编译

下载代码后需要编程程序，只需要运行目录下的./make.sh all即可。服务端默认使用websocket+json的通信协议。

> **protobuf协议**
> 只要改配置就能够支持tcp（头两字节代表长度）+protobuf的格式。 服务端使用LuaPbIntf解析protobuf协议，如果使用protobuf协议，需要安装protobuf，具体如下：
>  yum nstall autoconf 
>  yum install automake 
>  yum install libtool
>  yum install glibc-headers gcc-c++
>  cd lualib-src/LuaPbIntf/third_party/protobuf
> ./autogen.sh
>  ./configure CFLAGS="-fPIC"  CXXFLAGS="-fPIC" 
>  make 
>  make install
>  vim /etc/profile，添加  LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib
>   ldconfig
>
>源码中对LuaPbIntf稍有改动，以适应协程下的protobuf编码解码

### 运行
修改etc/runconfig.lua中的端口号，然后执行./start.sh即可开启一个游戏节点。

### echo
具体请参考示例1


----

## 示例
* 示例1 echo
	    服务端./start_node1.sh 即可运行服务端（单阶段）
	    客户端 cd test ../skynet/3rd/lua/lua 1-echo.lua
* 示例2 name  
        数据库保存测试
* 示例3 chat	
* 示例4 movegame	
* 示例5 读配置
* 示例6 日志
* 示例7 代码热更新，配置热更新
* 示例8 排行榜
	排行榜查询次数的排行榜，演示global保存数据
* 示例9 数据库断线重连
        使用示例1登录，关闭数据库，测试，重开数据库，测试  
* 示例10 关服功能
* 示例11 pb协议
* 示例12 xx大作战





----


## 可以改进
*  [优化] 监视功能
*  [测试] 性能测试
*  [优化] game改成agentpool那样的，按需开启
*  [优化] 玩家存储：加一层redis
*  [必须] web鉴权
*  [必须] 未测试 mongodb  修改成mysqldb的形式。
*  [优化] web单独提取
*  [优化] 提取修改skynet的部分，不要修改skynet所有源码
*  [优化] log功能
*  [优化] 同一账号快速登录会出现问题
*  [bug]  watch game列表，recmmad列表（可能出错）
*  [bug]  大作战高并发下，不发送sync协议


## 已经发现的注意点
bson：bson会把key都存为string，读取时要tonumber处理
由于dataSheet在init阶段初始化，而awake、start在init阶段前执行，修改skynet/lualib/skynet/datasheet/init.lua的querysheet函数，增加if datasheet_svr == nil then datasheet_svr = service.query("datasheet") end


内网改的
tool增加表拷贝
将player相关的都放到player文件夹（new load_data load_all_data save_all_data），改为读取pb结构保存{playerid,pbstr}