Decks & component groups
A component-group is a named set of components that belong together — most commonly a deck of cards that share one back image. A group owns its members (which components, and how many of each via a per-member quantity) and an optional shared back, so you can drop the whole group into a zone instead of every component one by one.
A deck is just a component-group of cards: the drawable cards are its members, and the shared back is what makes them read as one deck face-down — exactly like a real shuffled deck. Any component kind may belong to a group (a token supply, a set of pieces), not only cards.
Because it is one binding behind the whole deck, the shared back is also where you fix one: press Turn on it and every member that has no back of its own turns with it, so a back sheet that scanned upside down is a single click rather than fifty-four. See the face bindings in components.
The pile itself is an ordinary draw zone — a zone whose
role is draw and whose
arrangement is stack. There is no special "deck"
object: a deck is the group of cards plus the zone players draw them from.
taybl never deals or shuffles on its own beyond the optional
setup automation you configure.
What makes a deck
| Piece | Where it lives | What it does |
|---|---|---|
| The pile | A zone with role: draw, arrangement: stack | Holds the cards face-down as a stack |
| The cards | card components | The drawable contents; each has a front face |
| The group | a componentGroups[] entry (name + members + shared back) | Ties the cards into one deck and carries the shared back |
| Membership | each member component’s group id | Marks which group a component belongs to (projected from the group’s members) |
How to edit in the Studio
Open your game → Layout editor → the Component Groups section in the left nav (just below Components). Each group lists its members and their quantities. From here you can:
- Create a group and give it a name.
- Add or remove members — the picker stays open as you work, so you can tick off a whole deck in one pass rather than reopening it per card; ticked components are the current members, and unticking one frees it. Each member can carry a quantity (e.g. three copies of one wild card).
- Set a shared back — one back image applied to every member that has none. Upload it, or press Choose to pick one of the images the game already holds.
Setting the shared back writes it onto each member’s faces.back, and the
per-member quantity drives how many copies are placed. The draw-pile zone
itself — its position and size — is edited on the canvas like any other zone;
place the whole group into it with a single setup placement that targets the
group.
A standard deck in one click
If the deck you need is an ordinary deck of playing cards, do not build any of this by hand. The Standard deck entry in the component library adds all four rows of the table above at once — the 52 cards, the group that owns them, the shared back, and the face-down draw pile — plus jokers if you tick the box. All that is left is to place the group into the pile.
Related
- Card — the component a deck is made of
- Zone roles — the
drawrole - Zone arrangement — the
stackarrangement - Setup placements — place a whole group into a zone
- Setup automation — shuffle and deal at game start