effect · `recall_volunteers_from`

Definition

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

Description

The scoped in country recall the volunteers sent to the target country.
Example:
# FRA recalls the volunteers it sent to SPR
FRA = { recall_volunteers_from = SPR }

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

常见于外交事件或剧本焦点中，当两国关系破裂、志愿者派遣协议终止或国家被迫结束干涉时使用。例如在西班牙内战剧情中，若玩家选择停止支持某一方，可触发此效果将志愿者撤回：

# 当法国与西班牙共和军关系恶化时，撤回志愿者
country_event = {
    id = spain_civil_war.42
    option = {
        name = "撤回我们的支持"
        FRA = {
            recall_volunteers_from = SPR
        }
        add_political_power = -20
    }
}

配合关系

[has_attache_from](/wiki/trigger/has_attache_from) — 在撤回志愿者前先检测目标国是否确实有本国武官/志愿者存在，避免无效触发导致日志报错或逻辑混乱。
[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — 撤回志愿者通常伴随外交关系变化，配合此命令同步修改双方的外交观感以体现政治后果。
[country_event](/wiki/effect/country_event) — 向接收志愿者的目标国发送通知事件，使对方玩家或AI能感知并响应志愿者撤回这一外交动作。
[diplomatic_relation](/wiki/effect/diplomatic_relation) — 若撤回是因断交或敌对引起，可同步移除军事通道、保证等外交关系状态，保持逻辑一致。

常见坑

scope 指向错误：此命令必须在发出志愿者的国家 scope 下执行，而非志愿者所在的目标国。新手常将 scope 写成 SPR = { recall_volunteers_from = FRA }，导致效果反向或完全无效，正确写法应是派遣方（如 FRA）作为外层 scope。
未检查志愿者是否存在：若当前实际上并没有志愿者被派遣到目标国，直接执行此命令不会报致命错误，但可能产生意料外的游戏状态或触发无意义的 AI 响应；建议在执行前配合 [has_attache_from](/wiki/trigger/has_attache_from) 等条件进行前置判断。

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

Commonly found in diplomatic events or scripted focuses, used when relations between two nations deteriorate, volunteer agreements are terminated, or a country is forced to end intervention. For example, in the Spanish Civil War storyline, if the player chooses to stop supporting one side, this effect can be triggered to recall volunteers:

# Recall volunteers when France's relations with Spanish Republic deteriorate
country_event = {
    id = spain_civil_war.42
    option = {
        name = "Withdraw our support"
        FRA = {
            recall_volunteers_from = SPR
        }
        add_political_power = -20
    }
}

Synergy

[has_attache_from](/wiki/trigger/has_attache_from) — Check whether the target nation actually has attachés/volunteers from your country before recalling, preventing invalid triggers that cause log errors or logic conflicts.
[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — Recalling volunteers typically involves diplomatic changes; pair this command with opinion modifier adjustments to reflect the political consequences for both sides.
[country_event](/wiki/effect/country_event) — Send a notification event to the nation receiving the volunteers, allowing the player or AI to perceive and respond to the volunteer recall as a diplomatic action.
[diplomatic_relation](/wiki/effect/diplomatic_relation) — If the recall is due to broken relations or hostility, simultaneously remove military access, guarantees, and other diplomatic relationship states to maintain logical consistency.

Common Pitfalls

Incorrect scope targeting: This command must be executed under the scope of the nation sending the volunteers, not the target nation where they are located. Beginners often write the scope as SPR = { recall_volunteers_from = FRA }, resulting in reversed or completely ineffective effects. The correct syntax should have the sending nation (e.g., FRA) as the outer scope.
Failing to check if volunteers exist: If there are actually no volunteers deployed to the target nation, executing this command will not cause a fatal error but may produce unexpected game states or trigger meaningless AI responses. It is recommended to use conditional checks like [has_attache_from](/wiki/trigger/has_attache_from) before execution to validate the preconditions.

effect · recall_volunteers_from