Wiki

effect · remove_resource_rights

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Remove resource right to state for scope country. remove_resource_rights = ID

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_resource_rights is commonly used in diplomatic events or decisions to automatically revoke resource extraction rights over a state when resource-sharing agreements expire, relations break down, or a nation is annexed. For example, in an "End Resource Agreement" event effect block:

# In the option of a country_event, scope is the nation holding resource rights
option = {
    name = resource_agreement.1.a
    remove_resource_rights = 42   # 42 is the target state ID
    add_political_power = -20
}

Synergy

  • [has_country_flag](/wiki/trigger/has_country_flag): Check whether a flag exists first to confirm the resource agreement was previously granted, then trigger removal to avoid accidental operations.
  • [add_resource](/wiki/effect/add_resource): After removing resource rights, you may need to redistribute resources back to the state of the original owner nation; these two often appear in pairs within diplomatic logic.
  • [add_opinion_modifier](/wiki/effect/add_opinion_modifier): Revoking resource rights typically accompanies diplomatic relationship changes; use this command to simultaneously apply negative opinion modifiers to reflect real-world consequences.
  • [country_event](/wiki/effect/country_event): After removal, trigger an event to notify the other nation, creating a complete bilateral diplomatic chain response.

Common Pitfalls

  1. Writing state names instead of state IDs: This command only accepts numeric state IDs; using "42" as a string or state name tags will cause errors. Always consult map/definition.csv or check state numbering in-game to confirm.
  2. Calling under the wrong scope: Must be executed under the scope of the nation holding resource rights. If mistakenly written under the scope of the sovereign nation of the state containing the resource, it will have no effect and produce no obvious error message, making it extremely easy to overlook.