Tokens

A token is a single physical object on the table whose behavior is driven by its shape rather than by face art. Tokens are used for pawns, markers, trackers, counters, and any piece whose identity comes from geometry and color. A token has a kind, a size, a color, a position, and a 3D orientation.

Kinds

A token always has a kind. The kind is fixed at creation and determines the token's geometry and which size controls apply. Five kinds are built in, and two additional kinds come from importing external assets.

• Block — a rectangular prism sized by width, height, and depth.
• Disc — a cylinder sized by diameter and thickness.
• Pyramid — a four-sided pyramid sized by base width and height.
• Pawn — a humanoid figure. Pawns are the only tokens that can hold attached rings.
• Ring — a flat ring. Rings are the only tokens that can be attached to a pawn.
• Image Token — a flat sprite whose appearance is an imported image.
• Model Token — a 3D piece whose shape is an imported mesh.

Built-in tokens are added from the Entity Browser. Image Tokens and Model Tokens are created automatically when you import a game component whose art defines the shape.

Customization

This section covers what you can change about how a token looks and behaves. Properties are edited in the Entity Browser, individually or through the batch editor when multiple tokens are selected.

What you can change

• Name — the label shown in menus, tooltips, and the Entity Browser.
• Fill color — the primary color of the token's geometry. Used by Block, Disc, Pyramid, Pawn, Ring, and Model Token. Image Token ignores fill color because its appearance is driven by the imported image.
• Dimensions — width, height, and depth. Stored in millimeters and displayed in the table's preferred units.
• Corner radius — rounds the edges of Block tokens. Has no effect on other kinds.
• Stackable — a toggle. When off, the token refuses to join a stack or accept other tokens on top of it.

Kind-specific properties

• Attached rings (Pawn only) — a pawn can carry a stack of rings around its body. Each attached ring tracks its own name, color, width, depth, and rotation independently of the pawn.
  
• Imported mesh (Model Token only) — the mesh defines the token's shape. Dimensions still apply as a bounding box, and fill color tints the mesh.
• Imported image (Image Token only) — the image is the face of the token and replaces the color-driven appearance used by the built-in kinds.

Imported tokens

Image Tokens and Model Tokens share most of the behavior described on this page: they have a name, dimensions, a position, a 3D orientation, and they participate in stacking and the actions listed below. The main differences are that an Image Token ignores fill color entirely, and both imported kinds are created through the import flow rather than from the Entity Browser.

Placement and transforms

Every token has a position and a full 3D orientation on the table.

• Position is stored as x and y table coordinates in millimeters and displayed in the table's preferred unit.
• Z-index controls which token renders on top when two tokens overlap. New tokens are placed above existing tokens.
• Rotation is a 3D rotation with independent X, Y, and Z angles in degrees. Rotation is edited through the Rotation tab of the token editor, not directly on the table surface. Most tabletop use only involves the Z axis, but the other axes are available for propping a token on its side.
  
• Exhaustion is a secondary orientation. An exhausted token is tipped over from its standing position to indicate it has been used; un-exhausting returns it to standing. It is a display state only and does not change any other property.
  
• Position lock freezes a token in place. Locked tokens can still be selected and edited, but they cannot be dragged or rotated until unlocked.

Stacking

Tokens can stack on each other to form a pile. A stack always renders as four tokens piled together regardless of how many are actually in it; the true count lives in the badge beside the stack. A stack of two and a stack of two hundred look the same on the table. See also the Token Bowl and Bag utility pieces for containers that group tokens.

• Drop a token on top of another token to form or grow a stack.
• Drag a token off the top of a stack to remove it. The remaining tokens stay stacked.
• A stack can mix tokens of different kinds, colors, and sizes.
• A token whose Stackable property is turned off will neither join a stack nor accept other tokens on top of it.
• While a token is part of a stack (its stack count is greater than one) it cannot be exhausted; unstack it first.

Actions

The action dock runs in two modes: Interact and Edit. Each action below is marked with the modes it appears in, and whether it is available on a multi-token selection.