effect · create_wargoal

实战用法

create_wargoal 常用于事件或决策驱动的剧本 mod 中，让某国在特定条件触发后自动获得对目标国的战争目标，而无需玩家手动通过外交界面申请。例如在一个"民族复仇"事件中，让一国在条约破裂后立即对另一国产生宣战借口：

country_event = {
    id = revenge.1
    # ...
    option = {
        name = revenge.1.a
        create_wargoal = {
            type = annex_everything
            target = FRA
        }
    }
}

配合关系

• [declare_war_on](/wiki/effect/declare_war_on)：create_wargoal 仅创建战争目标，若剧本需要立即开战，可紧随其后调用该命令，实现"获得借口→立即宣战"的完整流程。
• [has_annex_war_goal](/wiki/trigger/has_annex_war_goal)：用于检测某国是否已持有特定战争目标，可作为再次触发 create_wargoal 的前置条件判断，避免重复添加。
• [add_named_threat](/wiki/effect/add_named_threat)：宣战前额外增加世界紧张度，配合战争目标的创建，使 AI 局势反应更符合剧本预期。
• [country_event](/wiki/effect/country_event)：在创建战争目标后立即向目标国发送通知事件，给对方触发外交回应的机会，丰富事件链叙事。

常见坑

1. 漏写 target 字段：create_wargoal 必须在块内明确指定 target（即战争目标的对象国），不少新手误以为"scope 是谁就打谁"而省略该字段，导致脚本报错或效果不生效。
2. 在错误 scope 下调用：该 effect 只在 COUNTRY scope 下有效，若在 STATE 或 CHARACTER scope 内直接调用（忘记用 owner 等转换），战争目标将无法正常创建且不会有任何错误提示，排查时极易忽略。