effect · `set_border_war`

Definition

Supported scope:STATE
Supported target:none

Description

starts a border war in a state with neighbouring state that also has border war

实战 · 配合 · 坑

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

实战用法

set_border_war 常用于自定义事件或决策中，在两国接壤省份人为触发边境冲突，模拟局势升温、代理人战争或领土争端等场景。使用时需确保目标 STATE 与相邻州也已设置边境战争标记，两侧缺一不可，否则效果不会生效。

# 在某个决策的 complete_effect 中对争议州触发边境战争
541 = {  # 目标州 scope
    set_border_war = yes
}

配合关系

[has_border_war](/wiki/trigger/has_border_war) — 在执行前检查该州是否已存在边境战争，避免重复触发或产生冲突。
[has_border_war_with](/wiki/trigger/has_border_war_with) — 精确判断是否已与特定相邻州处于边境战争状态，用于条件分支控制。
[any_neighbor_state](/wiki/trigger/any_neighbor_state) — 遍历检查相邻州是否满足条件（如同样设置了边境战争），确保双边条件成立。
[set_state_controller_to](/wiki/effect/set_state_controller_to) — 边境战争结束后常用于直接变更州控制权，作为战争结果的后续处理。

常见坑

忘记双边设置：set_border_war 必须在冲突双方的两个相邻州上都执行，只在一侧设置不会产生有效的边境战争，这是最常见的失效原因。
Scope 混用错误：该 effect 必须在 STATE scope 下调用，若误将其写在 COUNTRY scope 的执行块中会导致脚本报错或静默失效，新手调试时应优先确认当前 scope 类型。

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

set_border_war is commonly used in custom events or decisions to artificially trigger border conflicts in bordering provinces between two nations, simulating scenarios of escalating tensions, proxy wars, or territorial disputes. When using this command, you must ensure that both the target STATE and its adjacent states have the border war marker set; both sides are required, otherwise the effect will not take effect.

# Trigger border war on a disputed state within a decision's complete_effect
541 = {  # target state scope
    set_border_war = yes
}

Synergy

[has_border_war](/wiki/trigger/has_border_war) — Check before execution whether the state already has an active border war to avoid duplicate triggers or conflicts.
[has_border_war_with](/wiki/trigger/has_border_war_with) — Precisely determine whether a border war is already active with a specific adjacent state, useful for conditional branching logic.
[any_neighbor_state](/wiki/trigger/any_neighbor_state) — Iterate through adjacent states to check if conditions are met (such as also having border war set), ensuring bilateral conditions are satisfied.
[set_state_controller_to](/wiki/effect/set_state_controller_to) — Commonly used after a border war concludes to directly change state control, serving as post-war resolution handling.

Common Pitfalls

Forgetting bilateral setup: set_border_war must be executed on both adjacent states of the conflicting parties. Setting it on only one side will not produce a valid border war, and this is the most common cause of failure.
Scope mixing errors: This effect must be called within a STATE scope. If mistakenly placed in a COUNTRY scope execution block, it will cause script errors or silent failure. New players should prioritize confirming the current scope type during debugging.

effect · set_border_war