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.
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 members — assign any component to the group; 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.
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.
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