魔兽世界私服Trinity，从源码开始

缘起因由

在一个无所事事的周末下午，突然想起魔兽世界，官方的账号很久没有上了，里面的大小号现在连满级都不是。以前曾经搭过传奇和星际争霸战网的私服自娱自乐，也听说过魔兽世界有开源的服务端模拟，既然兴致来了就小小的研究一下。

目前魔兽世界的私服比较流行的是MaNGOS和Trinity，二者都是模拟魔兽世界服务端。MaNGOS“号称”是一个研究型项目，目的是为了学习大规模的C++项目开发，有道理，不过我不信。Trinity是基于MaNGOS的代码开发的，以前主要是为了合并用户提交的补丁代码而设立的一个项目，不过现在已经单独独立出来了，主要开发成员包括以前MaNGOS的一些老人，现在的主要工作包括清理代码、优化、提供一个更好的服务端内核。

二者现在的代码提交和更新都很频繁，但是具体是否会合并对方的代码就不清楚了。总而言之，也就是说，我感觉Trinity大概也许应该是目前最好的一个魔兽世界服务端模拟了。作为一个程序员来说，玩游戏还在其次，看看代码才是件有意思的事情。整个过程记录在案http://log4think.com/setup_wow_private_server，以便事后查询。

安装基本工具

现在尝试一下从源码开始搭个魔兽世界的服务器，从源码开始主要还是想顺便看看代码的情况，就基于Trinity来做吧。至于客户端的情况，截止到2011年6月12日，中国国服魔兽世界最新的版本是3.3.5 13930-巫妖王之怒。

先装几样基本的工具软件，先是下载源码用的，由于MaNGOS和Trinity都是托管在GitHub上，所以得用Git才能下到源码：
Git for Windows: 在这里下
Git 的图形化工具TortoiseGit: 在这里下

然后是编译工具和库：
OpenSSL: 在这里下
CMake: 在这里下
Visual Studio 2010 Express: 在这里下，这个是Visual Studio的免费版本。如果装了要钱的Visual Studio 2010，就不必装这个了。

运行环境：
MySQL: 在这里下，安装后也包含编译需要的头文件和库。
MySQL的图形化客户端: 在这里下
Microsoft Visual C++ 2010 Redistributable Package: x86版本的在这里下，x64版本的在这里下
.Net Framework 3.5: 在这里下。非必需，而且Visual Studio 2010里面好像带，有了就不必装了。

生成项目文件

各个工具都下载、安装完毕（具体细节可Google之，不赘述了），准备工作做完之后，开始下代码编译。
1、建一个目录，譬如 D:\Trinity
2、进入这个目录，右键Git Clone... ，Url那里填入 https://github.com/TrinityCore/TrinityCore.git， 点OK。不喜欢图形化工具的可以直接进到新建的目录里面，跑命令 git clone https://github.com/TrinityCore/TrinityCore.git 。 会自动建立一个名为TrinityCore作为源码目录，然后就是等着代码下完。
3、在D:\Trinity下建一个目录是Build等下放编译结果文件
4、运行CMake的图形化工具（开始菜单里CMake下的CMake (cmake-gui)）
5、点Browse Source... ， 选D:\Trinity\TrinityCore
6、Browse Build... ，选:\Trinity\Build
7、点Configure，出一个对话框
8、确保勾选了 Use default native compilers，下拉框里面选Visual Studio 10，至于是32位还是64位版本的，根据自己的情况选
9、点Finish，CMake工具会搜索源码配置，分析出一些编译选项来。确保cmake-gui下面的信息提示里面没有ERROR字样，否则根据具体错误修正后重来。
10、在cmake-gui上面的编译选项里面选中SCRIPTS、SERVERS、TOOLS、USE_COREPCH、USE_SCRIPTPCH，不要选USE_MYSQL_SOURCES。
11、最后点Generate，CMake会在D:\Trinity\Build下面生成Visual Stdio 2010的项目文件。

配置完成后，我的是这样:

可能出现的问题：
1、第10步里面_GIT_EXEC应该是msysgit中git的绝对路径，如果没有则是msysgit安装的时候没有把自己加到系统路径里面去。
2、如果下面出现红色的ERROR提示，类似于

Could not copy from: D:/dev/cmake/share/cmake-2.8/Templates/CMakeVSMacros2.vsmacros
      to: C:/Documents and Settings/Administrator/ÎÒµÄÎĵµ/Visual Studio 2010/Projects/VSMacros80/CMakeMacros/CMakeVSMacros2.vsmacros

这个好像是因为CMake没法识别中文路径，把“我的文档”的位置改一下吧，改成路径不带中文的。或者直接自己把提示中的CMakeVSMacros2.vsmacros拷到“我的文档”下的Visual Studio 2010/Projects/VSMacros80/CMakeMacros/。

编译源码

0、如果你的魔兽世界客户端是3.3.5 13930，那么记得给代码打个认证补丁以支持13930，具体请参考另一篇文章 http://log4think.com/wow_3-3-5_13930_auth_patch
1、在Visual Studio里面打开D:\Trinity\Build\TrinityCore.sln，先Build -> Clean Solution，然后Build -> Build Solution
2、默认是生成Debug，结果在D:\Build\bin\Debug下面，从MySQL的安装目录下的Lib目录里面拷一个libmySQL.dll到这个目录下，libeay32.dll和ssleay32.dll是OpenSSL的，应该默认加到系统路径下了，如果后面提示找不到就从OpenSSL的安装目录里面拷过来。

安装数据库

简短截说，
1、从https://github.com/TrinityCore/TrinityCore/downloads下载最新的（或者符合你的客户端版本号的）魔兽世界数据文件，
2、用MySQL图形化工具，导入 D:\Trinity\TrinityCore\sql\create\create_mysql.sql 执行建立三个数据库，
auth数据库中导入 D:\Trinity\TrinityCore\sql\base\auth_database.sql 执行，
characte数据库中导入 D:\Trinity\TrinityCore\sql\base\character_database.sql 执行，
world数据库中导入第一步中下载的TDB_full_???.sql文件执行，
最终建立auth、character、world三个数据库。

生成地图文件

1、在D:\Build\bin\Debug下面建一个makevmaps3_simple.bat文件，内容为

vmap3extractor.exe
md vmaps
vmap3assembler.exe Buildings vmaps

pause

执行，会从魔兽世界的客户端目录里面解压缩服务端需要的地图出来。根据机器速度不同，大概需要20分钟到一个小时的时间。运行结束的时候会给个提示“Press any key...”，按任意键结束。生成vmaps和buildings目录，buildings 目录无用可以删除。
2、假设魔兽世界的客户端目录在D:\WOW下面，在D:\Build\bin\Debug下运行 mapextractors.exe -i "d:\WOW" ，会生成maps目录。

配置服务器

1、在D:\Build\bin\Debug下有worldserver.conf.dist和authserver.conf.dist两个文件，分别是游戏服务器和认证服务器的配置模板文件。
2、复制一份worldserver.conf.dist并改名为worldserver.conf，配置游戏服务器

LoginDatabaseInfo = "127.0.0.1;3306;root;trinity;auth"
WorldDatabaseInfo = "127.0.0.1;3306;root;trinity;world"
CharacterDatabaseInfo = "127.0.0.1;3306;root;trinity;characters"

分别是认证数据库、世界数据库、玩家角色数据库的地址，root后面的trinity是MySQL中root的密码，改成你在安装MySQL时设置的root密码。

如果要使用刚刚生成的vmaps文件，则将下面三项配置的值改成0

vmap.enableLOS = 1 -- 改成 0
vmap.enableHeight = 1 -- 改成 0
vmap.petLOS = 1 -- 改成 0
vmap.enableIndoorCheck = 1 -- 改成 0

3、复制一份authserver.conf.dist并改名为authserver.conf，配置认证服务器

LoginDatabaseInfo = "127.0.0.1;3306;root;trinity;auth"

同样，把trinity改成MySQL的root密码。

4、检查数据库auth里面realmlist表里面的记录，记录中port的值应该和worldserver.conf 里面的 WorldServerPort = 8089 这一项的值一样（这里是8089）。同时，gamebuild的值应该和你客户端的版本号是一致的（登陆界面右下角，当前最新的是13930）。如果realmlist里面没有记录，则应该加一条。

修改客户端配置

客户端默认是去登陆官方服务器，需要修改一下地址改成让客户端登陆我们自己架设的游戏服务器。假设魔兽世界客户端安装在D:\WOW下面，到D:\WOW\Data\zhCN下面，备份realmlist.wtf文件。该文件原来的内容是

set realmList cn.logon.warcraftchina.com
set patchlist cn.version.warcraftchina.com
set realmlistbn ""
set portal cn

将其内容改成

SET realmlist "127.0.0.1"
SET patchlist "127.0.0.1"

如何和朋友一起玩

如果想配个私服和朋友一起玩，那么需要一个公网IP地址。机房里面没有服务器没有关系，可以搭在自己家里的服务器上，然后去 http://ip138.com上查到自己的IP地址，把127.0.0.1相关的地址都改成自己的IP地址就可以了。如果是通过ADSL路由上的网，去ADSL路由配置里面把自己的内外IP地址设置为DMZ主机地址开放给外网即可。
此外，如果是跑服务端的服务器有花生壳的动态域名或者自己的域名（比如我的 http://log4think.com），可以将127.0.0.1改成自己的域名。前面在wowserver和authserver中的地址中配置的127.0.0.1都要改，因为服务端要提供这个地址给客户端。MySQL相关的127.0.0.1地址不用改，要改也行，不过就是还得去配MySQL的外网访问的相关安全设置。

同时，如果是要搭在公网上对外提供服务，建议单独找个机器做auth服务器（配置不用太好），不同的游戏区跑在不同的服务器上（这个配置要好一点），每个服务器上都要跑worldserver。把服务器列表加到auth数据库里面的realmlist表里就是。

友情提示：提供公网服务小心被盛大告。

启动游戏

1、运行D:\Build\bin\Debug\authserver.exe
2、运行D:\Build\bin\Debug\worldserver.exe
3、运行客户端wow.exe
如果运气好的话...
反正我运气不错...

相关的可能还需要一些配置和改动，不过目前我的这个版本能够正常运行，其它的未来再写吧。在此之前，至少可以先研究下源代码...

退而求其次

如果只是想玩玩游戏，可以下个别人做好的包 TCCN-3.3.5-Trinity8400.exe ，安装好启动web服务器和wow服务器，注册个账号就可以进去玩了，简单的无需解释了。不过这个有人数限制，具体限制多少人我也不清楚，总之做公网服务是没戏的。

相关的几个小问题：
连接服务器断开的话，到这里下个补丁覆盖。
登入后没有服务器列表的话，看看客户端的版本号（登陆界面的右下角），然后把auth数据库realmlist表里面的记录最后一项gamebuild改为看到的版本号（比如13930） 。

开发调试

既然是从源码编译的，因此如果中间出了任何问题都是可以通过调试的方式去解决的。调试方法很简单，几个简单的手段
1、抓包，分析数据记录
2、启动编译好的程序，开Visual Studio，附加到该进程上，下断点跟踪
3、进入游戏，进行操作，Visual Studio中如果下了正确的断点，就会在相关的位置停下

参考资料

二者的一些相关网站列举如下：
MaNGOS 官网: http://getmangos.com/
MaNGOS 代码库: http://github.com/mangos
更多MaNGOS的链接: http://getmangos.com/wiki/

Trinity 官网: http://www.trinitycore.info
Trinity 项目首页: http://trinitycore.github.com/
Trinity 代码库: https://github.com/TrinityCore/TrinityCore

本站后续相关文章可以在 http://log4think.com/category/practice/fun/wow-trinity/ 找到。
本文全文参考Trinity官方文档 http://www.trinitycore.info/How-to:Win