effect · `dismantle_faction`

Definition

Supported scope:COUNTRY
Supported target:none

Description

dismantle faction led by the current country

实战 · 配合 · 坑

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

实战用法

dismantle_faction 常用于剧本事件或国策结局中，模拟阵营领袖主动解散联盟的历史情境，例如某意识形态阵营在战争结束后宣告瓦解，或玩家国家通过特定决策退出并解散自己主导的联盟。注意只有作用域国家本身是阵营领袖时该命令才会生效，因此通常需要配合条件检查确保脚本逻辑正确。

# 国策完成后解散玩家领导的阵营
focus = {
    id = dissolve_our_faction
    ...
    completion_reward = {
        dismantle_faction = yes
    }
}

配合关系

[has_country_flag](/wiki/trigger/has_country_flag)：在执行解散前检查是否已触发特定剧情标记，避免重复执行或逻辑混乱。
[create_faction](/wiki/effect/create_faction)：解散旧阵营后立刻以新名称重建阵营，常用于阵营改组或意识形态转型剧本。
[add_to_faction](/wiki/effect/add_to_faction)：重建阵营后将核心盟友重新拉入，保持势力连续性。
[country_event](/wiki/effect/country_event)：解散阵营后向前成员国推送事件，通知其政治状态变化，增强叙事完整度。

常见坑

非阵营领袖执行无效：若执行该命令的 scope 国家不是阵营领袖（仅是普通成员），命令会静默失败且不报错，新手常因此误以为功能失效，务必先用相关条件确认该国是否持有领袖地位。
解散后成员国状态需手动处理：dismantle_faction 仅解散阵营本身，不会自动清除成员国之间的战争状态、保证关系或其他外交绑定，若剧本依赖这些状态须另行编写后续效果。

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

dismantle_faction is commonly used in scripted events or national focus outcomes to simulate a faction leader voluntarily dissolving an alliance, representing historical scenarios such as an ideological faction collapsing after war's end, or a player nation withdrawing from and disbanding their own faction through specific decisions. Note that this command only takes effect when the scoped nation is the faction leader; therefore, it typically needs to be paired with condition checks to ensure script logic is correct.

# Disband the player-led faction upon focus completion
focus = {
    id = dissolve_our_faction
    ...
    completion_reward = {
        dismantle_faction = yes
    }
}

Synergy

[has_country_flag](/wiki/trigger/has_country_flag): Check for specific narrative flags before executing the disband to avoid duplicate execution or logical conflicts.
[create_faction](/wiki/effect/create_faction): Immediately rebuild the faction under a new name after dismantling the old one, commonly used for faction restructuring or ideological transformation narratives.
[add_to_faction](/wiki/effect/add_to_faction): Reintegrate core allies into the rebuilt faction after creation to maintain continuity of power.
[country_event](/wiki/effect/country_event): Send events to former member nations after faction dissolution to notify them of political status changes, enhancing narrative completeness.

Common Pitfalls

Execution fails if not faction leader: If the scoped nation executing this command is not the faction leader (merely an ordinary member), the command silently fails without error reporting. Newcomers often mistakenly assume the feature is broken in such cases. Always confirm with relevant conditions beforehand whether the nation holds leadership status.
Manual handling required for member nation states after disbandment: dismantle_faction only dissolves the faction itself and does not automatically clear wars between member nations, guarantees, or other diplomatic bindings. If your narrative depends on these states being resolved, you must write additional follow-up effects.

effect · dismantle_faction