Wiki

trigger · seller

Definition

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

Description

Check the seller country. Example: seller = GER

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

seller is commonly used in events or decisions related to purchase contracts, filtering for specific nations acting as sellers before triggering subsequent logic. For example, it can restrict certain countries from selling equipment to opposing factions. In mods, you can use it to implement diplomatic restrictions like "allow contract cancellation only when Germany is the seller."

# Under PURCHASE_CONTRACT scope, check if the seller is Germany
cancel_purchase_contract = {
    limit = {
        seller = GER
        buyer = SOV
    }
}

Synergy

  • [buyer](/wiki/trigger/buyer): Works in tandem with seller to simultaneously lock both buyer and seller identities, forming a complete bilateral contract filtering condition.
  • [contract_contains_equipment](/wiki/trigger/contract_contains_equipment): After confirming the seller, further check the equipment types in the contract for finer-grained contract filtering.
  • [cancel_purchase_contract](/wiki/effect/cancel_purchase_contract): Once the seller condition is satisfied, use this effect to execute the actual contract cancellation operation, the most direct follow-up action.
  • [deal_completion](/wiki/trigger/deal_completion): Used together with seller to determine whether a specific seller's contract has been completed, suitable for transaction history tracking.

Common Pitfalls

  1. Wrong scope: seller must be used within the PURCHASE_CONTRACT scope. If written directly in a nation scope (such as within a nation's trigger block), it will error or always return false. Beginners often forget to switch to the correct contract scope first.
  2. Target confusion: The value provided should be a nation tag (such as GER) or a valid scope keyword (such as ROOT, FROM). If mistakenly filled with a province ID or other non-nation type target, the condition will fail to match correctly.