effect · remove_power_balance

Hands-On Usage

remove_power_balance is commonly used in mods to clean up when a focus or event concludes a power balance system for a faction, such as when an ideological civil war ends or factional struggles reach a conclusion and the power balance mechanism needs to be completely removed from the country. The following example demonstrates removing a custom power balance in an event option:

country_event = {
    id = my_mod.10
    option = {
        name = my_mod.10.a
        # Civil war ends, remove faction power balance
        remove_power_balance = {
            id = my_faction_power_balance
        }
    }
}

Synergy

• [has_any_power_balance](/wiki/trigger/has_any_power_balance) — Use this trigger before removal to check whether the country actually has any power balance, avoiding errors from attempting to remove non-existent balances.
• [add_dynamic_modifier](/wiki/effect/add_dynamic_modifier) — Power balances often work in conjunction with dynamic modifiers. After removing a balance, you typically need to synchronously remove or replace related dynamic modifiers to maintain consistency in numerical state.
• [add_ideas](/wiki/effect/add_ideas) — In some designs, fluctuations in power balance grant specific ideas to the country. When removing the balance, coordinate with idea management to ensure the country's state is fully reset.
• [country_event](/wiki/effect/country_event) — Trigger subsequent events after removing the power balance for narrative continuity or to notify the player that the mechanism has ended.

Common Pitfalls

1. Incorrect id specification: The id must exactly match (case-sensitive) the id declared in the power_balance definition file. When filled incorrectly, the game will not produce a conspicuous error—the balance simply fails to be removed silently, leaving the mechanism lingering on the country.
2. Removing without checking if the balance exists: In generic events or effect blocks where a country may not necessarily have the balance, you should first protect with [has_any_power_balance](/wiki/trigger/has_any_power_balance) or appropriate conditions. Otherwise, executing this effect on a country without that balance may generate unexpected log warnings or even script errors.