三国SLG游戏服务器Demo快速入门指南

简介

本文档将帮助Go语言初学者快速理解并运行基于Go语言开发的三国SLG游戏服务器Demo。该项目提供了一个完整的游戏服务器架构，包括多个服务组件和丰富的游戏功能模块。通过本文档，你将能够快速搭建开发环境，理解服务器架构，并成功运行游戏服务。

核心组件解析

服务架构

该游戏服务器采用微服务架构，由多个独立的服务组成，每个服务负责特定的功能模块：

• 登录服务 (main/loginserver.go): 处理用户登录验证和会话管理
• 网关服务 (main/gateserver.go): 负责客户端连接和消息转发
• 游戏服务 (main/slgserver.go): 核心游戏逻辑处理，包括战斗、资源管理等
• HTTP服务 (main/httpserver.go): 提供RESTful API接口
• 聊天服务 (main/chatserver.go): 处理玩家间的聊天通信

核心功能模块

1. 游戏逻辑模块 (server/slgserver/):

   • 部队系统: 管理武将和部队配置
   • 城市系统: 处理城池建设和资源管理
   • 战斗系统: 实现战斗逻辑和战报生成
   • 联盟系统: 支持玩家创建和管理联盟

2. 数据管理模块 (db/):

   • 数据库连接管理
   • 数据持久化操作

3. 网络通信模块 (net/):

   • 客户端连接管理
   • 消息路由和处理

4. 配置系统 (config/, data/conf/):

   • 环境配置
   • 游戏数据配置

快速启动指南

环境准备

1. 确保已安装Go环境 (1.13及以上版本)
2. 安装MySQL数据库 (5.7及以上版本)
3. 克隆项目代码库:

   git clone https://gitcode.com/gh_mirrors/sl/slgserver
   cd slgserver
   

数据库配置

1. 创建数据库:

   mysql -u root -p
   CREATE DATABASE slgdb;
   exit
   

2. 导入数据库结构:

   mysql -u root -p slgdb < data/conf/db.sql
   

3. 修改数据库配置文件 data/conf/env.ini:

   [mysql]
   host=127.0.0.1
   port=3306
   user=root
   password=你的数据库密码
   dbname=slgdb
   

编译与启动

1. 编译所有服务:

   go build -o bin/chatserver main/chatserver.go
   go build -o bin/gateserver main/gateserver.go
   go build -o bin/httpserver main/httpserver.go
   go build -o bin/loginserver main/loginserver.go
   go build -o bin/slgserver main/slgserver.go
   

2. 复制配置文件:

   shell/copydata.bat
   

3. 启动服务 (按顺序):

   bin/loginserver
   bin/gateserver
   bin/slgserver
   bin/chatserver
   bin/httpserver
   

注意: 所有服务需要同时运行，建议使用多个终端窗口分别启动

服务启动架构

服务间交互关系

游戏服务器各组件之间通过网络进行通信，形成一个有机整体:

1. 登录流程:

   • 客户端 → 登录服务器 → 数据库验证 → 返回会话令牌
   • 客户端使用令牌连接网关服务器

2. 游戏逻辑处理:

   • 客户端 → 网关服务器 → 游戏服务器 → 数据库
   • 游戏服务器处理核心业务逻辑，如部队移动、战斗等

3. 聊天功能:

   • 客户端 → 网关服务器 → 聊天服务器 → 其他客户端

主要服务详解

登录服务器 (loginserver)
├── 处理用户认证
├── 管理用户会话
└── 生成登录令牌

网关服务器 (gateserver)
├── 维护客户端连接
├── 消息路由
└── 负载均衡

游戏服务器 (slgserver)
├── 部队系统
├── 城市建设
├── 战斗系统
└── 资源管理

HTTP服务器 (httpserver)
├── 提供API接口
├── 处理HTTP请求
└── 支持第三方集成

聊天服务器 (chatserver)
├── 世界聊天
├── 联盟聊天
└── 私聊功能

场景应用示例

部队配置与出征

1. 部队配置:

   • 在游戏服务器中，部队配置由 server/slgserver/controller/army.go 处理
   • 每个部队可配置1名主将和2名副将，总cost不超过90
   • 部队属性包括兵力、行军速度和攻城值

2. 出征流程:

   • 选择目标地点，如野地、城池或玩家领地
   • 系统计算行军时间，显示在部队信息面板
   • 部队到达后自动执行战斗或采集任务

城池建设

城池建设是游戏的核心玩法之一，玩家可以升级各种设施来提升实力:

1. 主要设施:

   • 主城: 提升部队上限和城池耐久
   • 校场: 训练士兵
   • 资源建筑: 生产粮食、木材、铁矿和石料

2. 升级逻辑:

   • 设施升级需要消耗资源和时间
   • 高级设施需要前置低级设施达到特定等级
   • 设施等级影响部队属性和资源产量

武将系统

武将是游戏中的核心战斗单位，具有不同的属性和技能:

1. 武将属性:

   • 武力: 影响物理攻击
   • 防御: 减少受到的伤害
   • 战法: 影响技能效果
   • 速度: 决定出手顺序

2. 技能系统:

   • 每个武将可装备多个技能
   • 技能分为主动、被动和指挥三种类型
   • 技能等级影响效果强度

常见配置错误排查

1. 数据库连接失败:

   • 检查 data/conf/env.ini 中的数据库配置是否正确
   • 确保MySQL服务正在运行
   • 验证数据库用户权限

2. 服务启动后无法连接:

   • 检查端口是否被占用
   • 确认防火墙设置是否允许端口访问
   • 检查服务启动顺序是否正确

3. 配置文件未生效:

   • 确保已运行 copydata.bat 复制配置文件到bin目录
   • 检查配置文件格式是否正确
   • 重启服务使配置生效

⚠️ 注意: 修改配置文件后，需要重启相关服务才能使更改生效。建议在修改配置前停止服务，修改完成后再重新启动。

结语

通过本文档，你应该已经了解了三国SLG游戏服务器Demo的基本架构和使用方法。该项目采用模块化设计，各服务之间松耦合，便于扩展和维护。如果你想进一步深入学习，可以查看各模块的源代码，了解具体实现细节。

希望本指南能帮助你快速入门并运行这个游戏服务器Demo。如果遇到问题，可以参考项目中的代码注释或查看相关文档获取更多信息。