effect · `retire_character`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Un-assigns a character from a nation and all its corresponding jobs, advisor, unit leader, country leader

Example:
retire_character = GER_Character_Token

实战 · 配合 · 坑

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

实战用法

retire_character 常用于剧情事件中强制将某个人物"退休"——例如国家领袖被政变推翻、将领阵亡/叛逃等情节，或者 Focus 完成后需要将旧角色清场以替换新角色。在 mod 中尤其适合搭配 create_country_leader / create_corps_commander 等指令，先退休旧角色再生成新角色，实现人事换代。

# 某国家焦点完成后，将旧顾问/领袖退休
complete_focus_effect = {
    retire_character = GER_old_advisor_token
    add_ideas = GER_new_advisor_idea
}

配合关系

[generate_character](/wiki/effect/generate_character) — 先用此命令动态生成新角色，再配合 retire_character 移除旧角色，完成人物的无缝替换。
[create_country_leader](/wiki/effect/create_country_leader) — 退休当前国家领袖后，立即创建继任领袖，常见于政变、禅让等剧情事件。
[has_character](/wiki/trigger/has_character) — 在执行 retire 之前用此触发器确认目标角色确实存在于当前国家，避免无效调用。
[deactivate_advisor](/wiki/effect/deactivate_advisor) — 若只想暂时解除顾问职务而不彻底退休角色，可考虑先用此命令；两者对比有助于选择正确的处理方式。

常见坑

Token 必须属于当前 scope 的国家：retire_character 在 COUNTRY scope 下执行，若角色 Token 属于另一个国家（例如通过事件跨国触发时误用 ROOT/FROM 混淆），角色不会被退休且不会报错，效果静默失败，调试时极难发现。
退休即永久移除所有职务：该命令会同时解除角色的领袖、顾问、将领等所有身份，若只想移除某一个职务（如仅解除顾问职），应使用 deactivate_advisor 而非 retire_character，否则会误伤该角色在其他职位上的功能。

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_character is commonly used in scripted events to forcibly "retire" a character—such as a national leader being overthrown in a coup, a general's death/defection, or the need to remove an old character after a Focus completes to make room for a successor. In mods, it pairs particularly well with commands like create_country_leader / create_corps_commander, allowing you to retire the old character first and then spawn the new one, effectively rotating personnel.

# After a certain nation's focus completes, retire the old advisor/leader
complete_focus_effect = {
    retire_character = GER_old_advisor_token
    add_ideas = GER_new_advisor_idea
}

Synergy

[generate_character](/wiki/effect/generate_character) — Use this command to dynamically generate a new character first, then pair it with retire_character to remove the old one, achieving seamless character replacement.
[create_country_leader](/wiki/effect/create_country_leader) — After retiring the current national leader, immediately create a successor leader; commonly seen in coup d'état or abdication event chains.
[has_character](/wiki/trigger/has_character) — Before executing retire, use this trigger to confirm the target character actually exists in the current nation, avoiding ineffective calls.
[deactivate_advisor](/wiki/effect/deactivate_advisor) — If you only want to temporarily dismiss an advisor from duty without completely retiring the character, consider using this command first; comparing the two helps you choose the correct approach.

Common Pitfalls

The character token must belong to the nation in the current scope: retire_character executes under COUNTRY scope. If the character token belongs to another nation (such as when cross-country triggers are accidentally mixed up with ROOT/FROM during event execution), the character will not be retired and no error is raised—the effect silently fails, making it extremely difficult to debug.
Retirement permanently removes all positions: This command simultaneously strips the character of all roles as leader, advisor, general, etc. If you only want to remove a specific position (such as removing only the advisor role), use deactivate_advisor instead of retire_character; otherwise you risk breaking the character's functionality in other positions.

effect · retire_character