effect · `promote_character`

Definition

Supported scope:COUNTRY, CHARACTER
Supported target:none

Description

promotes character to the head of their political party.If this is the ruling party, the character becomes country leader.if the character has several country leader role (i.e. several ideologies), then it is mandatory to provide the ideology to promote.

Example in country scope or scripted effects:
promote_character = GER_erwin_rommel
promote_character = {
  character = GER_erwin_rommel
  ideology = nazism
}


Example in character scope:
promote_character = yes
promote_character = nazism
promote_character = {
  ideology = nazism
}

实战 · 配合 · 坑

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

实战用法

promote_character 常用于国家焦点或事件中，将某个角色提升为执政党党魁（若该党为执政党则同时成为国家领袖），典型场景如政变事件、意识形态转变后的权力交接、或 DLC 式角色扮演 mod 中的剧情推进。当一个角色同时持有多个意识形态的国家领袖角色时，必须明确指定 ideology 参数，否则游戏无法判断应提升哪个身份。

# 在国家 scope 的事件 option 中，将 Rommel 提升为纳粹党魁/领袖
country_event = {
    id = ger.101
    option = {
        name = ger.101.a
        promote_character = {
            character = GER_erwin_rommel
            ideology = nazism
        }
    }
}

# 在角色自身 scope 中直接提升（无需指定角色名）
GER_erwin_rommel = {
    promote_character = nazism
}

配合关系

[add_country_leader_role](/wiki/effect/add_country_leader_role)：在提升角色之前，需确保该角色已持有对应意识形态的国家领袖角色，否则提升无效；两者通常成对出现。
[remove_country_leader_role](/wiki/effect/remove_country_leader_role)：用于在提升新领袖前移除旧领袖的执政角色，实现权力平滑交接，避免多个领袖同时存在导致逻辑混乱。
[add_country_leader_trait](/wiki/effect/add_country_leader_trait)：提升领袖后立即为其附加特质，丰富新领袖的属性表现，常见于剧情 mod 的权力交接段落。
[can_be_country_leader](/wiki/trigger/can_be_country_leader)：在执行提升前用作条件检查，确认该角色具备成为国家领袖的资格，防止在不满足条件时触发错误。

常见坑

多意识形态角色忘记指定 ideology：若一个角色通过 add_country_leader_role 绑定了多个意识形态，直接写 promote_character = GER_xxx 而不附带 ideology 字段，游戏将报错或行为不确定；务必在这种情况下使用块式写法并明确填写 ideology。
角色尚未拥有国家领袖角色就执行提升：promote_character 的前提是角色已经具备对应意识形态的国家领袖角色（通过 add_country_leader_role 或在角色定义中声明），若角色只有将领/顾问角色而没有领袖角色，该指令不会有任何效果，也不会报错，极易造成调试困难。

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

promote_character is commonly used in national focus trees or events to elevate a character to party leader of the ruling party (and simultaneously to national leader if that party is in power). Typical scenarios include coup events, power transitions following ideology shifts, or storyline progression in DLC-style character roleplay mods. When a character holds multiple national leader roles across different ideologies, the ideology parameter must be explicitly specified; otherwise, the game cannot determine which role to promote.

# In a country scope event option, promote Rommel to Nazi party leader/national leader
country_event = {
    id = ger.101
    option = {
        name = ger.101.a
        promote_character = {
            character = GER_erwin_rommel
            ideology = nazism
        }
    }
}

# Promote directly within the character's own scope (no need to specify character name)
GER_erwin_rommel = {
    promote_character = nazism
}

Synergy

[add_country_leader_role](/wiki/effect/add_country_leader_role): Before promoting a character, ensure they already possess a national leader role for the corresponding ideology; otherwise the promotion will have no effect. These two effects typically appear in pairs.
[remove_country_leader_role](/wiki/effect/remove_country_leader_role): Used to remove the old leader's ruling role before promoting a new one, enabling smooth power transitions and preventing logical confusion from multiple leaders existing simultaneously.
[add_country_leader_trait](/wiki/effect/add_country_leader_trait): Immediately attach traits to the newly promoted leader to enrich their attribute profile; commonly seen in storyline mod power transition sequences.
[can_be_country_leader](/wiki/trigger/can_be_country_leader): Serves as a precondition check before executing promotion, confirming the character qualifies to become a national leader and preventing errors from triggering when conditions are unmet.

Common Pitfalls

Forgetting to specify ideology for multi-ideology characters: If a character has been bound to multiple ideologies via add_country_leader_role, writing promote_character = GER_xxx without the ideology field will cause the game to error or behave unpredictably. Always use the block syntax and explicitly fill in the ideology field in such cases.
Attempting promotion before the character has acquired a national leader role: The prerequisite for promote_character is that the character already possesses a national leader role for the corresponding ideology (declared through add_country_leader_role or in the character definition). If the character only has general or advisor roles without a leader role, this command will have no effect and produce no error, making debugging extremely difficult.

effect · promote_character