Struct PlayerZone 

pub struct PlayerZone {
    pub zone: Zone,
    pub player: PlayerId,
}

A zone owned by a specific player. Mirrors Java’s PlayerZone which extends Zone.

In Rust, we use composition rather than inheritance: PlayerZone wraps a Zone and adds player-specific behavior.

Note: The engine’s GameState stores zones as HashMap<ZoneKey, Zone>. PlayerZone provides the ported Java API for zone-level card filtering; callers that need card-state filtering (keywords, may-play) should use GameState methods which have access to CardInstance data.

Fields

zone: Zone

player: PlayerId

Implementations

impl PlayerZone

pub fn new(zone_type: ZoneType, player: PlayerId) -> Self

pub fn get_player(&self) -> PlayerId

pub fn test(&self, card: CardId) -> bool

Test whether a card in this zone passes a containment check. Mirrors Java’s inner OwnCardsActivationFilter.test().

pub fn get_cards_player_can_activate(&self, who: PlayerId) -> Vec<CardId>

Get cards the given player can potentially activate from this zone. Mirrors Java’s PlayerZone.getCardsPlayerCanActivate().

This performs zone-level filtering:

• Battlefield/Hand: owner sees all their cards
• Library: only the top card is visible
• Other zones: all cards returned (card-level keyword filtering like Flashback/Retrace requires GameState access)

Methods from Deref<Target = Zone>

pub fn add(&mut self, card: CardId)

pub fn add_to_top(&mut self, card: CardId)

pub fn add_to_bottom(&mut self, card: CardId)

pub fn remove(&mut self, card: CardId) -> bool

pub fn remove_all_cards(&mut self)

Remove all cards from the zone. Mirrors Java’s Zone.removeAllCards().

pub fn reorder(&mut self, card: CardId, index: usize)

Reorder a card to a specific index. Mirrors Java’s Zone.reorder().

pub fn contains(&self, card: CardId) -> bool

pub fn is(&self, zone_type: ZoneType) -> bool

Check if this zone is the given type. Mirrors Java’s Zone.is().

pub fn size(&self) -> usize

Number of cards in the zone. Mirrors Java’s Zone.size().

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn get(&self, index: usize) -> Option<CardId>

Get the card at the given index. Mirrors Java’s Zone.get().

pub fn take_top(&mut self) -> Option<CardId>

Take the top card (last element = top of library).

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

Peek at the top card without removing it.

pub fn reset_cards_added_this_turn(&mut self)

Reset turn tracking: move this-turn data to last-turn. Mirrors Java’s Zone.resetCardsAddedThisTurn().

pub fn iterator(&self) -> impl Iterator<Item = &CardId>

Provides an iterator over the cards in this zone. Mirrors Java’s Zone.iterator().

pub fn shuffle(&mut self, rng: &mut dyn GameRng)

Shuffle the cards in this zone using the provided RNG. Mirrors Java’s Zone.shuffle().

All game randomness must flow through the game’s RNG for deterministic replay and parity testing.

pub fn add_to_melded(&mut self, card: CardId)

Add a card to the melded cards list. Mirrors Java’s PlayerZoneBattlefield.addToMelded().

pub fn remove_from_melded(&mut self, card: CardId)

Remove a card from the melded cards list. Mirrors Java’s PlayerZoneBattlefield.removeFromMelded().

pub fn get_cards(&self, _filter: bool) -> &[CardId]

Get the cards in this zone. The _filter parameter is ignored for non-battlefield zones (they always return the full list). Battlefield filtering is handled by PlayerZoneBattlefield::get_cards(). Mirrors Java’s Zone.getCards(boolean).

pub fn get_cards_added_this_turn(&self, origin: ZoneType) -> Vec<CardId>

Get cards that were added to this zone this turn from the given origin zone. Mirrors Java’s Zone.getCardsAddedThisTurn(ZoneType).

pub fn get_cards_added_last_turn(&self, origin: ZoneType) -> Vec<CardId>

Get cards that were added to this zone last turn from the given origin zone. Mirrors Java’s Zone.getCardsAddedLastTurn(ZoneType).

pub fn is_card_added_this_turn(&self, card: CardId, origin: ZoneType) -> bool

Check whether a specific card was added to this zone this turn from the given origin zone. Mirrors Java’s Zone.isCardAddedThisTurn(Card, ZoneType).

pub fn get_lki_copy(&self) -> Zone

Create a shallow copy of this zone for last-known-information purposes. The returned zone has the same type, owner, and card list. Mirrors Java’s Zone.getLKICopy().

pub fn save_lki(&mut self, card: CardId, origin_zone: ZoneType)

Save last-known-information for a card entering this zone. Mirrors Java’s Zone.saveLKI().

Trait Implementations

impl Clone for PlayerZone

fn clone(&self) -> PlayerZone

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PlayerZone

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

Formats the value using the given formatter.

impl Deref for PlayerZone

type Target = Zone

The resulting type after dereferencing.

fn deref(&self) -> &Zone

Dereferences the value.

impl DerefMut for PlayerZone

fn deref_mut(&mut self) -> &mut Zone

Mutably dereferences the value.