effect · set_faction_leader

实战用法

set_faction_leader 常用于 mod 中实现国家权力更迭或剧情事件后的派系领导权转移，例如让某国通过国策或事件取代原有领导国成为联盟核心。典型场景包括：玩家扶植的傀儡国崛起后自立为派系领袖，或原领导国被消灭后由最强盟友接管。

# 某国完成国策后成为本方派系领袖
focus = {
    id = claim_faction_leadership
    ...
    completion_reward = {
        set_faction_leader = yes
    }
}

配合关系

• [create_faction](/wiki/effect/create_faction)：若当前国家尚无派系，需先建立派系，才能再用 set_faction_leader 确立领导地位，二者常顺序搭配。
• [dismantle_faction](/wiki/effect/dismantle_faction)：在重组派系剧情中，可先解散旧派系再由新国家重建并夺取领导权，常与 set_faction_leader 形成完整流程。
• [has_country_flag](/wiki/trigger/has_country_flag)：用于在执行领导权转移前做条件判断，确保只有满足特定剧情标记的国家才会触发该 effect，避免逻辑混乱。
• [add_to_faction](/wiki/effect/add_to_faction)：设定新领袖后，通常需要将其他成员国重新拉入派系，两者配合保证派系成员结构完整。

常见坑

1. 国家不在任何派系中时使用会报错或无效：set_faction_leader 要求执行国本身已经是某个派系的成员，若该国既未加入也未拥有派系则指令不生效，必须先通过 create_faction 或 add_to_faction 确保派系存在。
2. 误在非 COUNTRY scope 下调用：此 effect 只能在国家 scope 内执行，若被误写在 STATE 或 CHARACTER scope 下（例如嵌套在 every_owned_state 块内忘记切回国家 scope），会导致脚本错误或静默失败。