Wiki

effect · add_breakthrough_progress

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Add breakthrough progress to one specialization or all for a country scope.
The value can either be an absolute value or a script constant.

#### Example
Adding 3 breakthrough points to land specialization:

add_breakthrough_progress = { specialization = specialization_land value = 3 }

Adding -1 breakthrough points to all specializations:

add_breakthrough_progress = { specialization = all value = -1 }

Adding the value of the script constant `sp_breakthrough_progress.medium` to all specializations:

add_breakthrough_progress = { specialization = all value = sp_breakthrough_progress.medium }

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

add_breakthrough_progress is commonly used in mod scenarios involving research systems, such as rewarding players through national focuses, decisions, or events to accumulate breakthrough progress in specific specializations, or reducing breakthrough points for opposing factions under certain conditions. The following example demonstrates adding breakthrough progress to a nation's land specialization upon focus completion:

focus = {
    id = my_land_doctrine_focus
    # ...
    completion_reward = {
        add_breakthrough_progress = {
            specialization = specialization_land
            value = 5
        }
    }
}

Synergy

  • [has_breakthrough_points](/wiki/trigger/has_breakthrough_points): Check the current breakthrough point count before execution to implement conditional logic such as "grant bonus only upon threshold" or "prevent overflow".
  • [add_breakthrough_points](/wiki/effect/add_breakthrough_points): Works in tandem with this command—add_breakthrough_progress adjusts the progress bar, while add_breakthrough_points directly increments accumulated breakthrough points. Combined use enables more granular research reward systems.
  • [add_research_slot](/wiki/effect/add_research_slot): Often paired in the same research reward block; accelerating breakthrough progress while expanding research slots simultaneously creates powerful technology advancement rewards.
  • [add_tech_bonus](/wiki/effect/add_tech_bonus): Issued alongside breakthrough progress rewards to create "short-term research acceleration + long-term specialization breakthrough" dual incentives, ideal for focus completion or major event triggers.

Common Pitfalls

  1. specialization field typos: Beginners often mistakenly write land instead of specialization_land, causing script errors or silent failures. Always use the complete specialization identifier; all is the only special value that requires no prefix.
  2. Confusion between positive and negative values: Passing negative values will reduce breakthrough progress. If the intent is to grant a reward but a negative number is entered by mistake, it produces the opposite effect with no error warning. Pay special attention to value signs during debugging.