effect · add_unit_leader_trait

实战用法

add_unit_leader_trait 常用于剧本事件或国策完成时，为某位将领解锁特定特质，例如让一名指挥官在完成特定战役后获得"老练老兵"或"媒体红人"之类的特质，增强其属性或触发特殊机制。在自定义将领成长体系类 mod 中，也常通过事件链逐步为将领追加特质来模拟成长路径。

# 某国策完成后，为指定将领添加特质
complete_national_focus = {
    SOV_konstantin_rokossovsky = {
        add_unit_leader_trait = brilliant_strategist
    }
}

配合关系

• [has_trait](/wiki/trigger/has_trait)：在添加特质之前先检查将领是否已拥有该特质，避免重复添加造成逻辑混乱。
• [remove_unit_leader_trait](/wiki/effect/remove_unit_leader_trait)：常与之配对使用，先移除旧特质再添加新特质，实现特质的"升级替换"效果。
• [add_timed_unit_leader_trait](/wiki/effect/add_timed_unit_leader_trait)：作为对比选项，当需要临时性特质时改用此命令，明确两者的适用场景。
• [add_skill_level](/wiki/effect/add_skill_level)：常在同一事件选项中同步提升将领技能等级，与特质添加共同构成对将领的"奖励包"。

常见坑

1. Scope 错误：此命令必须在 CHARACTER scope 下执行，直接写在 COUNTRY scope（如国策 effect 块）中而不先进入对应角色的 scope，会导致命令静默失效，且游戏日志中不一定给出明显报错。
2. 特质名拼写或类型不匹配：填入的特质必须是已在 unit_leader_traits 中定义的合法特质 token，且要与将领类型（陆军指挥官、海军指挥官等）相符——将海军专属特质添加给陆军将领不会报错但通常不会生效或显示。