Hidden information

What each seat sees is computed by cig2.Filter from each zone’s visibility. The game never filters cards by hand. It can still leak through the data it writes itself, and cig2test.Explore checks for that (E501, E502).

Modes, per viewer

ModeOwner seesEveryone else sees
Public()full cardsfull cards
OwnerOnly(p)full cardsone opaque entry per card, with a stable UUID: trackable, not identifiable
Concealed(p)full cardsthe count only, no entries, no UUIDs
FaceDown()one positional entry per card, no UUIDthe same
Hidden()the count onlythe count only
unset or unknownthe count only (fails closed)the count only

Card.Reveal() outranks every mode, permanently. A revealed card is shown in full everywhere.

Choosing

  • A draw pile: Hidden. FaceDown discloses the position of a card revealed in place.
  • A hand: Concealed unless the client must animate an opponent’s individual cards. OwnerOnly lets opponents follow a physical card in and out (“the card drawn two turns ago was just played”).
  • A tableau whose arrangement is public but whose cards are not: FaceDown.

Leaks the filter cannot stop

The game writes these itself, so it must filter them by viewer:

  • GameState(s, viewer): return only what that viewer may know.
  • Decision prompts and choices: only the asked seat sees them. Still, never put a card’s UUID in choices unless the seat can already see that card.
  • Hint data and labels: per viewer, same rule.
  • Error messages: they go to the seat that acted.
  • Spectators (Session.Watch) get no game_state unless the game implements SpectatorStater.

Never ship MarshalZone output or a cig2.Inspection to a player: both are unfiltered.