effect · `send_embargo`

Definition

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

Description

embargos specified tag

实战 · 配合 · 坑

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

实战用法

send_embargo 常用于外交博弈类 mod，例如当某国触发贸易摩擦事件或意识形态对立加剧时，自动向目标国发起禁运制裁。它也适合用在决策或国策完成后，模拟历史上的经济封锁行为（如战前对轴心国或同盟国的资源断供）。

# 在某个国策或决策的 complete_effect 中
effect = {
    GER = {               # 切换到德国 scope
        send_embargo = {
            target = USA  # 向美国发送禁运
        }
    }
}

配合关系

[break_embargo](/wiki/effect/break_embargo) — 与 send_embargo 构成一对，适合在外交关系改善事件中解除之前施加的禁运，形成完整的制裁-解除循环。
[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — 禁运通常伴随外交关系恶化，同步添加负面观感修正器可使外交后果更真实。
[create_wargoal](/wiki/effect/create_wargoal) — 经济封锁升级为军事冲突的剧本中，禁运可作为宣战借口的前置步骤，配合宣战目标使逻辑链更完整。
[has_country_flag](/wiki/trigger/has_country_flag) — 用标记记录「已发送禁运」状态，防止同一对国家重复触发禁运逻辑，保持脚本幂等性。

常见坑

scope 混淆：send_embargo 必须在发起禁运方（施压国）的 country scope 内执行，target 填被制裁国，新手容易反过来在被制裁国 scope 下写，导致禁运方向完全相反。
target 写法错误：target 字段须填具体国家 TAG（如 USA、GER），不能直接裸写国家名称字符串，否则解析失败且不会有任何报错提示，禁运静默无效。

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

send_embargo is commonly used in diplomatic gameplay mods, such as automatically initiating trade sanctions against a target nation when certain countries trigger trade friction events or ideological tensions escalate. It is also suitable for use after completing decisions or focuses to simulate historical economic blockades (such as pre-war resource cutoffs against the Axis or Allied powers).

# In the complete_effect of a focus or decision
effect = {
    GER = {               # Switch to Germany scope
        send_embargo = {
            target = USA  # Send embargo to USA
        }
    }
}

Synergy

[break_embargo](/wiki/effect/break_embargo) — Forms a pair with send_embargo, ideal for lifting previously imposed embargoes in diplomatic improvement events, creating a complete sanctions-removal cycle.
[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — Embargoes typically accompany deteriorating diplomatic relations; applying negative opinion modifiers in parallel makes diplomatic consequences more realistic.
[create_wargoal](/wiki/effect/create_wargoal) — In scenarios where economic blockades escalate into military conflict, embargoes can serve as a prerequisite step for war justifications, complementing wargoals to create a more complete logical chain.
[has_country_flag](/wiki/trigger/has_country_flag) — Use flags to track "embargo sent" status, preventing duplicate embargo logic triggers between the same pair of nations and maintaining script idempotency.

Common Pitfalls

Scope confusion: send_embargo must be executed within the country scope of the embargo initiator (sanctioning nation); the target field should contain the sanctioned nation. Beginners often mistakenly write it in the sanctioned nation's scope, causing the embargo direction to be completely reversed.
Incorrect target syntax: The target field must contain a concrete country TAG (such as USA, GER); it cannot be a bare country name string, otherwise parsing fails silently with no error message, leaving the embargo ineffective and undetected.

effect · send_embargo