Wiki

effect · add_autonomy_score

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds exact freedom score to the autonomy.
Example:
add_autonomy_score={
value=50
localization="LOC_KEY"
}

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

add_autonomy_score is commonly used in mod scenarios involving overlord-subject relationships. For example, immediately after an overlord completes a national focus or decision, autonomy score can be added to or subtracted from a subject, paired with localization keys to explain the score changes to players. It is particularly well-suited for creating mods like "Colonial Independence Routes" or "Imperial Integration Routes," where the pacing of autonomy progression can be dynamically adjusted through scripted events.

# After the overlord completes the "Strengthen Colonial Rule" decision, reduce the target subject's autonomy score
every_subject_country = {
    limit = {
        has_autonomy_state = autonomy_colony
    }
    add_autonomy_score = {
        value = -30
        localization = "DECISION_COLONIAL_CONTROL_SCORE"
    }
}

Synergy

  • [compare_autonomy_state](/wiki/trigger/compare_autonomy_state) — Check the subject's current autonomy state (such as colonial, puppet, etc.) first before deciding whether to apply score adjustments, preventing unintended triggers on incompatible subject types.
  • [compare_autonomy_progress_ratio](/wiki/trigger/compare_autonomy_progress_ratio) — Used to determine if the current autonomy progress ratio is approaching a threshold; combined usage enables fine-grained logic like "only trigger additional penalties when independence is imminent."
  • [add_autonomy_ratio](/wiki/effect/add_autonomy_ratio) — Complementary to each other: add_autonomy_score applies fixed absolute values, while add_autonomy_ratio applies proportional values; in complex scenarios, they can be combined to achieve either gradual or sudden autonomy shifts.
  • [add_opinion_modifier](/wiki/effect/add_opinion_modifier) — Autonomy score changes typically accompany diplomatic relationship shifts; synchronously adding opinion modifiers reinforces narrative consistency (such as the overlord's relations worsening after suppressing a subject).

Common Pitfalls

  1. Confusion over positive/negative direction of value: Positive values increase autonomy score (pushing the subject toward independence), while negative values decrease it. Beginners often mistakenly assume that "providing benefits to the overlord" should use positive numbers, inadvertently accelerating the subject's path to independence.
  2. Missing localization causing display garbling: The localization field requires a properly defined key in the corresponding .yml localization file. If omitted or misspelled, the autonomy interface's change notifications in-game will display the raw key string instead of readable text, degrading player experience.