effect · set_political_power

Hands-On Usage

set_political_power is commonly used in national events or focus completion rewards to reset political power to a precise value rather than simply incrementing or decrementing it—for example, forcing the player's political power to zero at a critical story point to simulate a political crisis, or setting a newly-formed nation's initial political power to a specific amount.

# After national focus completion, force political power to a fixed value
focus = {
    id = political_crisis
    ...
    completion_reward = {
        set_political_power = 0
    }
}

# In an event, reset a nation's political power to standard starting value
country_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        set_political_power = 100
    }
}

Synergy

• [add_political_power](/wiki/effect/add_political_power) — The two effects complement each other: set_political_power handles anchoring to an absolute value, while add_political_power handles subsequent relative adjustments. They are often used sequentially within the same event chain, setting first then adding.
• [add_stability](/wiki/effect/add_stability) — Significant political power resets typically coincide with stability adjustments, and together they create a sense of dramatic shift in the nation's political state.
• [has_country_flag](/wiki/trigger/has_country_flag) — Use flags to track whether a reset has already been triggered, preventing the same logic from executing multiple times and repeatedly zeroing political power.
• [add_ideas](/wiki/effect/add_ideas) — After political power is zeroed or heavily adjusted, it usually requires simultaneously granting an idea to reflect the new political landscape. The two effects are commonly paired within the same option block.

Common Pitfalls

1. Confusing with add_political_power: Beginners often mistakenly use add_political_power when they intend to "directly set a specific value," resulting in accumulation rather than overwriting. set_political_power is assignment (overwrite), while add_political_power is cumulative addition—the semantics are entirely different, and mixing them causes subtle numerical discrepancies that are hard to detect.
2. Overlooking decimal handling and hard limits: HOI4's political power has an internal maximum cap. If the value written by set_political_power exceeds the game's permitted range, the actual in-game value will be truncated. The script will not report an error, but the result will differ from expectations. When debugging, observe the actual values in-game rather than relying solely on code inspection.