Struct TriggerHandler 

pub struct TriggerHandler { /* private fields */ }

Mirrors Java’s TriggerHandler — central trigger dispatcher. In Java, lives on Game. In Rust, lives on GameLoop because active_triggers and waiting_triggers are transient processing state.

Implementations

impl TriggerHandler

pub fn new() -> Self

pub fn run_trigger(&mut self, mode: TriggerType, params: RunParams, hold: bool)

Mirrors Java’s runTrigger() — main entry point. Called from game actions when events occur. If hold is true, event is queued; otherwise it’s also queued (all triggers go through the waiting queue for APNAP ordering).

pub fn run_trigger_with_game( &mut self, game: &GameState, mode: TriggerType, params: RunParams, hold: bool, ) -> Vec<PendingTrigger>

Java-parity entrypoint that can resolve triggers immediately when the event should not be held/frozen.

pub fn parse_trigger(&mut self, raw: &str) -> Option<Trigger>

Java parity wrapper for TriggerHandler.parseTrigger(String).

pub fn collect_trigger_for_waiting( &mut self, mode: TriggerType, params: RunParams, )

Java parity wrapper for TriggerHandler.collectTriggerForWaiting(…).

pub fn waiting_trigger_count(&self) -> usize

Number of triggers in the waiting queue (for debug/diagnostics).

pub fn pre_matched_trigger_count(&self) -> usize

pub fn has_number_drawn_triggers(&self, game: &GameState) -> bool

Match waiting triggers NOW, while source cards are still in their current zones. Stores results in pre_matched_triggers so that a subsequent run_waiting_triggers call returns them even if SBA has since moved the source card (e.g. Raptor Hatchling dying to combat damage before triggers go on the stack).

Call this immediately after firing triggers and before SBA. Returns true if any active trigger is a Drawn trigger with Number$ set. Used to gate flush_waiting_triggers during draws to avoid disrupting other trigger matching when no Number$-gated Drawn triggers exist.

pub fn flush_waiting_triggers(&mut self, game: &GameState)

pub fn run_waiting_triggers(&mut self, game: &GameState) -> Vec<PendingTrigger>

Mirrors Java’s runWaitingTriggers(). Drains waiting queue, matches triggers, returns PendingTriggers. The caller (game_loop) handles OptionalDecider$ prompting.

pub fn process_waiting_triggers( &mut self, mana_pools: &[ManaPool], game: &mut GameState, agents: &mut [Box<dyn PlayerAgent>], ) -> Vec<TriggerPushLog>

pub fn process_pending_triggers( &mut self, mana_pools: &[ManaPool], game: &mut GameState, agents: &mut [Box<dyn PlayerAgent>], pending: Vec<PendingTrigger>, ) -> Vec<TriggerPushLog>

pub fn register_delayed_trigger(&mut self, delayed: DelayedTrigger)

Register a delayed trigger (one-shot, fires once then is removed). Mirrors Java’s TriggerHandler.registerDelayedTrigger().

pub fn clear_delayed_trigger(&mut self)

pub fn register_this_turn_delayed_trigger(&mut self, delayed: DelayedTrigger)

pub fn clear_this_turn_delayed_trigger(&mut self)

pub fn register_player_defined_delayed_trigger( &mut self, player: PlayerId, delayed: DelayedTrigger, )

pub fn clear_player_defined_delayed_trigger(&mut self)

pub fn handle_player_defined_del_triggers(&mut self, player: PlayerId)

pub fn reset_active_triggers(&mut self, game: &GameState)

Mirrors Java’s resetActiveTriggers(). Scans all cards in game, collects active triggers.

pub fn register_active_trigger(&mut self, game: &GameState, card_id: CardId)

Mirrors Java’s registerActiveTrigger(card). Registers a single card’s triggers.

pub fn clear_active_triggers(&mut self)

Java parity wrapper for TriggerHandler.clearActiveTriggers().

pub fn register_active_ltb_trigger(&mut self, game: &GameState, card_id: CardId)

Java parity wrapper for TriggerHandler.registerActiveLTBTrigger(card). Registers all of a card’s triggers as active, using current trigger indices.

pub fn register_one_trigger( &mut self, game: &GameState, card_id: CardId, trigger_index: usize, )

Java parity wrapper for TriggerHandler.registerOneTrigger(…).

pub fn unregister_active_triggers(&mut self, card_id: CardId)

Remove triggers for a card that left a trigger zone.

pub fn clear_waiting_triggers(&mut self)

pub fn on_player_lost(&mut self, player: PlayerId)

pub fn suppress_mode(&mut self, mode: TriggerType)

pub fn set_suppress_all_triggers(&mut self, suppress: bool)

pub fn get_active_trigger( &self, game: &GameState, mode: TriggerType, params: &RunParams, ) -> Vec<Trigger>

Mirrors Java’s TriggerHandler.getActiveTrigger(TriggerType, Map<AbilityKey, Object>). Returns all active triggers that can run for the given mode and params.

pub fn is_trigger_suppressed(&self, mode: TriggerType) -> bool

pub fn clear_suppression(&mut self, mode: TriggerType)

Trait Implementations

impl Clone for TriggerHandler

fn clone(&self) -> TriggerHandler

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TriggerHandler

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

Formats the value using the given formatter.

impl Default for TriggerHandler

fn default() -> Self

Returns the “default value” for a type.