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
| Mode | Owner sees | Everyone else sees |
|---|---|---|
Public() | full cards | full cards |
OwnerOnly(p) | full cards | one opaque entry per card, with a stable UUID: trackable, not identifiable |
Concealed(p) | full cards | the count only, no entries, no UUIDs |
FaceDown() | one positional entry per card, no UUID | the same |
Hidden() | the count only | the count only |
| unset or unknown | the 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.FaceDowndiscloses the position of a card revealed in place. - A hand:
Concealedunless the client must animate an opponent’s individual cards.OwnerOnlylets 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 nogame_stateunless the game implementsSpectatorStater.
Never ship MarshalZone output or a cig2.Inspection to a player: both are unfiltered.