Wiki

effect · recall_attache

Definition

  • Supported scope:COUNTRY
  • Supported target:THIS, ROOT, PREV, FROM, OWNER, CONTROLLER, OCCUPIED, CAPITAL

Description

Scope country recalls attache from target country. Example: GER = { recall_attache = CHI } means Germany recalls attache from China.

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

recall_attache is commonly used in mod scenarios involving diplomatic breakdown, declarations of war, or faction switching. It automatically withdraws attachés before relations deteriorate, ensuring logical consistency. For example, recalling an attaché before a country joins an opposing faction:

# Germany recalls its attaché from China before declaring war
GER = {
    recall_attache = CHI
    declare_war_on = {
        target = CHI
        type = annex_everything
    }
}

Synergy

  • [has_attache](/wiki/trigger/has_attache): Check whether your country actually has an attaché in the target country before executing the recall, preventing invalid commands on non-existent attachés.
  • [has_attache_from](/wiki/trigger/has_attache_from): Verify the attaché deployment relationship from the target country's perspective, suitable for conditional checks within the target country's scope.
  • [declare_war_on](/wiki/effect/declare_war_on): War declarations typically sever attaché relationships automatically, but manually recalling in advance ensures correct sequencing of related event chains or flag triggers.
  • [add_opinion_modifier](/wiki/effect/add_opinion_modifier): Recalling an attaché usually accompanies a decrease in diplomatic relations. Pair this with the command to apply opinion penalties to both sides, making diplomatic logic more complete.

Common Pitfalls

  1. Forgetting to check if the attaché exists: Calling recall_attache directly without a preceding has_attache check will silently fail when the attaché doesn't exist, causing unexpected behavior in subsequent logic that depends on this state.
  2. Reversing the scope direction: This effect's logic is "the scope country recalls an attaché from the target country." Newcomers often swap scope and target, resulting in the other country executing the recall instead of your own country actively withdrawing the attaché.