Wiki

effect · boost_planning

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

Boost planning of units that are belongs to the army group/navy of this 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

boost_planning is commonly used in campaign opening events or scenario triggers to temporarily boost planning values for key commanders of the player or AI, simulating historical scenarios of "thorough pre-war preparation." For example, when a legendary general is appointed as an army group commander in an event, trigger this effect immediately to allow subordinate units to quickly fill up planning capacity and improve offensive efficiency.

# Triggered when a legendary general is appointed as army group commander
character_event = {
    id = my_mod.101
    hidden = yes

    immediate = {
        boost_planning = yes
    }
}

Synergy

  • [is_field_marshal](/wiki/trigger/is_field_marshal) — Use in limit blocks to confirm the current scope is an army group commander, preventing accidental triggers on non-commanding characters.
  • [add_planning](/wiki/effect/add_planning) — Combining the two enables "instant max-out + permanent bonus" dual benefits, ideal for showcasing the strategic talent of elite commanders.
  • [is_leading_army_group](/wiki/trigger/is_leading_army_group) — Further verifies the commander is currently leading an army group, ensuring the boost actually applies to subordinate units.
  • [add_temporary_buff_to_units](/wiki/effect/add_temporary_buff_to_units) — Use alongside boost_planning to apply temporary combat bonuses to subordinate units while filling planning capacity, enhancing campaign opening impact.

Common Pitfalls

  1. Scope Mismatch — This effect only works in CHARACTER scope; placing it in country or state blocks causes the engine to silently ignore it with no error message, rendering it completely ineffective. Use army_leader = { ... } or similar constructs to switch to the correct scope first.
  2. No Effect When Unassigned — If the character is not currently commanding any army group or navy, the effect produces no visible result. Pair it with [is_leading_army_group](/wiki/trigger/is_leading_army_group) as a precondition to avoid triggering at the wrong time and causing logical confusion.