Dice

Dice are an object type in Tabletop Playground. When you pick up and throw dice, they get a random spin and every player gets a notification with what was rolled once thrown dice come to rest. When you drop dice without throwing them, they behave as generic objects. Rotating a picked up die cycles through each face pointing up. You can also roll dice without picking them up by pressing the object action button.

Dice also have special tooltips: when hovering a single die, the tooltip will show which face is up. When multiple dice are selected, the tooltip shows how often each face is up and the sum of all faces. For custom dice, faces can also have names instead of numbers. The names are included in the tooltip, but not counted towards the sum.

Texture Maps

If you want to create custom dice using the default models and your own textures, here are sample images that show where the faces of the dice are mapped to the texture: Dice UVs. If you want to modify the standard normal maps and extra maps, you can find them here: Dice_Textures.

Face Directions

If you need not just a custom image for your dice, but a custom shape, you can import your own 3D model. For the tooltips and dice roll messages, the game needs to know where the dice faces on your custom model are, as well as their names and numbers. You can set up the faces in the editor. Each face direction is a vector: it should be the direction from the center of the model to the center of the respective face. You can visualize the face directions by clicking on the eye icon on the dice editor pane.

Card holders

Card holders are an object type in Tabletop Playground. A card holder can contain a number of cards. When dropping a new card onto a card holder, the existing cards move to show where the new card will be put.

Card holders can be ownerless, or have a single player as owner. If they have an owner, all cards on the holder with their front face up are only visible to the owning player, other players just see a grey blur. Cards with their back face up are shown to all players.

Single cards or small card stacks can be put into card holders, as long as the capacity limit isn’t reached: card holders have a maximum number of cards that they can hold.

Card holders have two custom properties:
Take Cards: Determines whether only the owning player can take cards from the holder.
Owner: The player color that owns the card holder. Can be set to no player.

Cards

Cards are an object type in Tabletop Playground. Card objects can represent playing cards, tiles, or tokens. They have several properties that distinguish them from generic objects: Cards can be stacked – if you drop a card onto another card or stack of the same shape and size, both will get combined into a stack. You can take the top card from a stack by dragging it off. If you want to take a whole stack, click on it and hold until you pick up the stack.

While you hold a card, its face isn’t visible to other players (they will only see a grey blur). To prevent cheating, the card front face is not visible for yourself either while you hold a card with its back face up. Cards can also be used with card holders, and their faces can be hidden from players that aren’t the owner of the card holder.

Card stacks have two custom context actions:
Shuffle: Randomly shuffles the cards in the stack.
Deal: Gives out a card to each card holder present in the game.
Split: Brings up a window that allows you to split the stack in different ways

Texture Map

If you want to create your own textures for card shapes other than square (which always uses up the whole texture), here are the exact shapes that are used. Since the rounded edges of the rounded style get distorted by strong scaling, there are three different shapes: The regular ones for cards that are relatively square, a high variant for cards where the height divided by the width is at least 1.17 (like standard 6 cm by 9 cm playing cards), and a wide on for cards with width / height < 0.86.

Rounded Regular
Rounded High
Rounded Wide
Round
Hexagonal

Generic objects

Generic objects do not have special behaviors. Most objects in a board game such as pieces or boards can be represented as generic objects.