Wiki

effect · release_on_controlled

Definition

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

Description

releases specified country as a puppet using your owned or controlled states

实战 · 配合 · 坑

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

实战用法

release_on_controlled 常用于剧本事件或决策中，让玩家或 AI 国家将占领区/控制区的某个标签扶植为傀儡国，而无需事先持有该国的全部核心州。典型场景包括：战后和平安排中解放被占国家作为附庸、或在内战脚本里让胜利方立刻控制并册立新政权。

# 示例：德国通过决策将占领的法国以傀儡形式释放
release_on_controlled = FRA

配合关系

  • [controls_state](/wiki/trigger/controls_state) — 在执行前检查是否确实控制了目标国家的关键州，避免因尚未占领而触发无效；
  • [exists](/wiki/trigger/exists) — 先判断目标标签是否已经作为独立国家存在，防止对已存活国家重复释放产生冲突；
  • [add_state_core](/wiki/effect/add_state_core) — 释放傀儡后，为宿主国添加对相关州的核心，强化傀儡关系的领土正当性；
  • [diplomatic_relation](/wiki/effect/diplomatic_relation) — 配合设置后续外交关系（如军事通行权），使傀儡建立后立即进入预期外交状态。

常见坑

  1. 误以为只需"拥有"州即可：该 effect 同时接受"控制"州，但若目标国家的首都州既未被拥有也未被控制，释放往往会静默失败——务必在触发前用 [controls_state](/wiki/trigger/controls_state) 或 [has_capitulated](/wiki/trigger/has_capitulated) 确认关键州确实在手。
  2. 未检查目标标签是否已独立存活：若目标国家当前以独立国家形式存在（[exists](/wiki/trigger/exists) 为 true 且并非傀儡），直接调用此 effect 可能产生意料之外的结果，应先用 annex_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

release_on_controlled is commonly used in scripted events or decisions to allow the player or AI nations to establish a puppet state from an occupied/controlled territory without needing to own all of that nation's core states beforehand. Typical scenarios include: liberating occupied nations as vassals in post-war peace settlements, or in civil war scripts where the victorious side immediately controls and establishes a new regime.

# Example: Germany releases occupied France as a puppet through a decision
release_on_controlled = FRA

Synergy

  • [controls_state](/wiki/trigger/controls_state) — Check before execution whether you actually control key states of the target nation, avoiding invalid triggers due to incomplete occupation;
  • [exists](/wiki/trigger/exists) — First verify whether the target tag already exists as an independent nation, preventing conflicts from releasing an already-existing nation;
  • [add_state_core](/wiki/effect/add_state_core) — After releasing the puppet, add cores to the host nation over relevant states to strengthen the territorial legitimacy of the puppet relationship;
  • [diplomatic_relation](/wiki/effect/diplomatic_relation) — Pair with subsequent diplomatic relations (such as military access rights) so the puppet enters the intended diplomatic state immediately upon establishment.

Common Pitfalls

  1. Mistakenly assuming only "owning" states is sufficient: This effect accepts both "controlled" states, but if the target nation's capital state is neither owned nor controlled, release often fails silently — always confirm key states are actually in your possession using [controls_state](/wiki/trigger/controls_state) or [has_capitulated](/wiki/trigger/has_capitulated) before triggering.
  2. Failing to check whether the target tag already exists as an independent nation: If the target nation currently exists as an independent nation ([exists](/wiki/trigger/exists) is true and is not a puppet), calling this effect directly may produce unexpected results; either handle it first with annex_country or other logic before releasing, or add a condition to skip it.