effect · dismantle_faction

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

1. 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.
2. 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.