effect · add_planning

实战用法

add_planning 常用于 mod 中为新生成或晋升的将领初始化能力值，例如在国家焦点或事件中给某位特定指挥官增加计划技能，使其更擅长预备进攻阶段的规划效率。也常用于动态成长系统中，根据战场表现或触发条件奖励将领成长。

# 在事件 option 中为某位角色提升计划技能
character:GER_erich_von_manstein = {
    add_planning = 2
}

配合关系

• [add_skill_level](/wiki/effect/add_skill_level)：同步提升将领的综合等级，与 add_planning 配合可在奖励事件中同时提高等级和单项技能，使成长更全面。
• [boost_planning](/wiki/effect/boost_planning)：boost_planning 提供临时或额度式的计划值加成，与 add_planning 结合可区分"永久成长"和"短期强化"两种设计需求。
• [planning_skill_level](/wiki/trigger/planning_skill_level)：用于检查当前计划技能是否已达阈值，避免重复触发导致数值溢出或不合理堆叠。
• [add_unit_leader_trait](/wiki/effect/add_unit_leader_trait)：计划技能提升后常配合赋予相关特质（如"谨慎的计划者"类），让数值成长与特质叙事保持一致。

常见坑

1. Scope 错误：add_planning 只能在 CHARACTER scope 下执行，若直接写在国家 scope（如 GER = { add_planning = 1 }）中会报错或静默失效，必须先通过 character:XXX = { } 或相关事件的 FROM/ROOT 进入正确的角色 scope。
2. 与将领类型无关的角色上使用：对没有担任任何军事职务（如纯顾问角色）的角色使用该指令，数值虽可能写入但在游戏界面不会体现任何效果，建议配合 [is_unit_leader](/wiki/trigger/is_unit_leader) 先做判断再执行。