effect · set_leader_name

实战用法

set_leader_name 常用于动态叙事 mod 中，需要在特定剧情触发后为角色更换代号、化名或头衔的场景，例如特工身份暴露后改用真实姓名，或将程序化生成的将领重命名为玩家自定义名称。注意该命令不产生任何 tooltip，适合放在 hidden_effect 块中静默执行，避免日志刷屏。

# 示例：某特工任务完成后将代号改为真实姓名
character:SPY_AGENT_001 = {
    hidden_effect = {
        set_leader_name = "Heinrich Müller"
    }
}

配合关系

• [set_leader_portrait](/wiki/effect/set_leader_portrait)：改名后通常需要同步更换头像，保持角色视觉一致性，两者常在同一 hidden_effect 块中连用。
• [set_leader_description](/wiki/effect/set_leader_description)：重命名时往往也需要刷新角色背景描述，与 set_leader_name 搭配实现完整的"身份重塑"效果。
• [set_character_flag](/wiki/effect/set_character_flag)：在改名前后设置标记，用于追踪角色是否已经过重命名，防止事件重复触发导致名字被反复覆盖。
• [is_unit_leader](/wiki/trigger/is_unit_leader)：在调用改名前先用此触发器校验角色确实处于将领身份，避免对非将领角色执行无效操作。

常见坑

1. 忘记 scope 必须是 CHARACTER：直接在 COUNTRY scope 下调用会静默失败且无报错，必须先通过 character:TAG_CHARACTER_TOKEN = { ... } 或事件 FROM 等方式切入正确的角色 scope。
2. 与 set_character_name 混淆：set_character_name 修改的是角色的通用名（影响顾问、国家领袖等所有角色槽的显示），而 set_leader_name 只修改其作为单位指挥官时的名称；在同一角色身兼多职时误用两者会导致不同界面显示不一致。