命令百科

effect · puppet

Definition

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

Description

Puppets specified country. By default, cancels the puppets existing war relations.
Example 1:
ENG = {
  puppet = ITA
}
Example 2:
ENG = {
  puppet = {
    target = ITA
    end_wars = yes  # Optional, default yes. Will not cancel non-civil wars if set to no.
    end_civil_wars = yes  # Optional, default yes. Will not cancel civil wars if set to no.
  }
}

实战 · 配合 · 坑

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

实战用法

puppet 常用于和平事件、战后结算或焦点树完成后建立傀儡关系，例如在玩家完成某个外交焦点后令目标国家成为傀儡。在涉及内战剧本时，可通过 end_civil_wars = no 保留内战状态，让傀儡化不会强行结束进行中的内战。

# 英国通过焦点将埃及变为傀儡，但保留内战
focus = {
    id = ENG_puppet_egypt
    ...
    completion_reward = {
        ENG = {
            puppet = {
                target = EGY
                end_wars = yes
                end_civil_wars = no
            }
        }
    }
}

配合关系

  • [diplomatic_relation](/wiki/effect/diplomatic_relation) — 在建立傀儡关系后，可进一步通过该命令设置军事通行权、保证等外交状态，完善宗主-傀儡的外交框架。
  • [add_autonomy_score](/wiki/effect/add_autonomy_score) / [add_autonomy_ratio](/wiki/effect/add_autonomy_ratio) — 傀儡化后立即调整自治度分数，用于精确控制傀儡国的初始自治等级，避免其一开始就处于边缘状态。
  • [end_puppet](/wiki/effect/end_puppet) — 与 puppet 形成对立操作，常在同一个事件链里配合使用，处理"先解除旧傀儡关系再重建"的外交重组逻辑。
  • [has_autonomy_state](/wiki/trigger/has_autonomy_state) — 在执行 puppet 前先触发判断，确认目标国当前并非已处于某一自治等级，防止重复傀儡化导致脚本逻辑混乱。

常见坑

  1. 宿主 scope 写错：puppet 必须在宗主国的 scope 下调用，不能在被傀儡国的 scope 里写 puppet = SELF——那会让被傀儡国去傀儡自己，逻辑上无效且容易引发报错。
  2. 忘记 end_wars 的默认行为：默认 end_wars = yes 会自动取消傀儡化相关的战争，如果你的剧本需要保留宗主国正在进行的战争（例如傀儡后继续联合作战），必须显式写 end_wars = no，否则战争会被静默结束而不报任何错误。