VMaNGOS Progressive Vanilla 深度解析:从 WowPatch 到多版本数据加载机制 原创
VMaNGOS 的特别之处:把“版本变迁”做进数据层
很多魔兽世界模拟服只面向一个客户端版本:例如 1.12.1 或 3.3.5a。它们可以修复副本、法术和任务,但通常把“这个内容在哪个补丁出现、属性何时改变”视为一套固定数据。
VMaNGOS 的目标更具体:作为 Elysium / LightsHope 代码的独立延续,它要尽可能准确地重现经典旧世的渐进式内容开放。项目当前文档列出的客户端支持范围从 1.5.1、1.6.1、1.7.1、1.8.4、1.9.4、1.10.2、1.11.2 一直到 1.12.1,并持续向更早补丁推进。
真正值得开发者研究的,是它如何让数据库中的每个版本快照在运行时生效,而不只是支持几个客户端登录。
先分清两个版本:客户端 Build 与内容 Patch
这是部署 VMaNGOS 最容易混淆的地方。
| 概念 | 决定什么 | 在源码中的体现 |
|---|---|---|
| 客户端 Build | 协议、数据包布局、部分字段与功能是否可用 | SUPPORTED_CLIENT_BUILD、条件编译、对应 Build 的 DBC 目录 |
| 内容 Patch | 任务、NPC、物品、副本及规则应该采用哪个版本 | 配置 WowPatch,数据库 patch 字段,sWorld.GetWowPatch() |
例如使用 1.12.1 客户端,并不必然意味着服务端必须开放 1.12 的全部内容。你可以让客户端协议保持 1.12.1,同时把内容进度设为 1.6。
反过来,改 WowPatch 也不能把为某个 Build 编译的二进制变成支持所有客户端的通用二进制。VMaNGOS 初始化日志会分别输出:
Current content is set to Patch ...
Supported client build is set to ...
这两项应该作为部署验收的一部分,不要只检查“玩家能否登录”。
WowPatch:不是版本号字符串,而是进度索引
mangosd.conf 中的 WowPatch 使用 0–10 表示内容进度:
| 内容补丁 | WowPatch | 内容补丁 | WowPatch |
|---|---|---|---|
| 1.2 | 0 | 1.8 | 6 |
| 1.3 | 1 | 1.9 | 7 |
| 1.4 | 2 | 1.10 | 8 |
| 1.5 | 3 | 1.11 | 9 |
| 1.6 | 4 | 1.12 | 10 |
| 1.7 | 5 |
启动时,World::LoadConfigSettings 读取配置:
m_wowPatch = sConfig.GetIntDefault("WowPatch", WOW_PATCH_102);
if (m_wowPatch > MAX_CONTENT_PATCH)
m_wowPatch = MAX_CONTENT_PATCH;
官方配置模板默认 WowPatch = 10,即 1.12。若要做阶段服,应明确设置目标值,不要把默认值误当成 1.2 起始。
机制一:模板数据选择“当前补丁的最新快照”
ObjectMgr::LoadCreatureTemplates 是理解 VMaNGOS 数据版本化的好入口。它并不是简单执行:
SELECT ... FROM creature_template;
而是对每个 entry,选择 patch 不超过当前 WowPatch 的最大 patch 记录。其筛选逻辑可简化为:
SELECT ...
FROM creature_template t1
WHERE t1.patch = (
SELECT MAX(t2.patch)
FROM creature_template t2
WHERE t1.entry = t2.entry
AND t2.patch <= :current_patch
);
假设同一个 NPC 有三份定义:
| entry | patch | 定义 |
|---|---|---|
| 90001 | 0 | 1.2 初始版本 |
| 90001 | 4 | 1.6 属性调整版本 |
| 90001 | 7 | 1.9 新增对话版本 |
则 WowPatch 为 4 时选择 1.6 快照,WowPatch 为 5 或 6 时仍选择 1.6,WowPatch 为 7 后才切换到 1.9。WowPatch 为 0–3 时使用初始快照。
这就是“渐进式”的基础:旧定义不会被新定义覆盖丢失,新定义也不必在每个后续补丁重复复制。
机制二:地图刷新按 patch_min / patch_max 过滤
模板定义和地图刷新不是一回事。creature_template 描述“这个 NPC 是什么样”,creature 则描述“某个 GUID 在哪里刷新”。
VMaNGOS 加载 creature 与 gameobject 时读取 patch_min、patch_max,然后判断:
current_patch >= patch_min
AND current_patch <= patch_max
因此,同一个世界区域可以包含多个阶段性对象:某 NPC 只在 1.5–1.8 出现,某物件从 1.9 开始存在。数据不必随阶段切换而被物理删除。
源码还检查 patch_min > patch_max 或 patch_max > 10 等非法值,并输出数据库错误与修正建议。这说明版本字段不是装饰性备注,而是影响实际内容加载的约束。
装备模板等数据也采用有效区间筛选,例如:
WHERE :current_patch BETWEEN patch_min AND patch_max
机制三:规则默认值也随版本改变
只有数据库版本化还不够,因为经典旧世的部分规则本身就随补丁变化。VMaNGOS 的 World::LoadConfigSettings 包含这类条件:
- DebuffLimit 为 0 时按补丁决定:1.7 起为 16,此前为 8;
- 战场最大排队数量为 0 时按补丁决定:1.9 起为 3,此前为 1;
- 最低荣誉击杀配置为 0 时,按 1.10 前后采用不同默认值。
配置模板还提供 PvP 装备要求、荣誉时间线、宠物属性、LFG 可用性、PVE 事件、洗天赋费用衰减等渐进选项。
这里的工程原则是:配置值为 0 有时不是“禁用”,而是“让版本规则自动决定”。 修改配置前必须读该选项的注释,不能套用普通布尔配置习惯。
添加一条阶段性 NPC 数据,应该怎么思考
以下仅演示版本区间,不应把虚构 entry、guid 用于生产:
-- 一个从 1.6 开始才应出现的地图刷新
INSERT INTO creature
(guid, id, map, position_x, position_y, position_z,
patch_min, patch_max)
VALUES
(900001, 90001, 0, 1000.0, 2000.0, 100.0,
4, 10);
-- 如果同一个 NPC 在 1.9 改属性,保留旧模板并增加新快照。
-- 具体列必须与当前数据库结构和迁移版本一致。
-- entry = 90001, patch = 7
实际工作流应当是:
- 先确认内容变化对应的官方补丁;
- 确认要修改的是模板快照、刷新区间还是脚本条件;
- 在目标 WowPatch 下检查加载结果;
- 再检查前一补丁与后一补丁,确认边界没有串版本;
- 把数据来源和补丁依据写进变更说明,方便之后审计。
不要只把 patch 字段随意设为当前值,也不要为了“让 NPC 出现”把老数据直接 UPDATE 成新属性。这样会破坏 VMaNGOS 最重要的历史数据模型。
从阶段 1.6 开放到 1.9,不只是改一个数字
切换 WowPatch 后,服务端会按新补丁加载对应模板、刷新与规则。但运营服务器还要检查玩家已有数据:
- 玩家是否持有当前补丁尚无模板的物品?
- 旧角色任务状态与新阶段任务链是否一致?
- 副本开放和锁定策略是否符合运营计划?
- 拍卖行、PvP 奖励、洗天赋费用等规则是否要随阶段变化?
VMaNGOS 的配置中有 Progression.RestoreDeletedItems:允许因当前补丁不存在模板而被删除的物品,在以后加入游戏时通过邮件恢复。这正说明阶段切换会影响角色数据,不只是世界刷怪。
生产操作必须备份数据库,并先在复制环境演练。 不建议把 WowPatch 当作日常在线热切换开关;它决定启动时加载哪些内容,切换应纳入维护窗口和回滚计划。
为什么不能把 AzerothCore 的数据结构直接套过来
AzerothCore 面向 WotLK 3.3.5a,TrinityCore 当前主线也面向其他客户端世代。它们的数据库字段、脚本接口、DBC 结构与协议都有不同目标。
把 item_template、creature_template 或 SmartAI 的写法直接复制到 VMaNGOS,可能产生三类错误:
- 字段名称或含义不匹配,SQL 无法导入;
- 忽略 patch 字段,导致阶段内容无法正确加载;
- 用 C++ 硬编码解决内容差异,违背 VMaNGOS 优先数据库脚本、减少硬编码的项目原则。
可复用的是排查方法和游戏知识,不是未经校验的数据行。
部署与排错清单
| 检查项 | 正确做法 |
|---|---|
| 客户端无法登录 | 检查编译的客户端 Build,不要先改 WowPatch |
| 后期 NPC 提前出现 | 检查 WowPatch 和刷新的 patch_min / patch_max |
| NPC 属性不符合目标阶段 | 检查该 entry 是否存在多个模板 patch 快照 |
| DBC 加载失败 | 检查数据目录是否包含对应 Build 的子目录 |
| Debuff 或排队数量不对 | 检查相关配置是否保留为“按补丁自动决定” |
| 阶段升级后角色物品异常 | 检查阶段切换日志、模板覆盖与物品恢复配置 |
启动日志的两行“内容 Patch”和“客户端 Build”应与部署单一致。数据库校验则要同时覆盖 patch = current、patch < current 与 patch > current 三种记录,确认筛选确实生效。
总结
VMaNGOS 的核心竞争力不是“又一套 MaNGOS”,而是把版本演进变成了核心与数据库共同维护的一等数据:
模板按当前补丁选择最近快照,地图对象按有效区间加载,规则按补丁选择默认值,客户端协议则通过独立 Build 适配。
如果你要搭建经典旧世阶段服,理解这四个边界比先写自定义功能更重要。只有版本模型可靠,后续的任务修复、副本开放和运营阶段切换才有可审计的基础。
参考资料:VMaNGOS 官方仓库、VMaNGOS Wiki。本文依据 2026 年 11 月 18 日查看到的 development 分支,部署时以目标提交的配置模板与数据库迁移为准。