Wiki

effect · add_planning

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

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

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

  1. 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.
  2. 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.