effect · add_named_threat

实战用法

add_named_threat 常用于事件或决策中，让某个国家的行为向全世界施加"威胁值"，从而触发其他国家的 AI 反应或联盟警觉机制。例如在扩张性国策或宣战事件中，为侵略方附加有具体名称标签的威胁，便于后续用该名称做条件判断或显示在 tooltip 中。

# 某国完成侵略性国策后触发
country_event = {
    id = my_mod.101
    immediate = {
        add_named_threat = {
            threat = 2
            name = my_mod_aggressive_expansion
        }
    }
}

配合关系

• [add_threat](/wiki/effect/add_threat)：无命名版本的威胁增加，两者常对比使用——需要在 UI 或脚本中追踪具体来源时用 add_named_threat，批量快速叠加时用 add_threat。
• [has_added_tension_amount](/wiki/trigger/has_added_tension_amount)：检测当前世界紧张度是否达到阈值，与 add_named_threat 配合构成"施加威胁 → 判断全局紧张局势"的完整逻辑链。
• [create_wargoal](/wiki/effect/create_wargoal)：AI 国家在威胁积累到一定程度后常被触发宣战目标，两者组合模拟"侵略升级"剧情。
• [add_opinion_modifier](/wiki/effect/add_opinion_modifier)：威胁上升后同步降低外交关系，让 mod 中的国际反应更真实立体。

常见坑

1. name 字段必须对应已本地化的字符串键，若未在 .yml 本地化文件中定义对应条目，游戏内 tooltip 会显示原始键名（如 my_mod_aggressive_expansion）而非可读文本，容易被误以为脚本出错。
2. 威胁是全局共享数值，不是单独施加给目标国——新手常误以为可以"只让某两国之间增加威胁"，实际上该 effect 作用于执行 scope 的国家，影响的是世界紧张度池，无法通过 target 限定接收方。