开源C#热血传奇服务端引擎：编译部署与完整运行指南

在GitHub上能找到多个用C#编写的热血传奇服务端开源项目，其中较为完整的包括OpenMir2、LyoMir2以及Crystal引擎。这些项目将早期Delphi版本的传奇服务端代码用C#重写，保留了经典玩法，同时借助.NET生态让部署和修改更方便。下面直接拆解拿到代码后怎么编译、怎么配置、怎么跑起来。

**一、项目选择与源码获取**

目前活跃度较高的C#服务端项目主要有三个方向。OpenMir2是基于泄露的Delphi代码翻译重构的版本，服务拆分成DBSvr（数据库）、LoginSvr（账号）、GameSvr（游戏逻辑）、GameGate（游戏网关）、SelGate（角色网关）、LoginGate（登录网关）六个独立模块。LyoMir2是适配dotnet8.0的版本，推荐配合LyoConsole管理器使用，配套客户端源码也在GitHub上。Crystal Source是LOMCN社区维护的版本，也是C#实现，社区支持较完善。

获取方式直接去GitHub对应仓库克隆或下载ZIP包。OpenMir2的仓库地址在mirbeta/OpenMir2，LyoMir2在AndrewChien/LyoMir2。拿到源码后先看仓库里的README文件，有些项目需要额外获取资源文件（比如地图、客户端数据），LyoMir2就单独放在QQ群。

**二、开发环境准备**

编译C#服务端需要装好开发工具和运行环境。Visual Studio 2022是比较稳妥的选择，Community版免费够用。.NET Core SDK版本看项目要求，OpenMir2要求6.0及以上，LyoMir2要求8.0。装完SDK后在命令行用`dotnet --info`确认版本对不对得上。

数据库这块不同项目要求不同。OpenMir2用MySQL 8.0，需要提前装好并创建数据库。LyoMir2那一系的早期版本用的可能是MSSQL 2008 R2。拿到源码后优先看项目文档里写的数据库类型，别装反了。

**三、编译步骤**

用Visual Studio打开项目解决方案文件（.sln）。如果是OpenMir2，找到OpenMir2.sln双击打开。VS会自动识别项目结构，然后在菜单里选“生成”->“生成解决方案”，或者按Ctrl+Shift+B。

编译过程中如果报错提示缺少NuGet包，在解决方案上右键选“还原NuGet包”，让VS自动下载依赖。编译成功后，每个服务模块的可执行文件会生成在对应项目的bin目录下，路径类似`src/DBSrv/bin/Debug/net6.0/DBSrv.exe`。

LyoMir2的编译流程类似，用VS打开后还原包再生成。另外它的作者提供了一个LyoConsole管理器，可以一键启停所有服务，不想一个个手动启动的话可以把这个工具也下载下来。

**四、数据库配置**

OpenMir2需要先执行数据库脚本。在项目源码的sql目录下找到三个脚本文件：mir2_db.sql（建库建表）、mir2_account.sql（账号表结构）、mir2_data.sql（基础数据，比如装备、怪物属性）。用MySQL客户端按顺序执行这三条。

执行完之后修改数据库连接配置。编辑`src/DBSrv/appsettings.json`文件，把里面的连接字符串改成自己的MySQL地址、账号、密码。保存之后数据库这边就准备好了。

**五、服务启动顺序**

服务不能乱开，有先后顺序。按照下面这个顺序逐一启动：

1. 数据库服务（DBSrv）——先跑起来，其他服务都依赖它读写玩家数据
2. 登录服务（LoginSrv）——处理账号登录和注册
3. 游戏逻辑服务（GameSrv）——核心引擎，处理角色移动、战斗这些操作
4. 游戏网关（GameGate）——转发玩家操作数据给GameSrv
5. 角色网关（SelGate）——处理创建角色、删除角色
6. 登录网关（LoginGate）——处理客户端登录请求

每个服务在独立的命令行窗口里运行。启动成功后窗口会一直开着，不要关。如果某个服务闪退，多半是数据库没连上或者端口被占用了，检查配置文件里的端口号有没有冲突。

**六、客户端连接测试**

服务端全部启动之后，需要配套的客户端才能进游戏看效果。OpenMir2的客户端源码在mirbeta/MirClient仓库，但需要用Delphi编译。LyoMir2有专门的客户端源码仓库LyoMir2Client。Crystal项目有独立的客户端工程。

如果不想自己编译客户端，可以找1.76版本的官方客户端，然后修改里面的登录IP地址指向本机（127.0.0.1）。具体的IP修改位置不同版本不一样，一般在客户端目录的配置文件中。服务启动成功后，客户端能连上登录网关就说明整个部署跑通了。