effect · add_command_power

Hands-On Usage

add_command_power is commonly used in national focuses, decisions, or events to grant additional command power rewards to the player or AI. For example, upon completing a military reform focus, you can immediately replenish a large amount of command power to allow the player to quickly upgrade general skills. It can also be used in penalty scenarios by passing negative values to simulate command power loss from command confusion.

country_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        # Complete military reform and grant command power
        add_command_power = 25
        add_political_power = 50
    }
}

Synergy

• [command_power](/wiki/trigger/command_power): Check whether the current command power is below a certain threshold before applying the reward to avoid wasting points by exceeding the cap, making the logic more precise.
• [add_political_power](/wiki/effect/add_political_power): Military focuses or decisions typically award both political power and command power simultaneously, and combining these two creates a complete "dual military-political reward" effect.
• [add_trait](/wiki/effect/add_trait): While granting command power, add traits to generals at the same time, commonly used together in general growth event chains.
• [add_war_support](/wiki/effect/add_war_support): In wartime morale events, command power and war support are often increased together, jointly reinforcing the narrative effect of heightened morale.

Common Pitfalls

1. Negative values may not work as expected: Some game versions have a floor protection on command power reduction (cannot go below 0). Beginners often mistakenly assume they can use large negative values to completely "empty" command power as a penalty, but the actual effect may be clamped. You should use [command_power](/wiki/trigger/command_power) to check the current value first before deciding on the reduction amount.
2. Scope misuse: This effect only works within the COUNTRY scope. If placed in STATE or CHARACTER scope blocks (such as directly within an every_army_leader sub-block), the script will error or silently fail. Always ensure the effect is called within the correct country scope.