effect · `end_puppet`

Definition

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

Description

Stops specefied country being a puppet of current country

实战 · 配合 · 坑

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

实战用法

end_puppet 常用于傀儡独立事件、自治等级提升脚本或特定国策链的收尾——当玩家或 AI 达成某个条件后，宗主国主动释放附庸为完全独立国家。例如在一条关于"帝国解体"的国策效果中：

focus = {
    id = GER_release_puppets
    # ...
    completion_reward = {
        every_subject_country = {
            limit = {
                has_autonomy_state = autonomy_puppet
            }
            ROOT = { end_puppet = PREV }
        }
    }
}

配合关系

[has_autonomy_state](/wiki/trigger/has_autonomy_state)：在执行 end_puppet 前用于限定目标，确保只对真正处于傀儡状态的国家解除关系，避免逻辑错误。
[every_subject_country](/wiki/effect/every_subject_country)：批量遍历所有附庸国，配合 end_puppet 可一次性释放多个傀儡，适合帝国瓦解类事件。
[give_guarantee](/wiki/effect/give_guarantee)：解除傀儡后立即给予保证，用于模拟"名义独立但仍受保护"的历史情境，过渡关系更自然。
[diplomatic_relation](/wiki/effect/diplomatic_relation)：在释放傀儡后调整双边外交关系（如设置互不侵犯或同盟），补完解放后的外交状态。

常见坑

scope 方向写反：end_puppet 要在宗主国 scope 下执行，目标填被解放的傀儡国。新手常在傀儡国自身 scope 里调用而不指向宗主国，导致命令无效或报错。
未先检查从属状态：直接对一个并非当前宗主国傀儡的国家执行 end_puppet 不会报错但也没有任何效果，建议始终配合 [has_autonomy_state](/wiki/trigger/has_autonomy_state) 或 [any_subject_country](/wiki/trigger/any_subject_country) 做前置校验，防止静默失效难以排查。

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

end_puppet is commonly used in puppet independence events, autonomy level advancement scripts, or as the conclusion of specific focus chains—when the player or AI meets certain conditions, the overlord actively releases its subject as a fully independent nation. For example, in a focus effect concerning "imperial dissolution":

focus = {
    id = GER_release_puppets
    # ...
    completion_reward = {
        every_subject_country = {
            limit = {
                has_autonomy_state = autonomy_puppet
            }
            ROOT = { end_puppet = PREV }
        }
    }
}

Synergy

[has_autonomy_state](/wiki/trigger/has_autonomy_state): Used before executing end_puppet to filter targets, ensuring only nations in true puppet status have their relationships severed, preventing logic errors.
[every_subject_country](/wiki/effect/every_subject_country): Iterates through all subject nations in batch; paired with end_puppet, it can release multiple puppets at once, ideal for empire dissolution events.
[give_guarantee](/wiki/effect/give_guarantee): Grants a guarantee immediately after releasing a puppet, useful for simulating "nominally independent yet still protected" historical scenarios, creating a smoother transition.
[diplomatic_relation](/wiki/effect/diplomatic_relation): Adjusts bilateral diplomatic relations after releasing a puppet (such as setting non-aggression pacts or alliances), completing the post-liberation diplomatic status.

Common Pitfalls

Reversed scope direction: end_puppet must execute within the overlord's scope, with the target being the puppet nation to be released. Beginners often call it from the puppet nation's own scope without pointing to the overlord, resulting in the command being ineffective or throwing errors.
Failing to verify subject status first: Executing end_puppet directly on a nation that is not the current overlord's puppet won't error but will have no effect either. Always pair it with [has_autonomy_state](/wiki/trigger/has_autonomy_state) or [any_subject_country](/wiki/trigger/any_subject_country) for preliminary validation to prevent silent failures that are difficult to troubleshoot.

effect · end_puppet