命令百科

trigger · surrender_progress

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

check if a country is close to surrendering

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

surrender_progress 常用于判断某国是否濒临投降，以便触发特殊外交事件或决议——例如在目标国即将崩溃时允许玩家发出最后通牒、签署停战协议，或在 AI 逻辑中让盟国判断是否值得继续增援。典型场景包括战争结束类 mod 事件的触发条件、以及和平谈判系统中的门槛检测。

# 当目标国投降进度达到一定程度时，触发停战提案事件
country_event = {
    id = my_mod.100
    trigger = {
        any_enemy_country = {
            surrender_progress > 0.5
        }
    }
}

配合关系

  • [has_capitulated](/wiki/trigger/has_capitulated)：surrender_progress 检测"趋势"，has_capitulated 检测"结果"，二者配合可构建从"濒临投降"到"已投降"的完整状态链判断。
  • [any_enemy_country](/wiki/trigger/any_enemy_country)：通常需要将 scope 切换到敌国，再在其内部调用 surrender_progress，二者几乎是固定搭档。
  • [alliance_strength_ratio](/wiki/trigger/alliance_strength_ratio)：同时检测敌方投降进度与双方战力比，可更精确地评估战争走向，避免单一数值误判。
  • [create_wargoal](/wiki/effect/create_wargoal)：在确认敌国已处于高投降进度后，适时生成新战争目标，扩大战果，形成"条件判断→施压行动"的完整逻辑闭环。

常见坑

  1. 将其误用于非交战国：surrender_progress 只在该国处于战争状态且存在实际战争压力时才会返回有意义的值；对未参战国使用时数值通常为 0，条件永远不会满足，导致逻辑静默失效而难以察觉。
  2. 阈值方向写反：新手容易写成 surrender_progress < 0.5 意图筛选"快要投降"的国家，但实际上该值越高代表越接近投降，应使用 > 0.5 才能正确捕捉濒临崩溃的状态。