Wiki

effect · remove_wargoal

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

removes war goal type targetting nation targetExample:
remove_wargoal = {
	type = take_state
	target = FRA
}

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

remove_wargoal is commonly used in diplomatic event chains to revoke war goals previously imposed via create_wargoal after successful negotiations or treaty agreements between nations, preventing continued warfare due to lingering objectives. For example, in a "peace negotiation" event option, after the player accepts the terms, the territorial claim war goal against the target nation is removed:

option = {
    name = peace_negotiation.opt_accept
    remove_wargoal = {
        type = take_state
        target = FRA
    }
    add_political_power = -50
}

Synergy

  • [create_wargoal](/wiki/effect/create_wargoal): The inverse operation of remove_wargoal, typically appearing as paired actions across different branches of the same event chain—one imposing a war goal while the other revokes it.
  • [declare_war_on](/wiki/effect/declare_war_on): After declaring war, if specific conditions are met (such as the opponent making concessions), the war goal must be removed first before resolving the conflict through other means, with both effects managing the war lifecycle.
  • [has_annex_war_goal](/wiki/trigger/has_annex_war_goal): Check with this trigger whether the war goal actually exists before executing remove_wargoal to prevent invalid calls or script errors.
  • [add_state_claim](/wiki/effect/add_state_claim): Sometimes after removing a war goal, a territorial claim is added as a replacement to achieve a "downgraded" form of diplomatic pressure.

Common Pitfalls

  1. type mismatch with the actual war goal type: If the war goal currently attached to the target nation does not match the specified type (for example, the actual type is puppet but take_state was written), the command fails silently and the war goal is not removed; the game typically provides no error message, so ensure the type matches what was used in create_wargoal.
  2. Calling when no war goal exists: Executing this command on a nation that currently has no war goal of that type will not crash the game but has no practical effect; beginners often mistakenly believe the command succeeded, so it is recommended to use a pre-check with triggers like [has_annex_war_goal](/wiki/trigger/has_annex_war_goal), or verify the state through logs.