effect · `retire_country_leader`

Definition

Supported scope:COUNTRY
Supported target:none

Description

retires a country leader and removes him as leader of his party, making the next in line the new party and country leader

实战 · 配合 · 坑

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

实战用法

retire_country_leader 常用于剧情事件中触发领导人更迭，例如某国领袖因政变、暗杀或任期届满而下野，让党内下一顺位人选自动接任。它也常用于 focus 完成时强制替换现任领导人，以实现政治路线的切换。

country_event = {
    id = my_mod.10
    title = my_mod.10.t
    desc  = my_mod.10.d

    option = {
        name = my_mod.10.a
        # 退休现任领袖，党内下一顺位者接任
        retire_country_leader = yes
        add_political_power = -50
    }
}

配合关系

[create_country_leader](/wiki/effect/create_country_leader) — 先用此命令创建一位新领袖放入顺位，再执行 retire_country_leader，可精确控制谁来接替，实现"指定换人"效果。
[add_popularity](/wiki/effect/add_popularity) — 领袖退位后往往伴随意识形态支持率波动，配合调整可使政治局面更合理。
[add_ideas](/wiki/effect/add_ideas) — 新领袖上任后附加特定国策/顾问思潮，体现新政权的政策风格。
[has_country_leader](/wiki/trigger/has_country_leader) — 在触发条件中检测当前领袖是否存在，确保执行退休前领袖确实在任，避免无效调用。

常见坑

顺位为空导致无人接任：若当前领袖是该党唯一记录的角色，退休后党内顺位为空，国家可能出现无领袖状态或报错；务必提前用 create_country_leader 准备好继任人选，或确认原版已有顺位角色。
在非 COUNTRY scope 下调用：此 effect 只对国家 scope 有效，若误写在 state、character 等 scope 的执行块内，游戏会静默忽略或抛出错误日志，导致退休逻辑完全不生效，排查时需仔细检查 scope 层级。

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

retire_country_leader is commonly used in scripted events to trigger leadership succession—such as when a nation's leader steps down due to a coup, assassination, or term expiration, allowing the next candidate in line to automatically assume office. It is also frequently used upon focus completion to forcibly replace the incumbent leader, thereby switching the political direction.

country_event = {
    id = my_mod.10
    title = my_mod.10.t
    desc  = my_mod.10.d

    option = {
        name = my_mod.10.a
        # Retire the current leader; the next in line assumes office
        retire_country_leader = yes
        add_political_power = -50
    }
}

Synergy

[create_country_leader](/wiki/effect/create_country_leader) — Use this command to create a new leader and insert them into the succession line, then execute retire_country_leader to precisely control who takes over, achieving a "designated replacement" effect.
[add_popularity](/wiki/effect/add_popularity) — Leadership transitions often accompany ideology support fluctuations; coordinating these adjustments makes the political landscape more credible.
[add_ideas](/wiki/effect/add_ideas) — Attach specific national spirits or advisor ideologies when the new leader takes office, reflecting the new regime's policy orientation.
[has_country_leader](/wiki/trigger/has_country_leader) — Check in trigger conditions whether the current leader exists, ensuring the leader targeted for retirement is actually in office and preventing ineffective calls.

Common Pitfalls

Empty succession line leaving no one to assume office: If the current leader is the only recorded character in their party, retiring them leaves the succession line empty, potentially causing the nation to enter a leaderless state or trigger an error. Always prepare successors in advance using create_country_leader, or confirm that the vanilla game already has candidates lined up.
Calling outside COUNTRY scope: This effect only works within country scope; if mistakenly placed in execution blocks under state, character, or other scopes, the game will silently ignore it or log an error, causing the retirement logic to fail completely. When troubleshooting, carefully verify the scope hierarchy.

effect · retire_country_leader