effect · `release_puppet`

Definition

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

Description

releases specified country as puppet using states you own

实战 · 配合 · 坑

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

实战用法

release_puppet 常用于剧本事件或国策树中，让一个大国将其占领的领土以傀儡国形式释放，例如战后和平谈判、殖民地独立或历史性分裂事件。调用时必须在目标国家的 scope 内执行，效果会自动将执行者所拥有（own）的、属于目标国的州省转交并建立傀儡关系。

# 在一个事件 option 中，让 GER 把 POL 作为傀儡释放
option = {
    name = my_event.1.a
    GER = {
        release_puppet = POL
    }
}

配合关系

[end_puppet](/wiki/effect/end_puppet)：先解除旧傀儡关系再重新建立，适合更换傀儡类型或重置从属状态时与 release_puppet 搭配使用。
[add_state_core](/wiki/effect/add_state_core)：在释放傀儡前为目标国添加核心，确保释放后的傀儡对相关州省拥有合法核心，避免出现无核心的尴尬局面。
[has_autonomy_state](/wiki/trigger/has_autonomy_state)：用于触发条件判断当前是否已存在某种自治状态，从而决定是否需要调用 release_puppet 或跳过。
[diplomatic_relation](/wiki/effect/diplomatic_relation)：释放傀儡后可用此命令进一步调整双方外交关系（如保证独立、军事通行权等），完善外交链。

常见坑

Scope 写反：release_puppet 必须在宗主国（拥有州省的国家）的 scope 下执行，写成在被释放国的 scope 里调用会导致命令无效甚至报错，新手常把 THIS 和目标国搞混。
没有拥有对应州省：该 effect 只会划转执行国**own（拥有）**的州省，而非 control（控制）的州省。如果宗主国只是占领而没有实际拥有那些州省，释放出来的傀儡将没有任何领土，形成空壳国。

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_puppet is commonly used in event scripts or national focus trees to have a major power release occupied territory as a puppet state, such as in post-war peace negotiations, colonial independence, or historical dissolution events. The effect must be executed within the scope of the releasing nation, and it automatically transfers states owned (own) by the executor that belong to the target nation and establishes the puppet relationship.

# In an event option, have GER release POL as a puppet
option = {
    name = my_event.1.a
    GER = {
        release_puppet = POL
    }
}

Synergy

[end_puppet](/wiki/effect/end_puppet): Terminates the old puppet relationship before reestablishing it; useful when paired with release_puppet to change puppet types or reset vassal status.
[add_state_core](/wiki/effect/add_state_core): Adds cores to the target nation before releasing it as a puppet, ensuring the released puppet has legitimate cores over relevant states and avoiding the awkward situation of a coreless state.
[has_autonomy_state](/wiki/trigger/has_autonomy_state): Used in trigger conditions to check whether a certain autonomy state already exists, determining whether release_puppet needs to be called or skipped.
[diplomatic_relation](/wiki/effect/diplomatic_relation): After releasing a puppet, this command can be used to further adjust diplomatic relations between both sides (such as guaranteeing independence, military access rights, etc.), completing the diplomatic chain.

Common Pitfalls

Reversed Scope: release_puppet must be executed within the scope of the overlord (the nation owning the states), not the releasing nation's scope. Calling it within the scope of the nation being released will cause the command to be ineffective or even error out; newcomers often confuse THIS and the target nation.
Not Owning the Corresponding States: This effect only transfers states that are own (owned) by the executing nation, not control (controlled) states. If the overlord merely occupies those states without actually owning them, the released puppet will have no territory, forming a hollow state.

effect · release_puppet