qipai-server - 牛马平台游戏服务器（C++，麻将/斗地主/比鸡/牛牛）

项目说明

其他语言版本: English, 中文.

测试客户端

项目当前部署了公网上的测试客户端，欢迎下载测试:\
下载地址

NiuMa游戏平台游戏服务器(C++)

本项目是使用C++开发的棋牌游戏逻辑服务器，实现棋牌游戏的后台服务逻辑，例如麻将游戏功能逻辑与流程控制等。客户端与本服务建立TCP连接通信，并通过MessagePack序列化方案进行消息交互。本服务依赖的第三方组件包括：MySql 8.0+、Redis以及RabbitMQ，本服务支持跨平台部署，轻量化设计使得在部署时无需安装太多依赖，基于整体分布式架构设计，本服务器可以根据业务情况进行服务实例弹性横向扩展。本服务设计的一大特点是功能模块简洁明了，代码逻辑思路清晰，核心模块高度抽象和可复用，开发者很容易掌握并进行功能扩展和维护。

游戏服务器核心设计

游戏服务器的核心模块包括：网络IO、线程模型、消息分发及处理，这三个核心模块从根本上影响着服务器整体并发性能。本项目网络IO使用的是boost::asio框架，如下图所示，一个TCP会话(Session)代表着一个客户端与服务器的TCP网络连接，这里将一个完整的游戏逻辑单元定义为一个游戏场地(Venue)，例如一张棋牌桌就是一个游戏场地，每个游戏场地有全局唯一ID，初始化时创建一个专门处理场地内部逻辑的线程池，线程池中每个线程包含设定数量的消息处理器(Message Handler)，系统中所有消息处理器都会注册到一个单例的消息处理器列表中，当新建一个游戏场地时，该场地会根据负载情况分配到当前负载最轻的消息处理器，因此一个消息处理器维护了一个场地列表，由此一个场地的所有游戏逻辑和消息处理都在同一个线程内执行，这避免了多线程的数据同步问题，以及复杂容易出错的异步调用问题。当TCP会话收到一个消息时，网络接收线程遍历消息处理器列表，一旦列表中有一个消息处理器接收该消息即结束遍历，因为所有场地内的消息都携带了场地ID字段，可以用于哈希表匹配，所以遍历是一个非常快速的一个过程。\
!核心设计

系统后端架构设计

系统包含两种不同处理方式的业务逻辑，一种为上述的游戏功能业务逻辑，由C++游戏服务器进行处理；另一种则是登录及游戏主界面(游戏大厅)的业务逻辑，由WEB服务器进行处理，通过HTTP Restful接口进行通信，同时WEB服务器还负责根据游戏服务实例的负载情况进行游戏场地分配，例如当玩家新建一个斗地主游戏房间时，会把创建请求发送到WEB服务器，WEB根据所有游戏服务实例的负载情况，将新建的房间分配到当前负载最轻的游戏服务实例，并向客户端返回该游戏服务实例的连接信息(IP、端口)，客户端再与该游戏服务实例建立TCP连接，从而完成进入该游戏房间，并开始游戏业务逻辑。

系统后端采用分布式架构设计，由WEB服务基于全局Redis的数据记录进行负载决策，游戏服务实例实时更新它的负载情况到全局Redis数据库中，每个WEB服务实例都可以独自进行负载决策，因此系统中不需要统一控制的中心和路由服务器实例，并使得游戏服务和WEB服务可以根据实际业务量进行灵活节点部署，同时也不需要担心单节点性能瓶颈问题。WEB服务实例与游戏服务实例之间通过RabbitMQ进行交互通信，服务器之间的查询调度可以简单、有序且高效地进行。\
!架构图

编译(Ubuntu环境)

首先确保系统已经安装了cmake 3.30版本以上，按照以下步骤编译游戏服务：

1、编译安装boost库(具体可参考网上教程)

2、安装编译rabbitmq-c

3、安装mysql-concpp

4、编译游戏服务

将server.ini配置文件也复制到bin目录，并按照格式修改相关配置信息

技术栈

开发语言：未知

项目类型：牛马平台游戏服务器（C++，麻将/斗地主/比鸡/牛牛）

Star 数：0

功能特点

这是一套牛马平台游戏服务器（C++，麻将/斗地主/比鸡/牛牛），代码结构清晰，适合开发者学习棋牌游戏的服务端与客户端开发。项目涵盖了棋牌游戏的核心玩法逻辑、网络通信、用户管理、房间匹配等模块，对理解棋牌类游戏的完整开发流程具有较高的参考价值。

从技术实现角度看，棋牌类项目的难点在于：游戏逻辑的状态机设计、并发房间管理、牌型算法、以及服务端与客户端的协议同步。本项目在这些方面提供了可运行的实现，开发者可以在此基础上进行二次开发或学习研究。

部署说明

1. 下载源码压缩包，解压到本地开发环境。

2. 根据项目类型准备对应的运行环境（Node.js / Go / C++ / Java 等）。

3. 按照 README 中的步骤配置依赖、数据库和配置文件。

4. 先启动服务端，再启动客户端，即可进入游戏进行测试。

注意：本项目仅供学习研究使用，请勿用于商业或非法用途。

学习价值

对于想进入棋牌游戏开发领域的开发者来说，这套源码是一个很好的入门参考。通过阅读代码，可以学习到棋牌游戏的核心玩法实现、网络协议设计、房间与匹配机制、以及游戏状态管理等关键技术点。

同时，项目中的代码组织方式和模块划分，也展示了棋牌类项目在工程化方面的实践经验，值得开发者深入研究和借鉴。理解一个完整棋牌项目的架构，对后续开发其他实时对战类游戏也很有帮助。

免责声明

本资源来源于开源社区，仅供学习研究和技术交流使用，请勿用于任何商业或违法违规用途。使用本项目产生的一切后果由使用者自行承担。若涉及第三方权益，请联系删除。