Card selectors - Gravecorp/OCTGN GitHub Wiki

Current Card

When executing a card action (as opposed to a group action), the tag refers to the card, whose action is being executed.

All in group

The tag selects all cards in the specified group. Attributes:

  • group (The identifier of the group.)

Top N cards of a pile

The tag selects the top n cards in the specified pile. Attributes:

  • pile (The identifier of the pile.)
  • count (The number of cards to select. Defaults to 1 if not specified.)

Bottom N cards of a pile

The tag selects the bottom n cards in the specified pile. Attributes:

  • pile (The identifier of the pile.)
  • count (The number of cards to select. Defaults to 1 if not specified.)

Nth Card of group

The tag selects the Nth card of a group (1 = top of piles). Attributes:

  • group (The identifier of the group.)
  • position (The position of the card, starting with 1 = top.)

Random cards in a group

The tag selects cards randomly in a group. Attributes:

  • group (The identifier of the group.)
  • count (The number of cards to select. Defaults to 1 if not specified.)

Controlled by

The tag selects all cards from a collection of cards that are controlled by the specified player. This tag must contain one card selector child. Attributes:

  • by (The player. Currently there is no known way to reference a specific opponent so the only known value is 'me'.)

Example:

      <controlled by="me">
          <all group="table" />
      </controlled>

Owned by

The tag selects all cards from a collection of cards that are owned by the specified player. This tag must contain one card selector child. Attributes: by (The player. Currently there is no known way to reference a specific opponent so the only known value is 'me'.)

Example:

      <owned by="me">
          <all group="table" />
      </owned>

Property

The tag selects all card from a collection of cards where the specified property matches the specified value. This tag must contain one card selector child. Attributes:

  • name (The name of the card property to compare.)
  • value (The value to compare the card property with.)
  • negate (If set to true the cards not matching the above condition will be selected. If set to false (which is default if not specified) the cards that do match the condition will be selected.)

Example:

      <property name="Type" value="Creature">
          <all group="table" />
      </property>

Orientation

The tag selects only cards with a specific orientation from a collection of cards. This tag must contain one card selector child tag. Attributes:

  • rot (The orientation to be tested. May be 0, 90, 180 or 270.)
  • exact (When true the card has to be exactly at the given orientation. When false, the 180 and 90 components are tested separately, so a card oriented 270 (= 180 + 90) would match a rot="90" test. False is the default if not specified. Note that using rot="0" with exact="false" never matches.)
  • negate (Optional, defaults to false. When true, the filter works the opposite way: only cards, which don't match the orientation are kept.)

Face up or down

The and tags selects only the face up (resp. down) cards from a collection of card. This tag must contain one card selector child tag.

Example:

     <facedown>
         <all group="table" />
     </facedown>

Highlighted cards

The tag selects only cards which are highlighted (or not!). This tag must contain one card selector child tag. Attributes:

  • color (The specific highlight color to test. Defaults to any, which matches all highlighted cards, regardless of color. The special value none is recognized as well, it matches all cards, which are not highlighted.)
⚠️ **GitHub.com Fallback** ⚠️