effect · add_faction_goal

实战用法

add_faction_goal 常用于派系机制 mod 中，当玩家或 AI 完成特定国策、事件后，为其所在派系动态追加新目标（如扩张领土、推翻某政权等），从而推动派系整体战略进程。例如，某国完成某条国策后自动为派系添加一个战争目标：

focus_complete_effect = {
    add_faction_goal = faction_goal_expand_east
}

配合关系

• [has_completed_faction_goal](/wiki/trigger/has_completed_faction_goal)：用于检测某派系目标是否已完成，常与 add_faction_goal 配合形成"添加目标 → 检测完成 → 触发奖励"的完整流程。
• [create_faction](/wiki/effect/create_faction)：在新建派系后紧接着用 add_faction_goal 为其设定初始目标，确保派系一诞生就有明确行动方向。
• [add_faction_goal_slot](/wiki/effect/add_faction_goal_slot)：派系目标槽位不足时需先扩充槽位，再调用 add_faction_goal 添加目标，两者顺序配合至关重要。
• [faction_goal_fulfillment](/wiki/trigger/faction_goal_fulfillment)：检测目标完成度，可用来决定是否继续追加下一阶段派系目标，与 add_faction_goal 构成阶段性推进逻辑。

常见坑

1. 忘记检查槽位上限：派系目标槽位有数量限制，若未提前用 add_faction_goal_slot 扩充槽位就直接添加目标，新目标将静默失败而不报错，导致策划逻辑无效执行。
2. 在非派系成员国 scope 下调用：该 effect 要求执行国必须已属于某个派系，若在独立国（未加入任何派系）的 scope 下调用，效果不会生效，新手常忽略预先判断国家是否在派系中。