trigger · has_guaranteed

Hands-On Usage

has_guaranteed is commonly used in diplomatic events or national focus scripts to check whether a nation has issued a guarantee to a target nation, allowing you to trigger cascading diplomatic responses or unlock specific options. For example, in an event you might check whether the player has guaranteed a minor nation, and if so, open options for "invite to faction" or "pressure":

# Check in event option trigger whether this nation has guaranteed Poland
option = {
    name = my_event.1.a
    trigger = {
        has_guaranteed = POL
    }
    # This option is only visible if this nation has guaranteed Poland
    add_political_power = -20
}

Synergy

• [any_guaranteed_country](/wiki/trigger/any_guaranteed_country) — When you need to check "whether there is a guarantee to any nation" rather than a specific one, use this alongside has_guaranteed to cover broader conditional branches.
• [has_defensive_war_with](/wiki/trigger/has_defensive_war_with) — After a guarantee triggers war intervention, pair this trigger to verify whether the guaranteed nation has entered a defensive war, forming a complete "guarantee → intervention" logic chain.
• [exists](/wiki/trigger/exists) — Before using has_guaranteed, first confirm that the target nation still exists to avoid unexpected results when referencing an eliminated nation.
• [give_guarantee](/wiki/effect/give_guarantee) — Issue a guarantee in an effect block, pairing with has_guaranteed to create an "if not guaranteed, then guarantee" condition-effect pair.

Common Pitfalls

1. Scope confusion: The subject of has_guaranteed must be the nation scope that holds the guarantee, while the tag in parentheses is the guaranteed nation. Beginners often reverse these, for example mistakenly using this trigger within the guaranteed nation's scope, causing the condition to never evaluate true.
2. Target nation no longer exists: If the guaranteed nation has been eliminated, directly referencing its tag may not error but logic fails silently. Wrap an outer exists = TAG check first to ensure the target nation is valid before using has_guaranteed for evaluation.