effect · `release_autonomy`

Definition

Supported scope:COUNTRY
Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

releases specified country with specified level of autonomy.
Example:
ENG = { 
 release_autonomy = { 
  target = RAJ 
  autonomy_state = autonomy_puppet 
  freedom_level = 0.5 
  release_non_owned_controlled = yes # default no. if yes you will release states you only control as well  force_change_controller_for_non_ally_controlled = yes # default = no. if yes it will change the controller of the states you or your allies don't control (ie if an enemy occupying it, the ownership will change but not controller) }
}

实战 · 配合 · 坑

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

实战用法

release_autonomy 最常见于外交 mod 中，用于在焦点树、决议或事件里将某国从直接控制转变为自治领、傀儡等不同层级的自治状态。例如，英国历史 mod 可以在特定焦点完成后让印度获得更高自治度，或在战后和平会议事件中批量释放附庸：

# 在焦点完成后授予印度自治领地位
focus_complete_effect = {
    ENG = {
        release_autonomy = {
            target = RAJ
            autonomy_state = autonomy_dominion
            freedom_level = 0.4
            release_non_owned_controlled = yes
        }
    }
}

配合关系

[compare_autonomy_state](/wiki/trigger/compare_autonomy_state)：在执行 release_autonomy 前，先用该触发器检查目标国当前自治状态，避免重复降级或逻辑冲突。
[has_autonomy_state](/wiki/trigger/has_autonomy_state)：与上条类似，用于 trigger 块精确判断目标是否已处于预期自治层级，常作为 release_autonomy 的前置条件。
[add_autonomy_score](/wiki/effect/add_autonomy_score)：在释放自治的同时调整自治值进度，配合使用可让自治度变更更平滑、防止目标国因自治分过低立刻触发自动晋级/降级。
[diplomatic_relation](/wiki/effect/diplomatic_relation)：释放自治后可能需要同步建立或解除担保、军事进入等外交关系，常与 release_autonomy 写在同一执行块。

常见坑

忘记指定 release_non_owned_controlled：如果目标国的部分领土被己方控制但不属于己方，不加该字段默认为 no，这些省份将不会被纳入新自治国，导致版图残缺甚至脚本静默失败，新手很难察觉。
scope 写错位置：release_autonomy 必须在宗主国的 scope 下执行（即谁来"给予"自治），而非在目标国 scope 下调用；初学者常误将其写在 RAJ = { ... } 内部，导致游戏报错或效果无效。

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

release_autonomy is most commonly used in diplomatic mods to convert a nation from direct control to various autonomy tiers such as dominions or puppets within focus trees, decisions, or events. For example, a British history mod might grant India dominion status after completing a specific focus, or batch-release vassals in post-war peace conference events:

# Grant India dominion status after focus completion
focus_complete_effect = {
    ENG = {
        release_autonomy = {
            target = RAJ
            autonomy_state = autonomy_dominion
            freedom_level = 0.4
            release_non_owned_controlled = yes
        }
    }
}

Synergy

[compare_autonomy_state](/wiki/trigger/compare_autonomy_state): Before executing release_autonomy, use this trigger to check the target nation's current autonomy state, avoiding duplicate downgrades or logical conflicts.
[has_autonomy_state](/wiki/trigger/has_autonomy_state): Similar to above, used within trigger blocks to precisely determine whether the target is already at the expected autonomy tier, commonly serving as a prerequisite condition for release_autonomy.
[add_autonomy_score](/wiki/effect/add_autonomy_score): Adjust autonomy score progress while granting autonomy; combined usage allows smoother autonomy changes and prevents the target nation from triggering automatic promotion/demotion due to low autonomy points.
[diplomatic_relation](/wiki/effect/diplomatic_relation): After releasing autonomy, you may need to simultaneously establish or revoke guarantees, military access, and other diplomatic relations, commonly written in the same execution block as release_autonomy.

Common Pitfalls

Forgetting to specify release_non_owned_controlled: If portions of the target nation's territory are controlled by your nation but don't belong to it, omitting this field defaults to no, causing those provinces to not be incorporated into the new autonomous state, resulting in incomplete borders or even silent script failure that newcomers rarely catch.
Incorrect scope placement: release_autonomy must be executed under the overlord nation's scope (i.e., the one "granting" autonomy), not called under the target nation's scope; beginners often mistakenly place it inside RAJ = { ... }, causing the game to error or the effect to fail.

effect · release_autonomy