Hands-On Usage
remove_power_balance_modifier is commonly used in dynamic management scenarios of the Power Balance system, such as when an event concludes, a country leaves a faction, or a certain phase completes and previously applied static modifiers need to be revoked. A typical scenario is in an option within a diplomatic crisis event where, after the player chooses to compromise, the balance modifier representing a hardline stance is removed.
# Crisis resolution event option: remove the balance modifier representing confrontational stance
option = {
name = my_crisis_event.1.a
remove_power_balance_modifier = {
id = my_cold_war_balance
modifier = hawkish_stance_modifier
}
}
Synergy
[add_power_balance_modifier](/wiki/effect/add_power_balance_modifier): Used in tandem with this command, adding and removing modifiers form a complete lifecycle management. The standard pattern is to add first, then remove.
[remove_all_power_balance_modifiers](/wiki/effect/remove_all_power_balance_modifiers): When you need to clear all modifiers on a power balance at once, serves as a bulk alternative and complements this command at a different granularity level.
[has_power_balance_modifier](/wiki/trigger/has_power_balance_modifier): Use this trigger to check whether the modifier actually exists before executing removal, avoiding logic anomalies caused by a non-existent modifier.
[add_power_balance_value](/wiki/effect/add_power_balance_value): After removing static modifiers, you often need to sync adjustments to the balance value; the two work together to achieve precise control during state transitions.
Common Pitfalls
- The
modifier field points to an unregistered static modifier: The value of modifier must have a corresponding definition in the static_modifiers database. Directly entering the name of an ordinary modifier will cause the command to fail silently, and the game log may not provide a clear error message. During troubleshooting, carefully verify the static_modifiers file.
- The
id does not match the actual power balance id: The id must be strictly identical (case-sensitive) to the id used in add_power_balance_modifier or the power balance definition. If no modifier has ever been attached to that id, the command will have no effect. Beginners often waste considerable debugging time due to id spelling inconsistencies during copy-paste operations.