effect · `remove_civil_war_target`

Definition

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

Description

Removes a country as a civil war target (removed from both sides)

Example:
remove_civil_war_target = TAG

实战 · 配合 · 坑

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

实战用法

在内战相关 mod 中，当你希望通过事件或决策手动终止某国作为内战交战方的身份时使用此 effect——例如设计"和谈协议"决策，让分裂出去的内战派系从双方的目标列表中被清除，避免内战逻辑持续触发。

# 内战和谈决策效果块示例
option = {
    name = civil_war_peace.opt_a
    # 将 REBelion 从双方内战目标中移除
    remove_civil_war_target = REB
    add_political_power = -50
}

配合关系

[add_civil_war_target](/wiki/effect/add_civil_war_target)：两者是一对逆操作，通常在内战开始时用 add_civil_war_target 登记目标，结束或和解时用 remove_civil_war_target 注销，成对出现可精确控制内战双方名单。
[civilwar_target](/wiki/trigger/civilwar_target)：在执行移除前先用此触发器检查某TAG是否确实是当前内战目标，可防止对不存在的目标执行移除时产生错误逻辑分支。
[has_civil_war](/wiki/trigger/has_civil_war)：作为前置条件检查，只有当国家确实处于内战状态时才执行移除操作，避免在非内战情境下空运行。
[annex_country](/wiki/effect/annex_country)：和谈/镇压情景中，移除内战目标后往往紧跟吞并或整合叛乱方，两者常在同一 option 块中连用。

常见坑

作用域指向错误：此 effect 需在合法的 COUNTRY scope 下执行，许多新手在 state scope 的事件选项里直接调用会导致命令无效甚至报错，应先用 ROOT / THIS 等确认当前 scope 是国家。
TAG填写为双方均可但效果只对"已登记"的目标有效：如果该 TAG 从未通过 add_civil_war_target 被登记为内战目标，执行此命令不会报错但也毫无效果，容易误以为内战状态已被清除而遗留后续逻辑 bug。

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

In civil war-related mods, use this effect when you want to manually terminate a country's status as a civil war belligerent through events or decisions—for example, designing a "peace agreement" decision that removes a split-off civil war faction from both sides' target lists, preventing the civil war logic from continuing to trigger.

# Example civil war peace agreement decision effect block
option = {
    name = civil_war_peace.opt_a
    # Remove REBelion from both sides' civil war targets
    remove_civil_war_target = REB
    add_political_power = -50
}

Synergy

[add_civil_war_target](/wiki/effect/add_civil_war_target): These two are inverse operations of each other. Typically use add_civil_war_target to register targets when civil war begins and remove_civil_war_target to unregister when it ends or is resolved. Using them as paired operations allows precise control over the civil war belligerent roster.
[civilwar_target](/wiki/trigger/civilwar_target): Before executing the removal, use this trigger to check whether a specific TAG is actually a current civil war target. This prevents erroneous logic branches from attempting to remove non-existent targets.
[has_civil_war](/wiki/trigger/has_civil_war): Use as a prerequisite condition to execute the removal only when the country is actually in a state of civil war, avoiding idle execution in non-civil war scenarios.
[annex_country](/wiki/effect/annex_country): In peace agreement or suppression scenarios, it is common to follow removal of civil war targets with annexation or integration of the rebellious faction. The two are frequently used together in the same option block.

Common Pitfalls

Incorrect scope targeting: This effect must be executed under a legal COUNTRY scope. Many newcomers call it directly in event options at state scope, which causes the command to be ineffective or even produce errors. You should first confirm the current scope is national using ROOT / THIS or similar.
TAG input works for both sides but only affects "registered" targets: If the TAG was never registered as a civil war target through add_civil_war_target, executing this command will not error but will have no effect. This easily leads to the mistaken belief that the civil war status has been cleared while leaving downstream logic bugs unresolved.

effect · remove_civil_war_target