Struct StackEntry 

pub struct StackEntry {
    pub id: u32,
    pub spell_ability: SpellAbility,
    pub is_pending_cast: bool,
    pub is_creature_spell: bool,
    pub is_permanent_spell: bool,
    pub cast_from_zone: Option<ZoneType>,
    pub optional_trigger_decider: Option<PlayerId>,
    pub optional_trigger_description: Option<String>,
    pub optional_trigger_source_name: Option<String>,
}

An entry on the game stack (spell or ability waiting to resolve). Mirrors Java’s SpellAbilityStackInstance which wraps a SpellAbility.

Fields

id: u32

spell_ability: SpellAbility

The spell ability with its full sub-ability chain and targets.

is_pending_cast: bool

True while a spell has been announced and moved to the stack, but its modes/targets/costs/payment have not finished yet. Pending entries are visible for casting prompts but must never resolve or receive priority.

is_creature_spell: bool

Whether this is a creature spell (goes to battlefield on resolve).

is_permanent_spell: bool

Whether this is a non-creature permanent spell.

cast_from_zone: Option<ZoneType>

The zone the spell was cast from (for Flashback exile-on-resolve).

optional_trigger_decider: Option<PlayerId>

If this is an optional trigger, the player who decides whether to accept or decline. Mirrors Java’s WrappedAbility decider field.

optional_trigger_description: Option<String>

Description text shown to the deciding player for optional triggers.

optional_trigger_source_name: Option<String>

Source card name for optional trigger prompts.

Implementations

impl StackEntry

Extension methods on StackEntry mirroring Java’s SpellAbilityStackInstance. These are implemented directly on StackEntry so callers can use them without needing a separate wrapper.

pub fn get_spell_ability(&self) -> &SpellAbility

Get the underlying spell ability. Mirrors Java’s SpellAbilityStackInstance.getSpellAbility().

pub fn get_source_card(&self) -> Option<CardId>

Get the source card of this stack instance. Mirrors Java’s SpellAbilityStackInstance.getSourceCard().

pub fn is_spell_instance(&self) -> bool

Whether this stack instance is a spell. Mirrors Java’s SpellAbilityStackInstance.isSpell().

pub fn is_ability_instance(&self) -> bool

Whether this stack instance is an activated ability. Mirrors Java’s SpellAbilityStackInstance.isAbility().

pub fn is_trigger_instance(&self) -> bool

Whether this stack instance is a triggered ability. Mirrors Java’s SpellAbilityStackInstance.isTrigger().

pub fn is_optional_trigger(&self) -> bool

Whether this is an optional trigger (player may decline). Mirrors Java’s SpellAbilityStackInstance.isOptionalTrigger().

pub fn get_stack_description(&self) -> String

Get the stack description for display. Mirrors Java’s SpellAbilityStackInstance.getStackDescription().

pub fn get_activating_player(&self) -> PlayerId

Get the player who activated/cast this spell or ability. Mirrors Java’s SpellAbilityStackInstance.getActivatingPlayer().

pub fn get_target_choices(&self) -> &TargetChoices

Get the target choices for the underlying spell ability. Mirrors Java’s SpellAbilityStackInstance.getTargetChoices().

impl StackEntry

pub fn next_id() -> u64

Get the next unique ID for a stack entry. Mirrors Java’s SpellAbilityStackInstance.nextId().

pub fn update_target(&mut self, old: CardId, new: CardId)

Update a target card in this stack entry’s spell ability. Mirrors Java’s SpellAbilityStackInstance.updateTarget(Card, Card).

pub fn set_triggering_object<K: TriggerKeyInput>(&mut self, key: K, value: &str)

Set a triggering object on this stack entry’s spell ability. Mirrors Java’s SpellAbilityStackInstance.setTriggeringObject(String, Object).

pub fn update_triggering_object<K: TriggerKeyInput>( &mut self, key: K, value: &str, )

Update a triggering object in this stack entry’s spell ability. Mirrors Java’s SpellAbilityStackInstance.updateTriggeringObject(String, Object).

Trait Implementations

impl Clone for StackEntry

fn clone(&self) -> StackEntry

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for StackEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for StackEntry

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for StackEntry

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

where __S: Serializer,

Serialize this value into the given Serde serializer.