effect · add_scaled_political_power

Hands-On Usage

add_scaled_political_power is commonly used in diplomacy or economy-related mod scenarios. For example, when a major power aids a minor nation, the political influence granted scales automatically based on the industrial capacity gap between the two countries, avoiding the balance issues that come with hardcoded fixed values. It works well in reward blocks after events, decisions, or focus tree completions, allowing effects to change dynamically as the game progresses.

# Example: Major power grants political power to minor nation (scaled by IC gap between both sides)
country_event = {
    id = my_mod.1
    option = {
        name = my_mod.1.a
        add_scaled_political_power = {
            value = 50
            # Use a target nation's industrial capacity as the reference baseline for scaling
            reference = FROM
        }
    }
}

Synergy

• [add_political_power](/wiki/effect/add_political_power): When the scaled result doesn't meet your requirements, stack a fixed value on top to compensate, ensuring the recipient gains at least a minimum amount of political power.
• [add_stability](/wiki/effect/add_stability): In scenarios involving aid to industrially backward nations, political power and stability are often granted together to reflect the "great power support" effect.
• [has_country_flag](/wiki/trigger/has_country_flag): Use for conditional checks to ensure the scaled reward only triggers during specific diplomatic phases or after an aid agreement is reached, preventing duplicate grants.
• [add_relation_modifier](/wiki/effect/add_relation_modifier): Attach relation modifiers alongside the scaled political power grant, so diplomatic aid is represented both in numerical terms and in the relationship layer.

Common Pitfalls

1. Overlooking reference nation selection: The scaling multiplier depends on the IC gap between the two nations. If the reference nation is chosen incorrectly (for example, mistakenly using ROOT for self-comparison), a zero difference will cause the final effect to be zero as well, making it appear the command had no effect when in fact it's a logic error.
2. Miscalculating expected values when mixing with add_political_power: Beginners often assume the total from stacking both is linearly predictable, but the scaled result fluctuates based on game progression (both nations' IC changes in real-time) and cannot be treated as a fixed value in design spreadsheets when planning reward tiers.