Struct CardFilter 

pub struct CardFilter {

    pub creatures_only: bool,
    pub controller_only: bool,
    pub owner_only: bool,
    pub other_only: bool,
    pub commander_only: bool,
    pub subtype: Option<String>,
    pub nonland_only: bool,
    pub land_only: bool,
    pub required_color: Option<ColorSet>,
    pub colorless_only: bool,
    pub attacking_you: bool,
    pub card_name: Option<String>,
    pub token_only: bool,
    pub shares_color_with_source: bool,
    pub shares_color_with_equipped: bool,
    pub shares_creature_type_with_source: bool,
    pub shares_creature_type_with_equipped: bool,
}

Filter for which permanents are affected by a static ability.

Parsed from the Affected$ or ValidCards$ parameter, which mirrors the Card.isValid() logic in Java Forge’s StaticAbilityContinuous.

Format: BaseType[.Qualifier][+Qualifier...]

Examples:

• "Creature.YouControl" — creatures you control
• "Creature.White+YouCtrl" — white creatures you control (Honor of the Pure)
• "Creature.Other+YouControl" — creatures you control other than this card
• "Creature.Goblin+YouControl" — Goblins you control
• "Permanent.YouControl" — all permanents you control

Fields

creatures_only: bool

Only match cards with the Creature core type.

controller_only: bool

Only match cards controlled by the ability source’s controller.

owner_only: bool

Only match cards owned by the ability source’s controller (YouOwn).

other_only: bool

Exclude the source card itself (Other qualifier).

commander_only: bool

Only match commanders.

subtype: Option<String>

Only match cards with this subtype (e.g. "Goblin", "Warrior").

nonland_only: bool

Only match non-land permanents.

land_only: bool

Only match land permanents.

required_color: Option<ColorSet>

Only match cards that include this color (e.g. White for Honor of the Pure). None means no color restriction.

colorless_only: bool

Only match colorless cards (Colorless qualifier).

attacking_you: bool

Only match creatures currently attacking the source’s controller (attackingYou qualifier, e.g. Watchdog).

card_name: Option<String>

Only match cards with this exact name (named<CardName> qualifier).

token_only: bool

Only match token permanents.

shares_color_with_source: bool

Only match cards that share a color with the source card.

shares_color_with_equipped: bool

Only match cards that share a color with the source’s equipped creature.

shares_creature_type_with_source: bool

Only match cards that share a creature type with the source card.

shares_creature_type_with_equipped: bool

Only match cards that share a creature type with the source’s equipped creature.

Implementations

impl CardFilter

pub fn parse(s: &str) -> Self

Parse an Affected$ / ValidCards$ value string into a CardFilter.

pub fn matches(&self, card: &Card, source: &Card) -> bool

Returns true if card passes this filter given source is the static ability’s host card.

pub fn matches_with_game( &self, card: &Card, source: &Card, game: &GameState, ) -> bool

Context-aware matching for predicates that require game lookups (e.g. SharesColorWith Equipped).

Trait Implementations

impl Clone for CardFilter

fn clone(&self) -> CardFilter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CardFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CardFilter

fn default() -> CardFilter

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CardFilter

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CardFilter

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.