三国SLG游戏服务器Demo使用指南

📋 环境准备清单

搭建三国SLG游戏服务器Demo需要提前准备以下环境和工具，确保服务能够顺利编译和运行：

基础环境要求

• Go语言环境：版本1.16及以上（用于编译Go源代码）
• MySQL数据库：5.7或8.0版本（存储游戏数据）
• Git：用于拉取项目代码
• Windows/Linux系统：支持跨平台运行，Windows需使用PowerShell或命令提示符，Linux需使用bash终端

资源检查

• 磁盘空间：至少200MB（含源代码、编译产物和配置文件）
• 网络环境：确保服务器端口（默认8080、8081等）未被占用

环境搭建步骤

1. 克隆项目代码库：

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

2. 安装Go依赖：

   go mod download
   

⚠️ 风险提示：未安装Go环境会导致编译失败，建议使用go version命令验证环境是否配置正确。

🔧 功能模块解析

三国SLG服务器采用微服务架构设计，各模块职责清晰，通过服务编排实现协同工作。以下是核心功能模块及其价值：

1. 核心服务模块

服务名称	功能价值	启动入口文件	关键技术点
游戏服务器（slgserver）	承载核心游戏逻辑，包括城池建设、部队管理、战斗系统等	main/slgserver.go	实时战斗计算、资源管理
登录服务器（loginserver）	处理用户认证与会话管理	main/loginserver.go	JWT身份验证、会话缓存
网关服务器（gateserver）	负责客户端连接与消息转发	main/gateserver.go	连接池管理、协议解析
HTTP服务器（httpserver）	提供RESTful API接口	main/httpserver.go	中间件链、请求路由
聊天服务器（chatserver）	处理玩家实时聊天功能	main/chatserver.go	消息队列、广播机制

图1：游戏服务器管理的主城与部队系统界面

2. 数据层模块

• 数据库交互：db/conn.go实现MySQL连接池管理，支持ORM映射（对象关系映射）
• 配置加载：config/config.go负责环境变量与配置文件解析
• 静态数据：data/conf/json/目录存储武将、技能等游戏配置数据，通过server/static_conf/加载

3. 网络通信模块

• net/server.go：基础网络服务框架
• net/router.go：消息路由与处理分发
• middleware/：包含登录验证、请求限流等中间件

⚙️ 核心组件解析

1. 核心配置文件

环境配置（env.ini）

位于data/conf/env.ini，存储数据库连接信息等关键配置：

[database]
# 数据库连接字符串格式：用户名:密码@tcp(地址:端口)/数据库名?参数
dsn = root:123456@tcp(127.0.0.1:3306)/slgdb?charset=utf8mb4&parseTime=True&loc=Local
max_open_conns = 20
max_idle_conns = 10

[server]
http_port = 8080
gate_port = 8081
log_level = info

⚠️ 风险提示：数据库配置错误将导致服务启动失败，需确保MySQL服务正常运行且账号密码正确。

数据库初始化

执行data/conf/db.sql脚本创建数据库表结构：

# Windows环境
mysql -u root -p < data/conf/db.sql

# Linux环境
mysql -u root -p slgdb < data/conf/db.sql

2. 服务启动流程

配置文件复制

Windows环境通过批处理脚本复制配置文件至运行目录：

# 执行Shell脚本
shell/copydata.bat

服务启动命令

进入「main/」目录执行以下命令启动各服务：

# 启动游戏服务器
go run slgserver.go

# 启动登录服务器（新终端）
go run loginserver.go

# 启动网关服务器（新终端）
go run gateserver.go

跨平台注意事项

• Windows：使用shell/run.bat批处理文件一键启动所有服务
• Linux：需手动编写shell脚本或使用nohup命令后台运行服务：

  nohup go run slgserver.go > slgserver.log 2>&1 &
  

3. 关键业务模块

武将系统

存储于data/conf/json/general/general.json，定义武将属性与技能：

{
  "id": 1,
  "name": "朱儁",
  "camp": "汉",
  "cost": 35,
  "attributes": {
    "attack": 87,
    "defense": 90,
    "speed": 88
  },
  "skills": [1001, 1002]
}

图2：武将系统展示界面，包含属性与技能配置

城池建设

通过server/slgserver/controller/city.go处理城池升级逻辑，配置文件位于data/conf/json/facility/目录。设施升级需满足资源条件与前置建筑等级：

// 简化代码示例
func UpgradeFacility(roleId int, facilityId int) error {
    // 1. 检查资源是否充足
    // 2. 检查前置建筑条件
    // 3. 扣除资源并开始升级倒计时
    return nil
}

📊 核心目录速查表

目录路径	功能描述	关键文件
main/	服务启动入口	slgserver.go、loginserver.go
server/slgserver/	游戏核心逻辑	controller/army.go、logic/army/army_logic.go
data/conf/json/	游戏配置数据	general/general.json、facility/facility.json
db/	数据库交互	conn.go
net/	网络通信	server.go、router.go
util/	工具函数	crypto.go（加密）、session.go（会话）
shell/	自动化脚本	run.bat（Windows启动）、copydata.bat（配置复制）

操作场景示例

场景1：修改武将属性

1. 编辑data/conf/json/general/general.json文件
2. 修改目标武将的attributes字段
3. 重启slgserver服务使配置生效

场景2：查看战斗日志

1. 战斗数据存储于server/slgserver/model/war_report.go定义的结构体
2. 通过server/slgserver/controller/war.go的API接口获取战报
3. 战报界面示例：

图3：战斗系统生成的战报记录

总结

本使用指南通过"环境准备-功能模块-配置流程"的三段式框架，详细介绍了三国SLG游戏服务器Demo的搭建与使用。核心关注服务编排、配置注入等专业概念，提供了跨平台运行方案与风险提示。开发者可基于此框架扩展更多游戏功能，如联盟系统（server/slgserver/logic/union/）或聊天系统（server/chatserver/）。

通过合理配置env.ini与启动各微服务，即可快速搭建完整的游戏服务器环境，体验三国策略游戏的核心玩法。