Wiki

effect · add_autonomy_ratio

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Adds % freedom score to the autonomy.
Example:
add_autonomy_ratio={
value=0.005
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_ratio is commonly used in mod scenarios involving overlord/puppet relationships, such as in focus trees or decisions to give a puppet nation "one-time advancement of a certain percentage of autonomy progress," enabling it to reach independence or higher autonomy tiers more quickly without hardcoding fixed autonomy scores. The following example demonstrates adding autonomy ratio to the current nation (a puppet from the overlord's perspective) upon focus completion:

# Must switch to puppet scope first when in overlord scope before calling
puppet_scope = {
    add_autonomy_ratio = {
        value = 0.05
        localization = "FOCUS_GRANT_AUTONOMY_RATIO"
    }
}

Synergy

  • [compare_autonomy_progress_ratio](/wiki/trigger/compare_autonomy_progress_ratio): Detects the puppet's current autonomy progress ratio in trigger conditions; when paired with add_autonomy_ratio, it enables tiered logic such as "trigger further advancement only after reaching certain autonomy progress."
  • [add_autonomy_score](/wiki/effect/add_autonomy_score): Both modify autonomy through "percentage" and "absolute value" methods respectively; they often appear together to precisely control the magnitude of autonomy changes—one handles coarse-grained advancement while the other handles fine-tuning.
  • [has_autonomy_state](/wiki/trigger/has_autonomy_state): Checks which autonomy tier the puppet currently occupies (e.g., integrated puppet, dominion, etc.); paired with add_autonomy_ratio, it prevents script execution at incorrect autonomy stages and avoids logic conflicts.
  • [end_puppet](/wiki/effect/end_puppet): When autonomy progress accumulated by add_autonomy_ratio reaches maximum but independence logic still requires manual handling, you can invoke end_puppet in the same option to completely sever the puppet relationship, with both working together to complete the full independence flow.

Common Pitfalls

  1. Incorrect scope direction: add_autonomy_ratio must execute within the puppet nation's own scope; beginners often call it directly under the overlord's scope, resulting in command failure or errors. The correct approach is to first switch to the puppet's scope through puppet_scope or by specifying it in events before calling the command.
  2. Missing localization key causes display issues: While the localization field ostensibly only affects UI tooltip text, if you input a key that doesn't exist in the localization files, players will see the raw key string (e.g., LOC_KEY) in the autonomy interface. Always ensure the corresponding translation entry is added to the .yml localization file for that key.