effect · `break_embargo`

Definition

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

Description

breaks an existing embargo from ROOT to the specified tag. Note this will only work if used on the sending country

实战 · 配合 · 坑

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

实战用法

break_embargo 常用于外交事件或决策中，当双方关系改善或谈判达成协议后，自动解除本国对目标国施加的禁运。例如在一个"外交正常化"事件中，事件在发送国（ROOT）的 scope 下触发，让玩家可以通过选项主动撤销禁运以换取其他利益。

# 发生在发送国（ROOT）scope 内的事件选项
option = {
    name = diplomacy.embargo_lift.a
    break_embargo = FROM   # 解除对 FROM（接收国）的禁运
    add_opinion_modifier = {
        target = FROM
        modifier = lifted_embargo_opinion
    }
}

配合关系

[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — 解除禁运通常伴随双边关系改善，同步添加好感度修正使外交效果更完整。
[has_country_flag](/wiki/trigger/has_country_flag) — 用于在触发 break_embargo 之前检查是否确实存在由本国主动设置的禁运标记，避免在没有禁运的情况下无效调用。
[diplomatic_relation](/wiki/effect/diplomatic_relation) — 在解除禁运后可进一步用此命令重建贸易协议或市场准入等双边外交关系。
[country_event](/wiki/effect/country_event) — 向目标国发送通知事件，告知对方禁运已解除，形成完整的事件链叙事。

常见坑

scope 用错是最常见的错误：break_embargo 必须在「发送（施加）禁运的国家」scope 下执行，如果写在目标国或第三国 scope 里完全不会生效且不报错，新手容易将其误放在 FROM 的 scope 内调用。
在没有现存禁运时调用：若双方之间根本没有禁运，指令会静默失败；建议先用 [has_country_flag](/wiki/trigger/has_country_flag) 或相关条件检查确认禁运存在后再执行，以保证逻辑严谨。

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

break_embargo is commonly used in diplomatic events or decisions to automatically lift the player's embargo against a target nation when bilateral relations improve or a negotiation is concluded. For example, in a "Diplomatic Normalization" event triggered within the event sender's (ROOT) scope, players can actively revoke an embargo through an option in exchange for other benefits.

# Event option executed within the sender's (ROOT) scope
option = {
    name = diplomacy.embargo_lift.a
    break_embargo = FROM   # Lifts embargo against FROM (receiving nation)
    add_opinion_modifier = {
        target = FROM
        modifier = lifted_embargo_opinion
    }
}

Synergy

[add_opinion_modifier](/wiki/effect/add_opinion_modifier) — Lifting an embargo typically accompanies improved bilateral relations; adding opinion modifiers simultaneously ensures a more complete diplomatic outcome.
[has_country_flag](/wiki/trigger/has_country_flag) — Use this to verify that an embargo flag set by the player actually exists before triggering break_embargo, preventing ineffective calls when no embargo is in place.
[diplomatic_relation](/wiki/effect/diplomatic_relation) — After lifting an embargo, this command can be used to rebuild bilateral diplomatic relations such as trade agreements or market access.
[country_event](/wiki/effect/country_event) — Send a notification event to the target nation informing them that the embargo has been lifted, creating a complete narrative event chain.

Common Pitfalls

Incorrect scope is the most frequent mistake: break_embargo must execute within the scope of the nation that "imposed the embargo." If placed in the target nation's or a third party's scope, it will fail silently without error messages—beginners often mistakenly call it from the FROM scope.
Calling when no embargo exists: If no embargo actually exists between the two nations, the command will fail silently. It is recommended to first verify embargo existence using [has_country_flag](/wiki/trigger/has_country_flag) or related conditions before execution to ensure logical consistency.

effect · break_embargo