Zone visibility
A zone’s visibility decides who can see what is inside it. This is the one place taybl does more than describe a scene — it is engine-enforced. Everywhere else, taybl trusts players to resolve the rules by hand; here, the server actively hides what a player isn’t entitled to see.
Two fields work together: view controls who can see the zone’s contents, and
faceOnEnter controls how a component is turned when it lands in the zone.
view — who can see the contents
view defaults to public. The other two values hide contents based on who
owns the zone instance (for a perSeat zone, the seated player it belongs to):
view | Who sees the contents | Use it for |
|---|---|---|
public | Everyone (the default) | The board, a face-up discard, a shared tableau .optional() |
owner | The owner only — hidden from everyone else | A private hand; pair with scope: perSeat so each player sees only their own |
othersOnly | Everyone except the owner | Hanabi-style hands — you hold cards you can’t see but everyone else can |
This is enforced in server-side state redaction: before the game state is broadcast to each player, the contents of any zone that should be hidden from them are stripped out (the card face, its identity, and its position), leaving only a face-down placeholder and the count. A hidden card never crosses the wire to a player who shouldn’t see it, so even a curious or tampered client cannot recover it. (Activity-log snapshots and non-public reveals are redacted the same way, to close shuffle-correlation leaks.)
Because owner and othersOnly only mean something when a zone has an owner,
they imply a per-seat hand: set scope: perSeat so each seated player owns
their own copy — see zone scope.
faceOnEnter — facing on entry
faceOnEnter (optional) sets which way a component turns the moment it enters
the zone — drawn, dealt, or dragged in. It is about facing, while view is
about who may see; the two often pair (a face-down draw pile, a face-up
discard).
faceOnEnter | Turns the component… | |
|---|---|---|
up | Face up — front visible | A face-up discard or reveal area .optional() |
down | Face down — back showing | A face-down draw pile or deck .optional() |
owner | Front to the owner only | Drawing into a private hand .optional() |
othersOnly | Front to everyone except the owner | Hanabi — held facing outward .optional() |
keep | Leave the component’s current facing untouched | The default behaviour .optional() |
How to edit in the Studio
Open your game → Layout tab → select a zone. In the Properties card,
the Visibility dropdown sets view — Everyone, Owner only, or
Everyone except owner — and the Face on enter dropdown sets
faceOnEnter. For an owner-only zone, also set Who uses it to Each
player so every player owns their own private copy.
Related
- Zones overview
- Zone scope — owner views imply per-seat hands
- Zone roles
- Cards — what gets flipped and hidden