Wiki

trigger · pc_is_state_claimed_by

Definition

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

Description

Check if state is claimed in conference by TAG
Example:
pc_is_state_claimed_by = SOV/ROOT/ROOT.FROM

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

pc_is_state_claimed_by is primarily used in peace conference-related mod scenarios, such as determining whether a state has already been claimed by a specific nation at the negotiation table, thereby triggering additional events or restricting the availability of certain decisions. It is commonly found in custom peace conference logic, post-war territorial allocation event chains, and dynamically blocking decisions in the available block that would conflict with already-claimed territories.

# In the available block of a decision, check if the target state was claimed by the Soviet Union in the conference
available = {
    ROOT = {
        pc_is_state_claimed_by = SOV
    }
}

Synergy

  • [pc_is_state_claimed](/wiki/trigger/pc_is_state_claimed) — Use this first to confirm whether the state has been claimed by any nation in the conference, then use pc_is_state_claimed_by for precise identification of the claimant. This two-step filtering logic is clearer.
  • [pc_is_state_claimed_and_taken_by](/wiki/trigger/pc_is_state_claimed_and_taken_by) — Forms a progressive relationship with this trigger: the former only checks "claimed," while the latter checks both "claimed and actually obtained." These are commonly placed side-by-side in different option trigger conditions within the same event.
  • [is_owned_by](/wiki/trigger/is_owned_by) — Use together to distinguish between "claimed at the negotiation table" and "actual sovereignty ownership," avoiding mistaking diplomatic table claims for real control.
  • [add_claim_by](/wiki/effect/add_claim_by) — When the above triggers return false (the target state has not yet been claimed), use the effect block to add claims for the specific nation, forming a complete "check → supplement" logical loop.

Common Pitfalls

  1. Incorrect Scope Usage: This trigger must be called within a STATE scope. If written directly at the root level of a country-scoped event without first switching to a state scope (such as wrapping with ROOT = { ... }), it will cause the trigger to fail silently or throw an error, making it difficult to pinpoint the issue from logs.
  2. Confusion Between target and TAG: The value can be filled with a concrete country TAG (such as SOV) or supported scope keywords (such as ROOT), but cannot accept variables or dynamic TAG strings. Beginners often attempt to pass dynamic nations using var:some_tag, which is an invalid syntax for this trigger.