Switcher Object

Switchers are different from other object types: they don’t have their own appearance and instead always look like the currently active switchable object. You don’t create switchable objects in the editor, but in-game: in the context menu for multiple selected objects, click “Create Switcher”. The selected objects will be combined into one switcher object.

The order of states in the new switcher is determined by the order in which you select the object to combine, and which object you right click to create the switcher. If you care about the order of states in the switcher, the easiest way to ensure the order of selected objects is to hold Ctrl and click the objects one by one to add them to the selection. Then make sure that you right click the object which should become the first state to bring up the context menu.

Switcher objects have custom actions to switch to the next or previous state, and to pick a random state. Each state corresponds to one of the objects that the switcher was created with. Finally, there’s the “Remove Switcher” option which will just keep the current state object and remove the switcher along with all other states. If the current state object doesn’t define a primary or secondary action, the respective hotkeys can be used to switch to the next or previous state object.

You can still modify each state object (for example by changing their color) and the modified state will remain when you switch ot another state and back. You can do most actions with objects that are part of a switcher that you could do with regular objects, with a few exceptions: switcher objects can’t become parts of new switchers, and switchable cards can’t go into other card stacks (but other cards can be added to the switchable card stack). Switchable cards in card holders can’t change their state while in the holder.

Multistate objects

Multistate objects are an object type in Tabletop Playground. They work just like generic objects, but have a number of states that can be cycled and alter their appearance. You can switch to the next state by pressing the object action button, or switch to the previous state by pressing the secondary action button.

Multistate objects have two custom context actions:
Next state: Switch the object to the next state.
Previous state: Switch the object to the previous state.

Multistate objects have a custom property:
State: The current state of the object.

Containers

Containers are an object type in Tabletop Playground. You can put other objects into a container by dropping them onto it. You can take objects out of a container by clicking and quickly dragging off the container. If you want to grab a container, click and hold until you pick it up.

The type of a container determines how objects are taken out. There are four variants:
Random: Take out one of the contained objects at random.
Infinite Random: Take out a random object, but keep a copy of it in the container.
Stack: Take the first inserted object out last.
Queue: Take the first inserted object out first.
Infinite queue: Take the first inserted object out first, but keep a copy and move it to the end of the queue.

Containers have two custom context actions:
Empty: Removes (and deletes) all objects from the container.
Container Explorer: Open a new window that allows you to inspect the container’s contents

Containers have custom properties:
Container Type: The type of the container.
Take Rotation: Determines how objects taken from the container should get rotated. Possible values are “Default Rotation” to get objects in their standard orientation, “Container Rotation” to rotate them like the container, and “Flipped” to get objects in their standard orientation but flipped.
Lazy Load: Determine whether objects in the container should only be loaded once they are taken out or viewed in the container explorer. Loading an object may cause a hitch, so in general it is preferrable to leave this off. It can help when you have a large game and containers that include objects which are often not needed during a game.
Max Items: The maximum number of items this container can hold. If there already more items than the maximum, they won’t be removed from the container.
Owner: Allows you to define an owning player for the container. Only the owning player and their team can explore the content of the container. If no player owns the container, all players can use the container explorer.

Tables

Tables are an object type in Tabletop Playground. There is never more than one table in every game. Tables cannot be moved or interacted with by players in any way, but scripts have access to table objects. You can select a table when you start a new game. If you load an existing game state, it determines which table is used.

Cardboard figures

Cardboard figures are an object type in Tabletop Playground. In the game, they behave just like generic objects. The main use of cardboard figures is how easy they are to create: you only need an image to create a new figure.