effect · add_threat

实战用法

add_threat 常用于事件或决议中模拟某国的侵略性行为对世界局势的冲击，例如吞并小国、违反条约、发动突袭宣战时给施害国叠加威胁值，从而触发其他国家组建对抗同盟或加速进入战争状态。也可在 focus 完成时给玩家施加惩罚性威胁，配合叙事增强外交压力感。

# 某国宣战后，在 hidden_effect 中给该国增加威胁
hidden_effect = {
    add_threat = 5
}

配合关系

• [has_added_tension_amount](/wiki/trigger/has_added_tension_amount)：用于检测当前累计威胁值是否达到阈值，与 add_threat 配合可实现"威胁超限则触发事件"的逻辑闭环。
• [add_war_support](/wiki/effect/add_war_support)：侵略国威胁上升时，受威胁邻国往往同步获得战争支持度加成，两者配合模拟国际舆论反弹。
• [create_wargoal](/wiki/effect/create_wargoal)：高威胁通常伴随宣战目标的生成，两条指令写在同一 option 内可还原历史上"侵略国先积累借口再宣战"的流程。
• [add_opinion_modifier](/wiki/effect/add_opinion_modifier)：威胁增加后同步降低他国好感度，使外交惩罚立体化而不仅停留在威胁数值层面。

常见坑

1. 误用 scope：add_threat 只能作用于 COUNTRY scope，新手有时在 owned_state 或 unit_leader 子块里调用，会导致脚本静默报错或效果不生效，必须确保调用时处于国家 scope。
2. 数值无法负向清零：传入负数并不能将威胁降至 0 以下，且游戏本身也有自然衰减机制，若想快速清除威胁应使用专门的降威胁手段而非简单传负值，否则数值行为与预期不符。