轻量级三国策略服务器：从部署到运行的零门槛指南

这是一个用Go语言实现的三国SLG游戏服务器Demo，提供完整的游戏核心功能，包括武将系统、城池建设、联盟互动和战斗系统等。项目架构清晰，模块化设计便于扩展和二次开发，适合学习游戏服务器开发或快速搭建策略游戏原型。

核心功能一览

三国SLG服务器Demo具备策略游戏的核心要素，通过模块化设计实现了以下关键功能：

武将养成系统

玩家可招募、培养三国名将，组建个性化部队。每个武将拥有独特属性和技能，支持阵容搭配和策略组合。

城池建设体系

提供多样化的城池设施升级系统，玩家可通过建设不同类型的设施提升资源产量、部队上限和防御能力。

联盟社交功能

支持玩家创建或加入联盟，实现联盟公告、成员管理和协同作战，增强游戏社交属性。

战略地图系统

玩家可在大地图上进行资源采集、领土扩张和部队行军，体验真实的三国策略博弈。

环境准备

基础环境要求

• Go 1.16+ 开发环境
• MySQL 5.7+ 数据库
• Git 版本控制工具

项目获取

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

依赖安装

go mod download

快速启动流程

数据库初始化

1. 登录MySQL数据库，创建数据库：

CREATE DATABASE slgdb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

2. 执行数据库脚本：

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

配置文件设置

编辑 data/conf/env.ini 文件，配置数据库连接信息：

配置项	默认值	建议值	说明
db_host	localhost	数据库IP地址	MySQL服务器地址
db_port	3306	3306	数据库端口
db_user	root	数据库用户名	数据库访问账号
db_password	123456	自定义密码	数据库访问密码
db_name	slgdb	slgdb	数据库名称

服务启动

使用批处理脚本一键启动所有服务：

shell/run.bat

⚠️ 注意事项：首次启动前需确保已完成数据库初始化和配置文件修改，否则服务可能无法正常启动。

配置详解

核心配置文件

• data/conf/env.ini: 环境配置文件，包含数据库连接信息和服务端口设置
• data/conf/json/: 游戏数值配置目录，包含武将、技能、建筑等详细参数

服务端口配置

各服务默认端口如下，可在对应配置文件中修改：

• 登录服务器：8001
• 网关服务器：8002
• 游戏服务器：8003
• HTTP服务器：8004
• 聊天服务器：8005

💡 技巧提示：在生产环境中，建议修改默认端口并配置防火墙规则，增强服务器安全性。

游戏数值调整

通过修改 data/conf/json/ 目录下的JSON文件，可以调整游戏平衡参数，如：

• general.json: 武将属性配置
• facility.json: 建筑升级所需资源和时间
• skill.json: 技能效果和冷却时间

目录导航

核心代码结构

• main/: 服务入口目录，包含各服务器启动文件

  • slgserver.go (游戏逻辑核心入口)
  • loginserver.go (用户认证服务)

• server/slgserver/: 游戏核心逻辑实现

  • controller/: API接口处理
  • logic/: 业务逻辑实现
  • model/: 数据模型定义

• data/conf/: 配置文件目录

  • 包含数据库脚本、环境配置和游戏数值配置

• net/: 网络通信模块

  • 实现TCP连接管理和消息路由

• util/: 工具函数库

  • 提供加密、数学计算等辅助功能

代码目录功能说明

slgserver/
├── main/           # 服务启动入口
├── server/         # 业务逻辑实现
├── data/           # 配置文件和数据资源
├── db/             # 数据库交互模块
├── net/            # 网络通信模块
├── middleware/     # 中间件组件
├── constant/       # 常量定义
└── util/           # 工具函数库

功能模块详解

部队系统

玩家可配置不同武将组成部队，通过调整武将搭配和兵力分配实现多样化的战斗策略。

原理简述：部队系统通过server/slgserver/logic/army/模块实现，采用组合模式设计，将武将、兵力和技能封装为可复用的战斗单元，支持实时战力计算和战斗模拟。

战斗系统

游戏战斗采用回合制计算方式，结合武将属性和技能效果，生成详细的战斗报告。

原理简述：战斗系统基于事件驱动设计，通过server/slgserver/logic/war/模块实现，将战斗分解为攻击、防御、技能释放等独立事件，采用状态机模式处理战斗流程。

开发与扩展

二次开发建议

1. 新增功能时，建议遵循现有模块划分原则，在对应目录下添加代码
2. 数据库表结构变更需同步更新db/目录下的模型定义
3. 新增API接口需在对应服务的controller/目录下添加处理函数

常见问题解决

• 服务启动失败：检查数据库连接配置和初始化状态
• 端口冲突：修改对应服务的配置文件，更换端口号
• 数据异常：检查配置文件中的数值是否符合业务规则

通过以上指南，您可以快速部署和运行三国SLG游戏服务器Demo，体验完整的游戏功能。如需深入开发，建议阅读源代码中的详细注释，了解各模块的实现细节。