Spectators and Game Masters

Spectators and Game Masters are special roles that players can take. They influence what information players can see and how they interact with the game.


You can switch to being a spectator in the player options. Spectators don’t occupy a player slot and always have a grey cursor and chat color. In the player list, their color is transparent. Spectators cannot interact with objects on the table and other players can’t see their cursor. Voice and text chat work as for other players, though.

By default, spectators can’t see any hidden information: hand cards and held cards of all players are hidden, they can’t peek under cards and can’t use the stack or container explorer. There’s a setting in the session permissions that allows spectators to see all hidden information instead. When a spectator peeks or uses an explorer, other players are not notified like they would be if a regular player performs the same action. Another session permission allows you to disable spectators entirely.

Game Masters

In the session options under player slots, the host can assign slots to be game masters. A player in a game master slot can see all hidden information, like a spectator when the spectators see all permission is true. Game masters can also interact with anything: they can take cards from the hands of other players, for example.

Turns, Phases, and Rounds

You can use the turn system in Tabletop Playground to help players keep track of the state of your game. There are three concepts to remember when using the turn system:

  • Rounds: Each game consists of a number of rounds, which can be made up of phases. By default, there are no phases, and only rounds exist.
  • Phases: A phase has a name, a list of player slots, and two options: taking turns and restricting interactions. You can configure a list of phases, and in each round the game will move through the phases in order. When a phase is configured for taking turns, each active player in an associated player slot will get a turn. If restricting interactions is selected, only the players in associated slots will be able to interact with game objects during the phase. If both restricting interactions and taking turns are on, only the player whose turn it is will be able to interact.
  • Turns: Turns are active within phases with taking turns configured, with only one player going at a time.

You can define phases in the session options. They can be modified during play, but only as the host. Use the main context menu to move to the next/previous turn, phase, or round.

Defining Phases

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.

Changing the location of mod.io installs

If you want to change where the packages that are downloaded from mod.io are stored, you need to enter the path you want to use in a file to tell mod.io where to save the downloaded packages. Here’s how to find the file (globalsettings.json) depending on your platform:

  • Windows Open an explorer window and type %localappdata% in the address bar. Then, go to the mod.io folder.
  • Mac In the finder menu, click on “Go”, then “Go to Folder…” and enter ~/Library/Application Support/mod.io
  • Linux In your home directory, go to the mod.io folder

In the file, you will see an entry that looks like this: {"RootLocalStoragePath":"C:/Users/Public/mod.io/"}
Change the path inside the brackets to the folder you want. On Windows, take care that you use / instead of \ to separate the path. For example, you can modify the file to look like this: {"RootLocalStoragePath":"E:/Game Data/mod.io/"} to store your downloaded packages in the folder E:\Game Data\mods\. If the file contains multiple entries, you can delete all except one.