effect · add_nuclear_bombs

Hands-On Usage

add_nuclear_bombs is commonly used to award nuclear warhead stockpiles to the player or AI nations upon completion of nuclear research event chains, achievement rewards, or special national focuses. It can also be utilized in alternate history mods to simulate "nuclear proliferation" scenarios, allowing specific nations to acquire nuclear weapons ahead of schedule. Example scripts are provided below:

# Add nuclear bombs to the nation upon focus completion
complete_national_focus = {
    ...
    completion_reward = {
        add_nuclear_bombs = 3
    }
}

# Grant a specific nation nuclear bombs via event
country_event = {
    ...
    option = {
        name = my_event.opt_a
        add_nuclear_bombs = 1
    }
}

Synergy

• [has_completed_focus](/wiki/trigger/has_completed_focus): Check whether a nation has completed nuclear-related national focuses before deciding whether to trigger the nuclear bomb addition event, ensuring logical rigor and preventing unwarranted grants.
• [add_stability](/wiki/effect/add_stability): Nuclear acquisition is typically accompanied by changes in domestic morale or stability; using both effects together enriches the narrative depth of events.
• [add_named_threat](/wiki/effect/add_named_threat): Nuclear proliferation triggers international tension; pairing this with increased world tension amplifies the realism of geopolitical consequences.
• [add_war_support](/wiki/effect/add_war_support): Simulates the increase in public war enthusiasm following the nation's acquisition of nuclear deterrence; combining this with nuclear bomb acquisition events produces natural narrative flow.

Common Pitfalls

1. Attempting to deduct nuclear bombs with negative values: Some newcomers mistakenly believe that passing negative numbers can reduce nuclear warhead quantities, but this effect does not guarantee that negative value behavior functions as expected. Reducing nuclear bombs should be handled through alternative logic (such as set commands or variables); directly entering negative values may cause script errors or produce no effect.
2. Invoking outside of COUNTRY scope: This effect only functions within nation scope. If mistakenly written within state scope (such as inside every_owned_state) or character scope, the game will not display a conspicuous error, but nuclear bombs will not be added. During debugging, this oversight is easily missed.