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

实战 · 配合 · 坑

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

实战用法

boost_planning 常用于战役开局事件或剧本触发器中，为玩家或 AI 的关键指挥官临时提升计划值，模拟"战前充分准备"的历史场景。例如在某位名将被任命为集团军群司令的事件中，立即触发此 effect，让旗下部队快速蓄满计划度从而提升进攻效率。

# 某名将被任命为集团军群司令时触发
character_event = {
    id = my_mod.101
    hidden = yes

    immediate = {
        boost_planning = yes
    }
}

配合关系

[is_field_marshal](/wiki/trigger/is_field_marshal) — 用于 limit 中确认当前 scope 是集团军群指挥官，避免对不带兵的角色误触发。
[add_planning](/wiki/effect/add_planning) — 两者组合可实现"立即刷满+永久加成"的双重增益，适合表现精锐指挥官的战略才能。
[is_leading_army_group](/wiki/trigger/is_leading_army_group) — 进一步验证该指挥官当前确实在统帅集团军群，确保 boost 能实际作用到旗下单位。
[add_temporary_buff_to_units](/wiki/effect/add_temporary_buff_to_units) — 与 boost_planning 一同使用，在计划度拉满的同时给旗下部队附加临时战斗加成，强化战役开幕效果。

常见坑

Scope 错误：此 effect 只能在 CHARACTER scope 下使用，若写在 country 或 state 块内会被引擎静默忽略，不会报错但完全无效，需要用 army_leader = { ... } 等方式先切换到正确 scope。
无部队时无效：如果该角色当前未统帅任何集团军群或海军，effect 不会产生任何可见效果；建议搭配 [is_leading_army_group](/wiki/trigger/is_leading_army_group) 做前置检查，避免在错误时机触发造成逻辑困惑。

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

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

effect · boost_planning