effect · leave_faction

实战用法

leave_faction 常用于 mod 中设计"退出同盟"的事件或决策，例如让某个小国在特定政治条件下宣布中立、脱离轴心国或盟国阵营。典型场景包括：玩家触发事件后选择"退出公约"、或 AI 在战争局势不利时通过隐藏效果自动脱离派系。

# 决策选项：宣布脱离派系
option = {
    name = my_event.1.a
    leave_faction = yes
    add_political_power = -50
    add_stability = -0.05
}

配合关系

• [has_country_flag](/wiki/trigger/has_country_flag)：在执行前先检查该国是否已被标记为"不得主动退出"，避免重复或冲突触发。
• [dismantle_faction](/wiki/effect/dismantle_faction)：若该国同时是派系领袖，单纯 leave_faction 会导致孤立子派系，应先用 dismantle_faction 解散派系再处理后续逻辑。
• [add_opinion_modifier](/wiki/effect/add_opinion_modifier)：退出派系后通常需要向原领袖添加负面观感修正，模拟外交破裂的现实影响。
• [create_wargoal](/wiki/effect/create_wargoal)：配合派系领袖方的后续事件，允许其对背叛者宣战，增强叙事连贯性。

常见坑

1. 对派系领袖直接使用会导致派系自动解散：HOI4 中派系领袖离开派系时，引擎会强制解散整个派系，若 mod 意图只是让领袖"换人"而非解散，应改用 dismantle_faction 配合 create_faction 重建，而非依赖 leave_faction。
2. scope 未切换到正确国家：leave_faction 的 scope 必须是要离开派系的那个国家本身，新手常在 ROOT 是派系领袖的情况下忘记用 PREV/FROM/every_faction_member 切换 scope，导致错误国家被踢出派系。