effect · `retire_ideology_leader`

Definition

Supported scope:COUNTRY
Supported target:none

Description

kills a ideology leader and removes him completely, making the next in line the new party leader

实战 · 配合 · 坑

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

实战用法

retire_ideology_leader 常用于剧情事件或国策完成后强制淘汰某一意识形态的现任党魁，使其从游戏中彻底消失并由候选人递补，典型场景包括政治清洗、政变失败后的清算、以及意识形态路线切换的过渡处理。例如在一个法西斯政变事件中，触发后移除原民主领袖：

country_event = {
    id = my_mod.10
    # ...
    option = {
        name = my_mod.10.a
        # 清除民主党领袖，使次位候选人接任
        retire_ideology_leader = democratic
    }
}

配合关系

[add_popularity](/wiki/effect/add_popularity)：在退休旧领袖的同时调整该意识形态的支持率，使政治局势更符合剧情逻辑。
[create_country_leader](/wiki/effect/create_country_leader)：退休现有领袖后立即创建一个新的领袖角色，精确控制接任人的特质与肖像，而非依赖自动递补。
[add_ideas](/wiki/effect/add_ideas)：配合退休事件添加新的国家精神，模拟领导层更迭带来的政策转变。
[has_country_leader_ideology](/wiki/trigger/has_country_leader_ideology)：在触发退休前先确认当前执政意识形态，避免在目标意识形态并未执政时误操作。

常见坑

忽略"彻底移除"的不可逆性：该 effect 会将领袖从游戏中完全删除而非仅卸任，若后续剧情仍需引用该角色（如特定事件检查），会导致找不到目标角色而静默失败，需提前规划好角色生命周期。
未指定正确的意识形态 token：参数必须使用游戏内实际定义的意识形态 token（如 democratic、fascism、communism、neutrality），若拼写错误或使用子意识形态名称，指令将不生效且不报错，新手容易误以为是其他逻辑问题。

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_ideology_leader is commonly used in flavor events or after national focus completion to forcefully remove the current party leader of a given ideology, causing them to permanently disappear from the game and be replaced by a successor candidate. Typical scenarios include political purges, post-coup purges following failed coups, and transitional handling during ideology line switches. For example, in a fascist coup event, triggering it removes the original democratic leader:

country_event = {
    id = my_mod.10
    # ...
    option = {
        name = my_mod.10.a
        # Remove the democratic party leader, allowing the next candidate to assume office
        retire_ideology_leader = democratic
    }
}

Synergy

[add_popularity](/wiki/effect/add_popularity): Adjust the support rating of the ideology while retiring the old leader, making the political situation more aligned with narrative logic.
[create_country_leader](/wiki/effect/create_country_leader): Immediately create a new leader role after retiring the existing one, precisely controlling the successor's traits and portrait rather than relying on automatic succession.
[add_ideas](/wiki/effect/add_ideas): Pair the retirement event with new national spirits to simulate policy shifts resulting from leadership changes.
[has_country_leader_ideology](/wiki/trigger/has_country_leader_ideology): Confirm the current governing ideology before triggering retirement to avoid unintended operations when the target ideology is not in power.

Common Pitfalls

Overlooking the irreversibility of "complete removal": This effect permanently deletes the leader from the game rather than merely removing them from office. If subsequent events still need to reference that character (such as specific event checks), the target character will not be found, resulting in silent failure. Character lifecycle must be planned in advance.
Specifying the wrong ideology token: The parameter must use the actual ideology token defined in-game (such as democratic, fascism, communism, neutrality). If misspelled or if a sub-ideology name is used, the command will not take effect and will produce no error, leading newcomers to mistakenly attribute the issue to other logic problems.

effect · retire_ideology_leader