引言

世界事件（World Event）和节日活动让 MMO 世界保持”活着”的感觉——万圣节的糖果、冬幕节的礼物、仲夏火焰节的篝火。TrinityCore 通过 GameEvent 系统把这些周期性活动做成数据驱动：事件激活时刷出 NPC、投放物件、应用世界状态，结束时自动回收。本文拆解事件数据表、脚本钩子和自定义活动的完整开发方法。

一、GameEvent 系统的数据驱动设计

TrinityCore 世界事件的核心理念是：把”什么时候发生”和”发生时世界有什么变化”都做成数据库数据，而不是写死在代码里。这样增删活动无需改动核心逻辑，只需配置表并 reload。

核心表分两类：

1. game_event：事件调度 — 开始/结束时间、重复周期、公告
2. 关联表：事件内容 — 刷哪些 NPC、放哪些 GameObject、给哪些世界状态

二、game_event 调度表

SELECT eventEntry, start_time, end_time, occurence, length, holiday, description
FROM game_event WHERE eventEntry IN (12, 62);

时间模型示例：一个”每晚 20:00-23:00 开放的活动”，start_time 设为某天 20:00，occurence=1440（每天一次），length=180（持续3小时）。

三、事件内容关联表

事件激活时世界发生的变化通过多张关联表挂到 eventEntry：

1. 刷出 NPC（game_event_creature）

-- 事件激活时，creature 表中指定 guid 的 NPC 才出现
INSERT INTO game_event_creature (eventEntry, guid) VALUES
(12, 500001),
(12, 500002);

-- 对应的 creature 生成点需预先配置
-- 平时隐藏，事件开始时由 GameEventMgr 刷出

2. 投放 GameObject（game_event_gameobject）

INSERT INTO game_event_gameobject (eventEntry, guid) VALUES
(12, 600001);  -- 节日篝火、装饰树、礼物盒等

3. 添加/移除 NPC 的额外内容（game_event_npc_vendor）

-- 事件期间商人额外售卖的节日物品
INSERT INTO game_event_npc_vendor (eventEntry, guid, item, maxcount, incrtime)
VALUES (12, 90001, 60100, 0, 0);  -- 节日限定商品

4. 条件刷怪（game_event_creature_quest / quest 关联）

-- 事件期间才能接的任务
INSERT INTO game_event_creature_quest (eventEntry, id, quest) VALUES
(12, 90001, 12100);  -- NPC 在事件期间发放节日任务

5. 世界状态（game_event_model_equip / event_spawn_group）

spawn_group 可以让整组 NPC/GO 随事件批量激活，适合大型活动的成批内容管理：

INSERT INTO game_event_spawn_group (eventEntry, spawnGroupId, maxStack) VALUES
(12, 100, 1);

四、事件脚本钩子

纯数据覆盖不了的动态行为（事件开始时播放剧情、阶段切换、特殊 BOSS 出现）用脚本。TrinityCore 提供 WorldServerScript / GameEvent 钩子：

class game_event_custom_festival : public GameEventScript
{
public:
    game_event_custom_festival() : GameEventScript("game_event_custom_festival") {}

    void OnStart(uint16 eventId) override
    {
        if (eventId != 200)
            return;

        // 事件开始：全服公告、全局喊话、触发开场特效
        World::SendWorldText(LANG_FESTIVAL_BEGIN);

        // 在主城生成开场 NPC / 施放全屏视觉
        if (Creature* herald = SummonHeraldInCapitals())
            herald->AI()->Talk(SAY_FESTIVAL_OPEN);
    }

    void OnStop(uint16 eventId) override
    {
        if (eventId != 200)
            return;
        // 事件结束：清理临时状态、发放未领取奖励邮件
        World::SendWorldText(LANG_FESTIVAL_END);
    }
};

void AddSC_game_event_custom_festival()
{
    new game_event_custom_festival();
}

如果活动内部还有分阶段（如进攻事件分三波，每波强度递增），用事件内的 SmartAI 或自定义 InstanceScript 管理阶段，配合 world state 控制客户端进度条显示。

五、客户端节日联动

game_event 的 holiday 字段关联客户端 Holidays.dbc 定义的节日 ID。正确关联后：

• 游戏内日历显示该节日及时间
• 小地图出现节日图标提示
• 客户端播放节日相关的环境效果（如冬幕节主城装饰）

自定义节日在纯私服客户端中需要同步修改 DBC 文件，否则日历不显示。如果只是想要服务端活动效果，holiday 可留 0，事件逻辑照常工作，只是客户端日历无标记。

六、自定义世界事件完整示例

做一个”周末主城烟花庆典”：每周六 20:00-22:00。

-- 1. 调度：start 设某个周六20:00，每周重复，持续2小时
INSERT INTO game_event
(eventEntry, start_time, end_time, occurence, length, holiday,
 description, world_event, announce)
VALUES
(200, '2026-09-26 20:00:00', '2030-12-31 23:59:00',
 10080, 120, 0, '周末烟花庆典', 1, 1);
-- occurence 10080 = 7天

-- 2. 烟花 GameObject
INSERT INTO game_event_gameobject (eventEntry, guid) VALUES
(200, 600100),
(200, 600101);

-- 3. 节日商人
INSERT INTO game_event_creature (eventEntry, guid) VALUES (200, 500100);
INSERT INTO game_event_npc_vendor (eventEntry, guid, item) VALUES
(200, 500100, 60200);

-- 4. 节日任务
INSERT INTO game_event_creature_quest (eventEntry, id, quest) VALUES
(200, 500100, 12200);

七、GM 调试命令

# 强制启停事件（测试不用等时间）
.event active 200    # 立即激活事件 200
.event stop 200      # 立即停止
.event list          # 查看所有事件及当前状态
.event info 200      # 查看事件详情、下次时间
.event start 200     # 同上激活（不同版本命令略有差异）

# 改库后重载
.reload game_event_creature
.reload game_event_gameobject
# 部分版本需要 .reload event_* 系列或直接 reload events

调试技巧：先用 .event active 强制触发，验证 NPC/GO 是否正确刷出、任务能否接取、商人商品对不对，全部正常后再依赖自然调度。

八、常见坑

• guid 必须存在：game_event_creature/gameobject 引用的 guid 要先在 creature/gameobject 表定义，否则事件开始也刷不出来
• 时区与时间基准：start_time 按服务器时区/UTC 配置，要和实际期望对齐，差8小时是常见错误
• occurence 和 length 单位：都是分钟，别误用秒。length 必须小于 occurence
• 结束时残留：事件 NPC 若被玩家拉走到远处，结束回收时可能残留，动态召唤物脚本要自行清理
• 重复事件的首次触发：系统按 start_time + n×occurence 计算，start_time 设错会导致第一次开放时间不对
• 年度节日：万圣节这类跨月活动 occurence 很大（525600 分钟=年），直接用年度配置而非手工周期
• holiday 错配：holiday 指向错误 DBC 会让日历显示成别的节日

九、世界状态与进度型事件

对于需要玩家共同推进的大型事件（如收集物资、世界 BOSS 开门），TrinityCore 用 WorldState（世界状态变量）记录全服进度：

// 玩家上交物资时推进全服进度
uint32 progress = sWorld->getWorldState(WORLD_STATE_GATE_PROGRESS);
progress += contribution;
sWorld->setWorldState(WORLD_STATE_GATE_PROGRESS, progress);

// 达到阈值触发下一阶段 / 开门
if (progress >= PROGRESS_MAX)
    sGameEventMgr->StartEvent(EVENT_GATE_OPEN);

WorldState 通过 UpdateWorldState 包同步给客户端，驱动 UI 进度条。这是《安其拉开门》这类史诗级服务器事件的实现基础。

总结

TrinityCore 世界事件的精髓是数据驱动：game_event 管”何时”，game_event_creature/gameobject/npc_vendor/quest 系列表管”变什么”，GameEventScript 处理数据表达不了的动态开场和阶段，WorldState 支撑全服协作型事件。开发顺序建议先用纯数据表做一个简单的定时刷怪+商人活动，跑通 GM 强制触发调试，再尝试脚本化的多阶段大型事件。