简介:AzerothCore-WotLK 是一套面向 MMO 服务端开发者与魔兽世界模拟器爱好者的开源、模块化游戏服务器框架,基于巫妖王之怒版本,提供可自定义的服务端基础,适合希望免于从零搭建、专注玩法扩展与脚本开发的中高级读者。项目强调模块化设计,可增删或替换功能模块,并与 TrinityCore、MaNGOS、SunwellCore 等生态及 ScriptDev2 脚本思路相衔接,便于构建个性化 MMORPG 环境。资源以 zip 压缩包提供,体积约 138.19MB,文件总数与主要文件类型明细暂未提供,包内构成以核心代码与配套资源为主。目前已有 1403 人学习或下载,具备一定社区关注度。读者可从中获得服务端源码与模块化组织参考,用于理解游戏逻辑拆分、扩展自定义功能、搭建测试环境,并借助开源协作与 Hacktoberfest 参与思路持续迭代。
1. 先装数据库再补依赖的代价:azerothcore-wotlk 编译卡在 60% 的三个小时
第一次在这台 4 核 8G 的测试机上装 azerothcore-wotlk,我把顺序搞反了:先 clone 源码,再回头补依赖,CMake 在找 MySQL 客户端库那一步直接停住,满屏Could not find MYSQL。补完依赖重跑,编译到 60% 时 g++ 被系统 OOM Killer 干掉,make只留下一行Killed。这类翻车在 MMO 服务端搭建里太常见了——它不是一个apt install就能跑起来的单体程序,而是「编译产物 + 三个数据库 + 一套客户端地图数据 + 两份 conf」四件套,任何一环版本或路径对不上,表现都不是干脆的报错,而是 worldserver 起来后卡在Loading...,或者客户端登录界面一直转圈。
这份记录写给想在本机或局域网里把 WLK 3.3.5a 服务端完整跑起来的人:有一台 Linux 机器、一份 3.3.5a 客户端、愿意按顺序把版本钉死再动手。下面按「环境清单 → 编译 → 建库导数据 → 提取地图 → 排错 → 验证」的顺序走一遍,中间该抄的命令我都贴出来了。
2. 环境清单:Ubuntu 22.04 + MySQL 8.0 + Boost 1.74 的版本对齐
装这套东西,最省事的做法不是追新,而是把一整套版本锁在一个互相认得的组合上。我一般用 Ubuntu 22.04 LTS 打底,它的系统源里 Boost 是 1.74、GCC 是 11.4、CMake 是 3.22,正好落在 azerothcore-wotlk 主分支能直接编过的区间里,不用额外加第三方源。
2.1 一张版本对照表,先确认自己机器差在哪
下面这张表是我在几台机器上反复验证过的最小可用组合。低于这个配置不是编不过,就是编过了跑起来各种玄学问题:
| 组件 | 推荐版本 | 下限 | 说明 |
|---|---|---|---|
| 操作系统 | Ubuntu 22.04 LTS | Ubuntu 20.04 | Debian 11/12 同样可用,包名一致 |
| GCC / G++ | 11.4 | 10.x | 低于 10 对 C++17 特性支持不全 |
| CMake | 3.22 | 3.16 | 低于 3.16 部分 target 语法不认 |
| Boost | 1.74 | 1.70 | 只装 system/filesystem/program_options/thread/iostreams 五个即可 |
| MySQL | 8.0 | 5.7 | MariaDB 10.6 也可,但连接库要装对应的 |
| OpenSSL | 3.0 | 1.1.1 | 影响 authserver 的 SRP6 计算 |
| 内存 | 16G | 8G | 8G 必须限制-j,否则必 OOM |
| 磁盘 | 40G | 20G | 源码 + 编译中间产物 + 地图数据,地图那部分很占地方 |
内存那一行是我踩得最狠的。编译中间产物在build/下能膨胀到好几个 G,加上链接阶段同时驻留多个.o文件,8G 机器开-j8基本等于自杀。
2.2 依赖包一次装齐,别分几次试
依赖缺失最烦的地方在于它不会一次全报出来,而是你补一个、重跑一次 CMake、再报下一个。所以我的习惯是一次性把编译期和运行期的包都装上:
# 基础编译工具链 sudo apt update sudo apt install -y git cmake make gcc g++ build-essential # azerothcore-wotlk 编译期依赖 sudo apt install -y libboost-all-dev \ libssl-dev libbz2-dev libreadline-dev zlib1g-dev # 数据库服务端与客户端开发库,两个都要装 sudo apt install -y mysql-server libmysqlclient-dev # 运行 worldserver 控制台时的终端库 sudo apt install -y libncurses-dev screen这里的重点是libmysqlclient-dev和libboost-all-dev两个包。前者提供 CMake 找的mysql_config和头文件,缺了它 CMake 就报Could not find MYSQL;后者一次性把 Boost 的所有子库带上,比一个个挑libboost-system-dev省心,代价是装完多占几百兆,我觉得值。screen不是必需品,但 worldserver 是个前台交互程序,关掉 SSH 就跟着退出,用screen挂住它比nohup方便,至少还能回去敲account create。
装完随手验一下版本,别等编译到一半才发现不对:
cmake --version | head -n 1 # 期望 >= 3.16 gcc --version | head -n 1 # 期望 >= 10 mysql --version # 期望 8.0.x 或 10.6.x2.3 目录规划和运行用户,别用 root 跑服务端
我见过不少人直接在/root下 clone 源码、用 root 跑 worldserver,能跑,但后面改配置、换账号、做备份全是坑。我一般建一个独立用户和一套固定目录,把所有东西收在一个前缀下:
# 建运行用户 sudo useradd -m -s /bin/bash acore # 目录规划:源码、编译、安装产物三者分开 sudo -u acore mkdir -p /home/acore/src # git clone 的位置 sudo -u acore mkdir -p /home/acore/build # cmake / make 的位置 sudo -u acore mkdir -p /home/acore/server # make install 的前缀 sudo -u acore mkdir -p /home/acore/server/data # 后来放 dbc/maps/vmaps/mmaps源码和编译目录分开的好处是:编坏了直接rm -rf build重来,不用重新拉一遍几个 G 的仓库;安装目录独立,意味着make install出来的bin/和etc/不会被下一次编译覆盖掉,升级时只需换bin里的二进制,配置文件原地不动。
注意,后面所有命令我都默认用acore用户执行,sudo -u acore只是从你当前账号切过去。如果你直接登录acore就不用加。
3. 编译 azerothcore-wotlk:CMake 三个必改参数与 make 的核数取舍
编译这一步决定了后面 80% 的问题。配置参数写错,要么编出来的世界服不支持模块,要么地图提取工具压根没生成,到第 4 章才发现,只能从头再来一遍。
3.1 拉源码和确认分支
cd /home/acore/src # 只拉主分支最新一次提交,避免历史包袱 git clone --depth 1 -b master https://github.com/azerothcore/azerothcore-wotlk.git . # 看一眼当前提交,方便以后排查「为什么别人能编我不能」 git log -1 --oneline用--depth 1是省时间和磁盘,缺点是没有历史,做不了git bisect。如果你的用途是长期维护一套服务端、要跟着上游更新,把--depth 1去掉拉完整仓库更合适。拉完之后目录里会有src/、data/、modules/、conf/四个关键目录,data/sql下面就是待会儿要导入的基础 SQL,modules是空的,后面挂模块用得上。
3.2 CMake 参数:三个必须显式指定的开关
cd /home/acore/build cmake ../src \ -DCMAKE_INSTALL_PREFIX=/home/acore/server \ -DCMAKE_BUILD_TYPE=Release \ -DTOOLS_BUILD=all \ -DSCRIPTS=static \ -DMODULES=static \ -DWITH_WARNINGS=0逐个说这几个参数为什么这么写:
CMAKE_INSTALL_PREFIX指到/home/acore/server,决定了make install之后bin/、etc/落在哪。这个路径要和后面 conf 里的相对路径、DataDir 对得上,中途改前缀等于全部重来。CMAKE_BUILD_TYPE=Release不开优化的话,worldserver 处理几千个生物刷新点时帧率会明显掉,而且二进制体积反而更大。调试阶段可以换Debug,但上线跑一定要Release。TOOLS_BUILD=all是新手最容易漏的一个。不开它,mapextractor、vmap4extractor、vmap4assembler、mmaps_generator这四个工具不会生成,第 4 章提取地图时你只能重新编一遍。默认值在部分版本里是none,所以我习惯显式写死。SCRIPTS=static和MODULES=static决定脚本和模块是静态链接进二进制还是编译成动态库。选static的好处是部署时只有一个 worldserver 可执行文件,不用操心.so的加载路径;代价是加一个新模块就得重新编译一次。想频繁换模块的选dynamic,但要额外配LD_LIBRARY_PATH。WITH_WARNINGS=0是个人偏好,编译器告警在 Release 下刷屏但基本无害,关掉能少看几千行输出。排查编译错误时再打开。
CMake 跑完最后几行会打印出找到了哪些组件,Boost、OpenSSL、MySQL 三项都要是Found,有一项NOT FOUND就别急着 make,先回去补包。
3.3 make 的核数取舍:内存比 CPU 更关键
# 先看物理内存,决定 -j 开多少 free -g # 8G 内存开 -j4,16G 开 -j8,32G 以上可以 -j16 make -j4 # 编译完成后安装到前缀目录 make install经验值是每核预留 1.5~2G 内存。8G 机器开-j8,链接阶段很容易触发 OOM Killer,表现就是g++: internal compiler error: Killed (program cc1plus)或者干脆一行Killed然后 make 退出。真被杀了不用慌,make支持断点续编,把-j降下来重新执行同一条命令,它会跳过已完成的.o。
make install完成之后,/home/acore/server下应该出现三个东西:bin/里有authserver、worldserver和四个地图工具;etc/里有authserver.conf.dist和worldserver.conf.dist;可能还有include/,那个不用管。配置文件是.dist结尾,意味着要自己复制一份改名,这样升级时新的.dist不会覆盖你改过的配置。
3.4 模块怎么挂进去
azerothcore-wotlk 的模块化设计是它相对 trinitycore、mangos 那批老框架最实用的部分。挂载方式很简单:把模块目录整个放进src/modules/,然后重新跑一次 CMake 和 make。
cd /home/acore/src/modules # 模块目录名就是编译时的目标名,一般直接 clone 进来 git clone --depth 1 https://github.com/azerothcore/mod-eluna.git # 回到 build 目录重新生成,CMake 会自动扫描 modules/ 下的每个子目录 cd /home/acore/build cmake ../src -DMODULES=static make -j4 && make install注意,加了模块之后必须重新跑 cmake,只make是不行的,因为模块列表是在 configure 阶段扫描进缓存里的。判断模块有没有生效,最直接的办法是启动 worldserver 看日志里有没有出现模块名相关的加载行,或者看bin/下有没有多出对应的.conf.dist。另外模块对上游版本有要求,clone 之前最好看一眼它的 README 里写的兼容分支,挂错分支编译报一堆找不到符号的错误,那种错误最难查。
4. 数据库初始化:auth、characters、world 三库与 DataDir 四目录
编译通过只是拿到工具,真正让服务端「活」起来的是三个库和一套地图数据。这一步的顺序不能乱:先建库建账号,再导基础 SQL,再让服务端自己跑更新,最后配 DataDir。
4.1 建库、建账号与字符集
-- 用 root 登录 mysql 后执行 CREATE USER 'acore'@'localhost' IDENTIFIED BY 'Acore_2024#pass'; CREATE USER 'acore'@'127.0.0.1' IDENTIFIED BY 'Acore_2024#pass'; -- 三个库职责分离:账号、角色、世界内容 CREATE DATABASE acore_auth DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE DATABASE acore_characters DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; CREATE DATABASE acore_world DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; GRANT ALL PRIVILEGES ON acore_auth.* TO 'acore'@'localhost'; GRANT ALL PRIVILEGES ON acore_characters.* TO 'acore'@'localhost'; GRANT ALL PRIVILEGES ON acore_world.* TO 'acore'@'localhost'; GRANT ALL PRIVILEGES ON acore_auth.* TO 'acore'@'127.0.0.1'; GRANT ALL PRIVILEGES ON acore_characters.* TO 'acore'@'127.0.0.1'; GRANT ALL PRIVILEGES ON acore_world.* TO 'acore'@'127.0.0.1'; FLUSH PRIVILEGES;两个 host 都建一遍是血泪经验。MySQL 里'acore'@'localhost'走的是 socket,'acore'@'127.0.0.1'走的是 TCP,配置文件里如果写127.0.0.1;3306;...,匹配的就是后者。只建 localhost 的话,表现是命令行能连、worldserver 连不上,日志里一行Access denied for user 'acore'@'localhost',看着像密码错,其实是 host 匹配问题。
字符集用utf8mb4是为了角色名和公会名里的特殊字符,用默认的 latin1 建库,后面玩家名字里带个非 ASCII 字符就可能插入失败。
4.2 导入基础 SQL,然后交给自动更新
# base 目录按库分文件夹,逐个文件导入 for f in /home/acore/src/data/sql/base/db_auth/*.sql; do mysql -u acore -p'Acore_2024#pass' acore_auth < "$f" done for f in /home/acore/src/data/sql/base/db_characters/*.sql; do mysql -u acore -p'Acore_2024#pass' acore_characters < "$f" done for f in /home/acore/src/data/sql/base/db_world/*.sql; do mysql -u acore -p'Acore_2024#pass' acore_world < "$f" done老一点的版本data/sql/base/下面是三个单文件db_auth.sql、db_characters.sql、db_world.sql,新版本拆成了目录。用for循环能同时兼容两种结构,而且顺序由文件名排序决定,一般没问题。world 库最大,导入过程可能要几分钟,中途别 Ctrl+C。
基础 SQL 只包含建表和初始数据,之后的版本更新由 worldserver 启动时自动应用,前提是 conf 里开了对应开关:
# worldserver.conf Updates.EnableDatabases = 7 Updates.AutoSetup = 1 Updates.SourcePath = "/home/acore/src/data/sql/updates"EnableDatabases是个位掩码:1 = auth,2 = characters,4 = world,7就是三个库全开。第一次启动 worldserver 时会看到它一条条打印Applying update...,几百条跑完通常要几分钟,期间数据库 CPU 会飙一下,属于正常现象。AutoSetup = 1会在库不存在时自动建表,但基础数据还是得靠上面那轮导入,别指望它变魔术。
4.3 地图数据提取:DataDir 里到底要放什么
这一步是整套部署里最耗时的环节,也是新手最容易跳过的一步。世界服需要从客户端 Data 目录里解出四种数据:dbc(静态数据表)、maps(地形高度)、vmaps(视线遮挡)、mmaps(寻路网格)。少了 mmaps,NPC 会卡在墙角原地转圈;少了 vmaps,玩家能隔着墙打怪。
cd /home/acore/server/bin # 1. 先解 dbc 和 maps,-i 客户端根目录,-o 输出目录 ./mapextractor -i /path/to/client/ -o /home/acore/server/data # 2. 再解 vmaps,输入是客户端的 Data 目录 ./vmap4extractor -d /path/to/client/Data # 提取产物是 Buildings 目录,用 assembler 合成 ./vmap4assembler Buildings /home/acore/server/data/vmaps # 3. 最后生成 mmaps,必须在 data 目录内执行 cd /home/acore/server/data /home/acore/server/bin/mmaps_generator四个工具的详细参数各版本略有差异,拿不准的时候先跑./mapextractor --help看一眼,比照抄博客靠谱。整个提取过程视 CPU 和磁盘而定,mmaps_generator最慢,单核跑一两个小时很正常,它不是多线程的,别以为是卡死了。
提取完/home/acore/server/data下应该正好是四个目录:
/home/acore/server/data/ ├── dbc/ # 静态数据表 ├── maps/ # 地形 ├── vmaps/ # 视线 └── mmaps/ # 寻路注意是四个目录直接挂在 data 下,不能多套一层data/maps/maps/。多套一层是第 5 章要讲的经典翻车点。
4.4 两份 conf 的关键项对照
# authserver.conf —— 只关心登录库和端口 LoginDatabaseInfo = "127.0.0.1;3306;acore;Acore_2024#pass;acore_auth" RealmServerPort = 3724 # worldserver.conf —— 三个库 + 数据目录 + 世界端口 LoginDatabaseInfo = "127.0.0.1;3306;acore;Acore_2024#pass;acore_auth" WorldDatabaseInfo = "127.0.0.1;3306;acore;Acore_2024#pass;acore_world" CharacterDatabaseInfo = "127.0.0.1;3306;acore;Acore_2024#pass;acore_characters" DataDir = "/home/acore/server/data" WorldServerPort = 8085连接串格式是host;port;user;password;database,用分号隔开,五个字段一个都不能少。密码里如果有分号,整个串会被截断,所以密码里我一般不放分号,改用#和_。
DataDir用绝对路径最稳。用相对路径的话,它相对于 worldserver 的工作目录,而你从screen里启动、从 systemd 里启动、从别处cd过去启动,工作目录都不一样,表现就是有时候能找到地图有时候找不到。
配置改完先别急着开服,复制一份.dist再改,保持原始模板干净:
cd /home/acore/server/etc cp authserver.conf.dist authserver.conf cp worldserver.conf.dist worldserver.conf5. 避坑排查:编译、连库、地图、登录四类翻车现场
下面五条是我在不同机器上真实撞过的,按「现象 → 原因 → 解决」写,遇到问题时可以直接对号入座。
5.1 CMake 报 Could not find MYSQL
现象:cmake ../src跑到一半停住,输出Could NOT find MYSQL (missing: MYSQL_LIBRARY MYSQL_INCLUDE_DIR),后面所有 target 都配不下去。
原因:系统里装的是mysql-client或只装了服务端mysql-server,缺开发头文件;或者装的是 MariaDB,包名是libmariadb-dev但 CMake 找的是libmysqlclient。
解决:sudo apt install libmysqlclient-dev,装完清掉 build 目录的缓存重来:rm -rf /home/acore/build/* && cmake ../src ...。如果坚持用 MariaDB,装libmariadb-dev-compat让它提供兼容的mysql_config。
5.2 worldserver 启动即退出,日志刷 Access denied
现象:./worldserver跑起来不到两秒就退出,控制台最后一行是Could not connect to MySQL database at 127.0.0.1: Access denied for user 'acore'@'localhost'。
原因:两种可能。一是连接串里的密码和你建账号时设的不一致,尤其是密码含#、;这类字符时被配置文件当注释或分隔符吃掉了;二是只建了'acore'@'localhost'没建'acore'@'127.0.0.1',TCP 连接匹配不上。
解决:先在命令行手动验证一次mysql -h 127.0.0.1 -u acore -p,能进说明是配置文件的转义问题,把密码改简单;进不去就补建 127.0.0.1 的账号。
5.3 编译阶段 g++ 被 Killed,没有报错信息
现象:make -j8跑到某个.cpp忽然退出,终端只有一行Killed或者internal compiler error: Killed (program cc1plus),dmesg | tail里能看到Out of memory: Killed process ... cc1plus。
原因:并行编译的进程数超过物理内存承载,触发内核 OOM Killer。8G 内存跑-j8几乎必死。
解决:把-j降到 4 或 2 重新执行同一条make命令,它会跳过已完成的文件续编。想彻底解决就加 swap:sudo fallocate -l 8G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile。
5.4 卡在 Loading maps 或启动报 DataDir 无效
现象:worldserver 启动后日志停在Loading Maps...,或者直接报DataDir is wrong or empty,但/home/acore/server/data里明明有东西。
原因:目录层级多套了一层,比如提取时用了-o /home/acore/server/data/maps,结果变成data/maps/maps/;或者只提了 maps 没提 vmaps、mmaps,服务端检查四个目录齐全才继续。
解决:ls /home/acore/server/data看输出是不是恰好dbc maps vmaps mmaps四项。多一层就mv data/maps/maps/* data/maps/ && rmdir data/maps/maps。缺哪个补提哪个,mmaps 最容易被忘。
5.5 客户端登录卡在「正在连接」或选完角色断开
现象:authserver 和 worldserver 都起来了,客户端改完 realmlist 后能出登录框,输账号密码后卡住,或者角色列表出来了但点进入就断开。
原因:acore_auth.realmlist表里address字段还是127.0.0.1,局域网里的客户端拿到这个地址后往自己机器上连,当然连不上;另一种是服务器防火墙没放行 3724 和 8085 两个端口。
解决:UPDATE acore_auth.realmlist SET address = '192.168.x.x' WHERE id = 1;,把 address 改成服务器在局域网里的实际 IP;然后sudo ufw allow 3724/tcp && sudo ufw allow 8085/tcp。改完重启 authserver 才生效,因为 realmlist 是它启动时读进内存的。
6. 装完怎么验证:从 3724 握手到角色进图
到这一步所有组件都装完了,但「装完」和「跑通」是两回事。我习惯按分层顺序验,从下往上,哪一层断了就停在哪一层查,不要一上来就开客户端试。
6.1 三层验证,每层都有明确的通过标准
| 层级 | 验证命令或位置 | 通过标准 |
|---|---|---|
| 进程层 | ps -ef | grep -E 'authserver|worldserver' | 两个进程都在,且没反复重启 |
| 端口层 | ss -lntp | grep -E '3724|8085' | 两个端口都是 LISTEN 状态 |
| 日志层 | tail -f logs/Server.log | 出现World initialized且没有 ERROR |
| 数据层 | SELECT COUNT(*) FROM acore_world.creature; | 数量在几万条量级,不是 0 |
| 账号层 | worldserver 控制台account create test test | 返回Account created |
| 登录层 | 客户端 realmlist 指向服务器 IP | 能进角色列表并创建角色 |
进程层和端口层最快,30 秒就能确认。日志层要注意,worldserver 启动时会打印大量Loading...,最后一行是World initialized in xxx seconds才算真的起来了,中途出现的ERROR要逐条看,尤其是 SQL 相关的,通常意味着某个 update 没应用成功。
数据层这一条容易被忽略:如果 world 库的 creature 表是空的,服务端能起来,客户端也能进,但整个世界一个 NPC 都没有。这种情况一般是基础 SQL 导入时某个文件失败了,回去重新跑一遍for循环,看有没有报错输出。
账号层在 worldserver 的控制台里敲:
# 在 worldserver 交互控制台里执行 account create test test123 account set gmlevel test 3 -1第一行建账号,第二行给 GM 权限,-1表示全服生效。这两条命令必须在 worldserver 前台跑着的时候敲,screen -r切回去就行。
最后一层登录验证,改客户端realmlist.wtf里的地址指向服务器 IP,注意是服务器的局域网 IP,不是 127.0.0.1,除非客户端和服务端在同一台机器上。进去之后创建角色、进图、走两步、打一只怪,这四个动作能完成,说明 maps、vmaps、mmaps 都正常加载了——尤其是寻路,NPC 能正常走动就说明 mmaps 没问题。
从那以后我每次装新机器,都会在make install之后先跑一遍这六层验证,而不是直接开客户端试。客户端的报错信息太模糊了,「已断开连接」这四个字背后可能是端口、可能是 realmlist、可能是世界库为空,从下往上捋一遍只需要五分钟,比在客户端里瞎试快得多。希望帮到你。
本文还有配套的精品资源,点击获取