effect · `add_planning`

Definition

Supported scope:CHARACTER
Supported target:none

Description

Adds planning skill to a unit leader
Example: add_planning = 1

实战 · 配合 · 坑

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

实战用法

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)：计划技能提升后常配合赋予相关特质（如"谨慎的计划者"类），让数值成长与特质叙事保持一致。

常见坑

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

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

add_planning is commonly used in mods to initialize ability values for newly generated or promoted commanders, such as granting a specific general increased planning skill in national focuses or events, making them more efficient in the preparation phase of attack planning. It is also frequently used in dynamic growth systems to reward commander development based on battlefield performance or triggered conditions.

# Grant a character increased planning skill in an event option
character:GER_erich_von_manstein = {
    add_planning = 2
}

Synergy

[add_skill_level](/wiki/effect/add_skill_level): Simultaneously increases a commander's overall level; when combined with add_planning, both level and individual skill can be improved in reward events, resulting in more comprehensive growth.
[boost_planning](/wiki/effect/boost_planning): boost_planning provides temporary or quota-based planning bonuses; when combined with add_planning, it allows distinguishing between "permanent growth" and "short-term enhancement" design requirements.
[planning_skill_level](/wiki/trigger/planning_skill_level): Used to check whether the current planning skill has reached a threshold, preventing repeated triggers that could cause value overflow or unreasonable stacking.
[add_unit_leader_trait](/wiki/effect/add_unit_leader_trait): After improving planning skill, it is often paired with assigning relevant traits (such as "Cautious Planner"), keeping numerical growth consistent with trait narrative.

Common Pitfalls

Scope Error: add_planning can only be executed within a CHARACTER scope. If written directly in a nation scope (such as GER = { add_planning = 1 }), it will cause an error or silently fail. You must first enter the correct character scope through character:XXX = { } or relevant event's FROM/ROOT.
Using on Characters Without Military Roles: When applying this command to characters with no military positions (such as pure advisor characters), the value may be written in but will show no effect in the game interface. It is recommended to first check with [is_unit_leader](/wiki/trigger/is_unit_leader) before execution.

effect · add_planning