trigger · `is_puppet_of`

Definition

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

Description

Checks if the country is puppet of specified country

实战 · 配合 · 坑

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

实战用法

is_puppet_of 常用于傀儡国独立事件、自治度相关决策或宗主国专属焦点的限制条件，例如判断某国是否处于从属关系从而触发"争取独立"的剧情链。也常见于宗主国 side 的 focus available 块，用来确认目标国仍处于傀儡状态再解锁相关选项。

# 某国尝试通过决策脱离傀儡状态
available = {
    is_puppet_of = FROM   # 当前国家确实是 FROM 的傀儡才可触发
    has_stability > 0.6
}

配合关系

[has_autonomy_state](/wiki/trigger/has_autonomy_state)：与 is_puppet_of 联用可精确描述"是某国的特定自治等级傀儡"，比单独判断傀儡关系更细粒度。
[any_subject_country](/wiki/trigger/any_subject_country)：在宗主国 scope 下遍历所有附庸，配合 is_puppet_of 可反向确认关系链，用于多层傀儡嵌套场景的校验。
[end_puppet](/wiki/effect/end_puppet)：当条件满足时解除傀儡关系，通常和 is_puppet_of 写在同一事件的 trigger + effect 配对块中。
[compare_autonomy_state](/wiki/trigger/compare_autonomy_state)：与 is_puppet_of 同时出现在 limit 块，进一步过滤自治进度，避免在自治度即将提升时错误触发事件。

常见坑

scope 混淆：is_puppet_of 的 scope 必须是傀儡国本身，若误将 scope 切换到宗主国一侧执行该 trigger，条件将永远为假，且 CK/HOI4 日志不会给出明确报错，极难排查。
target 写死 TAG 而非动态作用域：新手常直接填硬编码国家标签（如 is_puppet_of = GER），在宿主国标签可变的动态剧本或 formable nation mod 中会失效；应优先使用 ROOT/FROM/PREV 等动态 target 以保证通用性。

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

is_puppet_of is commonly used in puppet state independence events, autonomy-related decisions, or as a restriction condition in overlord-exclusive focuses. For example, it determines whether a nation is in a vassal relationship to trigger independence storylines. It is also frequently seen in the overlord's focus available block to confirm the target nation remains a puppet before unlocking related options.

# A nation attempts to break free from puppet status through a decision
available = {
    is_puppet_of = FROM   # Current nation must actually be a puppet of FROM to trigger
    has_stability > 0.6
}

Synergy

[has_autonomy_state](/wiki/trigger/has_autonomy_state): When used together with is_puppet_of, it can precisely describe "being a puppet of a specific nation at a particular autonomy level," providing finer granularity than checking puppet status alone.
[any_subject_country](/wiki/trigger/any_subject_country): Iterates through all subjects in overlord scope; combined with is_puppet_of, it can reverse-confirm relationship chains and validate multi-layered puppet nesting scenarios.
[end_puppet](/wiki/effect/end_puppet): Removes puppet relationship when conditions are met; typically paired in the same event's trigger + effect block alongside is_puppet_of.
[compare_autonomy_state](/wiki/trigger/compare_autonomy_state): Appears simultaneously with is_puppet_of in limit blocks to further filter autonomy progress and prevent events from triggering incorrectly when autonomy is about to increase.

Common Pitfalls

Scope Confusion: The scope of is_puppet_of must be the puppet nation itself. If the scope is mistakenly switched to the overlord's side when executing this trigger, the condition will always evaluate to false. Since CK/HOI4 logs do not provide explicit error messages, this is extremely difficult to debug.
Hardcoding Target TAG Instead of Dynamic Scopes: Beginners often directly fill in hardcoded nation tags (e.g., is_puppet_of = GER), which will fail in dynamic scenarios or formable nation mods where the host nation tag is variable. Always prioritize dynamic targets like ROOT/FROM/PREV to ensure compatibility.

trigger · is_puppet_of