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
  }
}

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.