effect · set_leader_description

实战用法

set_leader_description 常用于动态叙事类 mod，当将领经历特定事件（如晋升、负伤、叛变）后，为其角色档案注入符合当前剧情的传记文本，实现"活的"人物成长感。它也常见于历史还原 mod，用于在特定历史节点切换将领的官方简介以匹配不同时期的史实描述。

# 某将领在历史事件触发后更新其描述
character_event = {
    id = my_mod.100
    hidden = yes
    immediate = {
        FROM = {
            set_leader_description = "CHAR_ROMMEL_PROMOTED_DESC"
        }
    }
}

配合关系

• [set_leader_name](/wiki/effect/set_leader_name)：两者经常同时调用，在叙事转折点同步更新将领的显示名称与传记描述，保持档案一致性。
• [set_leader_portrait](/wiki/effect/set_leader_portrait)：切换肖像的同时替换描述文本，使视觉与文字两套呈现都跟随剧情演变。
• [set_character_flag](/wiki/effect/set_character_flag)：先用 flag 记录"已触发描述更新"状态，再配合 [has_character_flag](/wiki/trigger/has_character_flag) 做条件判断，防止描述被重复覆盖。
• [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait)：为将领添加新特质的同时更新描述，让特质的背景故事通过传记文字得到解释。

常见坑

1. 本地化 key 未定义就引用：set_leader_description 的参数必须是已在 .yml 本地化文件中声明的字符串 key，若 key 不存在游戏不会报错但档案页会显示空白或原始 key 名，极易被误认为脚本不生效。
2. 在非 CHARACTER scope 下调用：该 effect 只对 CHARACTER scope 有效，若在 COUNTRY 或 STATE 等 scope 下误调用，游戏日志会抛出 scope 不匹配警告且命令静默失败，排查时需注意检查调用层级。