Wiki

effect · add_mio_policy_cooldown

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Add to the base cooldown (in days) after attaching a policy in the MIO policy, found in country in scope with input policy token.
This changes the base value. Modifiers will still apply over it.
Value can be negative to reduce cost, but final cooldown cannot be negative (capped at 0, no error raised)
ex:
SOV = {
  add_mio_policy_cooldown = {
	policy = my_policy_token
	value = 1
  }
  add_mio_policy_cooldown = {
	policy = my_policy_token
	value = -1
  }
  add_mio_policy_cooldown = {
	policy = my_policy_token
	value = var:my_number_var
  }
}

实战 · 配合 · 坑

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

实战用法

当你的 MIO 政策系统需要动态调整冷却节奏时(例如某个决策或科技研究完成后赋予减少政策冷却的奖励),可使用此 effect 直接修改基础冷却天数。典型场景是玩家通过完成国策或达成某条件后,获得"政策响应加速"效果,令 MIO 政策可更频繁地切换。

# 某国策完成后,缩短指定 MIO 政策的基础冷却
complete_national_focus = {
    effect = {
        SOV = {
            add_mio_policy_cooldown = {
                policy = industrial_efficiency_policy
                value = -30
            }
        }
    }
}

配合关系

  • [add_mio_policy_cost](/wiki/effect/add_mio_policy_cost):同样作用于 MIO 政策的数值属性,冷却与费用往往成对调整,一起用可完整地"强化"或"弱化"某条政策的切换门槛。
  • [add_ideas](/wiki/effect/add_ideas):通过添加国家精神来间接提供修改器,与本 effect 改变基础值互为补充——基础值由本 effect 直接设置,修改器层面则由 idea 上的 modifier 施加乘/加成。
  • [has_completed_focus](/wiki/trigger/has_completed_focus):常作为触发条件,判断某个国策是否已完成后再执行冷却调整,确保奖励的时机正确。
  • [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier):若冷却加成需要随时间变化或可撤销,可搭配动态修改器一同使用,两者分别负责"一次性基础调整"与"持续性修改器叠加"。

常见坑

  1. 混淆基础值与修改器层:本 effect 只改变"基础冷却天数",国家 modifier 中对政策冷却的乘/加成仍会在其之上继续计算。新手常以为设置负值就能彻底清零冷却,实际上最终冷却由基础值与所有修改器共同决定,且下限为 0。
  2. policy token 填写错误policy 字段必须填写该政策在脚本中定义的精确 token(区分大小写),若填写显示名称或拼写有误,游戏不会报错提示但效果完全无效,调试时极难发现。

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

When your MIO policy system requires dynamic cooldown adjustment (for example, granting a cooldown reduction reward upon completion of a decision or technology research), you can use this effect to directly modify the base cooldown days. A typical scenario is when players complete a national focus or meet certain conditions to gain a "policy response acceleration" effect, allowing MIO policies to be switched more frequently.

# After completing a national focus, reduce the base cooldown of a specified MIO policy
complete_national_focus = {
    effect = {
        SOV = {
            add_mio_policy_cooldown = {
                policy = industrial_efficiency_policy
                value = -30
            }
        }
    }
}

Synergy

  • [add_mio_policy_cost](/wiki/effect/add_mio_policy_cost): Also operates on numerical attributes of MIO policies. Cooldown and cost are often adjusted in pairs; using them together allows you to comprehensively "strengthen" or "weaken" a policy's switching threshold.
  • [add_ideas](/wiki/effect/add_ideas): Indirectly provides modifiers through adding national spirits, serving as a complement to this effect's base value modification—the base value is directly set by this effect, while the modifier tier is applied through modifiers on ideas as multipliers/additions.
  • [has_completed_focus](/wiki/trigger/has_completed_focus): Commonly used as a trigger condition to determine whether a national focus has been completed before executing cooldown adjustments, ensuring the timing of rewards is correct.
  • [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier): If cooldown bonuses need to vary over time or be revocable, you can use this alongside dynamic modifiers, with each handling "one-time base adjustment" and "persistent modifier stacking" respectively.

Common Pitfalls

  1. Confusing base value with the modifier tier: This effect only changes the "base cooldown days"; multipliers/additions to policy cooldown in national modifiers will continue to be calculated on top of this value. Beginners often mistakenly believe setting a negative value will completely eliminate cooldown, but the final cooldown is determined by both the base value and all modifiers combined, with a minimum of 0.
  2. Incorrect policy token entry: The policy field must contain the exact token of that policy as defined in the script (case-sensitive). If you enter the display name or make a spelling error, the game will not give an error message but the effect will be completely ineffective, making it extremely difficult to debug.