AzerothCore：WotLK 3.3.5a 私服实战上手指南-平芜编程栈

AzerothCore：WotLK 3.3.5a 私服实战上手指南

【免费下载链接】azerothcore-wotlkComplete Open Source and Modular solution for MMO项目地址: https://gitcode.com/GitHub_Trending/az/azerothcore-wotlk

想拥有自己的巫妖王年代艾泽拉斯？AzerothCore 是一套完整的 C++ 服务端模拟器，按 3.3.5a 版本还原游戏逻辑，从认证登录到世界规则全部由你掌控。不绕弯子：它是服务端，不是客户端外挂，装好之后配一个 3.3.5a 客户端就能开玩。

能力速览：按场景分组

私有服务器运营：仓库提供 authserver（3724 端口）与 worldserver（8085 端口）两个入口，账号、角色、世界数据存在 MySQL 的三套库里，玩家登录、进副本、刷怪物都走这里的逻辑。
内容定制：游戏核心逻辑集中在 server/game 子目录，脚本按区域与职业划分；另有一套模块化扩展体系，见 modules/ 目录。
部署与数据：仓库自带 docker-compose.yml，一条命令拉起数据库、导入工具和两个服务；客户端地图数据有现成的提取与导入工具链。
质量与观测：单元测试、Go 编写的在线端到端测试，加上 Grafana 监控面板模板，方便盯性能。

5 分钟部署你的第一座 WotLK 私服

准备项	说明
系统	Linux、macOS 或 WSL2，8GB 内存起步
客户端	正版 WoW 3.3.5a 客户端文件
编译路线依赖	CMake 3.x、C++17 编译器、MySQL 8
Docker 路线	只需 Docker 与 compose 插件

git clone https://gitcode.com/GitHub_Trending/az/azerothcore-wotlk

./acore.sh init && ./acore.sh setup-db && ./acore.sh build

cd env/dist/bin && ./authserver && ./worldserver

第一条克隆源码；第二条依次装依赖、建库导数据、编译出二进制；第三条把两个服务跑起来。Docker 玩家直接docker compose up -d --build即可。预期：客户端指向 127.0.0.1 建角进世界。登录被拒先翻 env/dist/logs 里 worldserver 的报错，多半是库连接配置没对上。

实战工作流

5 分钟从克隆到首次注入客户端

前置：一台干净机器，装好 Docker。

克隆仓库，把游戏 3.3.5a 客户端目录放到 var/client 下备用。
执行docker compose up -d --build，等数据库容器健康检查通过、导入任务跑完。
客户端里把服务器地址指到 127.0.0.1，选择 3.3.5a 区域。
创建角色，进世界。

预期：登录界面出现你的服务器名。排障：端口被占用先docker compose down；日志连不上库，多半是 root 密码与默认值不一致。

让自定义内容进数据库

前置：服务器已能启动，会写基本 SQL。

把新文件放进 data/sql/updates/pending_db_world/ 这类待处理目录，按现有序号命名。
本地重启后观察导入日志，确认语句逐条执行成功。
验证无误后，用仓库脚本把 pending 合并进正式 updates 目录。

预期：数据库版本前进一步，重启后内容生效。排障：base 与已合并的 updates 是只读历史，改错位置不会被执行；语句报错就停在该文件，修好再跑。

装一个社区模块

前置：已完成一次完整构建。

把模块放进 modules/ 下，目录里带自己的 CMakeLists.txt。
重新构建；不想要的模块用-DDISABLED_AC_MODULES="mod1;mod2"关掉。
启动后看日志确认加载成功。

预期：模块功能生效。排障：编译失败多半是缺依赖，先单独构建模块定位报错。

进阶与自定义

想写自己的扩展，先读 modules/how_to_make_a_module.md，照模板建目录、改加载脚本。
数据库更新规范：新 SQL 只进 pending 目录，历史目录一律别动。
调参数看 worldserver 的 conf 模板（server/apps 下）；想盯延迟与帧率，从 apps/grafana/ 的四块面板起步。

排障速查

症状	最可能原因	一句话解法
3724/8085 端口占用	旧进程没退干净	`docker compose down`后重启
数据库导入中途失败	密码或库名不一致	对齐 conf 里的连接参数后重跑导入
客户端能连上但角色列表为空	三套库没导齐	重跑 setup-db 或导入容器
飞行/落体异常、地形穿透	缺 mmaps/vmaps 碰撞数据	用仓库提取工具重新生成
客户端数据目录为空	客户端文件没挂进容器	检查 docker-compose 里的客户端卷映射
模块加载报错	模块与核心版本不匹配	换对应分支的模块或禁用它