命令百科

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) — 若只想暂时解除顾问职务而不彻底退休角色，可考虑先用此命令；两者对比有助于选择正确的处理方式。

常见坑

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