Troubleshooting

This page collects common solutions to problems that can occur with the game.

The game doesn’t start or crashes when starting

Run the game as administrator
1. Right click the game in your Steam Library.
2. Go to Properties then the Local Files tab.
3. Click Browse Local Files.
4. Right click on the game executable (TabletopPlayground.exe) and go to Properties.
5. Click the Compatibility tab.
6. Check the “Run this program as an administrator” checkbox.
7. Click Apply. Try running the game again through Steam. If it still doesn’t start, try running the executable directly.
8. If it still doesn’t work, or if the game runs but you can’t find other players, run Steam as administrator as well: set the “Run this program as an administrator” checkbox for the Steam executable, or for the shortcut that you use to start Steam.


Set environment variable
If nothing at all happens when you start the program, you may be affected by an issue some processors have with the OpenSSL version used in the game. You can try the following:
1. Open the start menu
2. Type “cmd” and press enter to open the console
3. In the console, enter the following and press Enter:
setx OPENSSL_ia32cap :~0x20000000
4. Fully close and restart Steam and try to launch the game again.
5. If this doesn’t help, undo the change by entering the following into the console window and pressing enter:
setx OPENSSL_ia32cap ""


Run the game in windowed mode
1. Right click the game in your Steam Library.
2. Go to Properties and click on “Set Launch Options…”
3. Enter -windowed into the text field and press ok
4. Start the game


Disable other software that might interfere
If you are running programs like alphaconsole/gifyourgame/bakkesmod/plays.tv, streaming software, or an antivirus program, try disabling them before starting the game.


Update your drivers and Windows
Make sure you have the latest drivers for all your hardware, in particular for your graphics card. Check that you have all the latest Windows updates installed.

Packages

All game content in Tabletop Playground is organized in packages. A package is a collection of Object Templates, Models, Textures, Scripts, and Game States. You can create new packages using the editor and upload them to mod.io.

Playing with packages

When starting a game, you will usually choose a saved state or a table from a package. This package then becomes active for your game, and all players wanting to join your game need to have the package installed as well. Some packages are included with Tabletop Playground and always active, for example the Dice and Cards packages.

In the game, you can only create objects and load states from active packages. The host can add packages to the active list from the session options or object library if all players have the additional packages installed.

When selecting a game in the server browser, the active packages are displayed. For packages that you don’t have, a button allows you to download them immediately.

In order to get new packages, head over to mod.io and log in with your Steam account. You can then subscribe to any available package. Subscribed packages will be downloaded when you start the game. You will also automatically get updates from packages that you have subscribed to.

Creating packages

When you use the editor, you will always work on a package. If you want to create a new game, you first create a package for it with a suitable name. A new folder will be created in you Tabletop Playground directory (under PersistentDownloadDir). All content for the package will be stored within that folder. For example, when you select a texture for an object in the editor, the texture file gets copied into the Textures folder in the package directory.

Instead of creating a new package from scratch, you can also choose to start by duplicating an existing package. In that case, all content from the source package will get copied to your new package. All object templates will get a new GUID in your new package, and the game states in the copied package will be updated accordingly. But local states or states in other packages will continue to reference the objects from the original package, so you don’t have to worry about breaking anything when working on a duplicated package.

Uploading packages

When you’re ready to share your creation with the world, you can upload the package to mod.io. Just choose a representative image, Tabletop Playground will take care of the rest. After the upload, you can go to the package page and provide additional information such as a description, screenshots, and categories.

You can also set the visibility of the package to hidden if you don’t want people to see it on the mod.io page. Private packages can still be downloaded in-game when selecting a server that uses the package in the server browser. Finally, updating a package works in the same way as the initial upload.

Note that you don’t need to (and shouldn’t!) subscribe to your own packages on the computer where you edit them. If you do, the game will find the same package twice in different directories and display an error.

Using motion controllers

You can play Tabletop Playground in VR using mouse and keyboard, but for more immersion we recommend using motion controllers. Tabletop Playground supports Vive Wands and Oculus Touch controllers. At any time, you can look at your motion controllers for a few seconds to see a visual guide what each control element does.

When you use motion controllers, the controls work a bit different than with mouse and keyboard. First, you have a main hand and secondary hand. By default, your right hand is the main hand, you can change that in the interface settings. When you open a UI dialog, it will get attached to your secondary hand.

There are two cursor modes for motion controllers: the regular mode works similar to the usual screen cursor. A line is projected from your main hand controller and you point at where you want the cursor to be. In free cursor mode, the cursor is directly attached to you main hand, which enables more natural interactions. You can press the main hand grip button (middle finger) while holding an object to freely rotate it as you rotate your hand.

You have several options of moving around in the world when using motion controllers: First, there’s teleporting. By pressing a button (on the Vive wands) or the stick on the Touch controllers, you can teleport to the position of the cursor. If you hold the button, you can also determine what direction to face after teleporting. Second, you can press and hold the secondary hand index finger trigger to drag yourself around in the world. When you let go of the button while you drag, you can propel yourself around quickly! Finally, you can activate stick/touchpad movement in the interface settings and use the secondary hand stick or touchpad to move around.

When you press the grip button on both motion controllers simultaneously, you can rotate the world around you if turning by dragging is activated in the settings. You can also change your size by changing the distance between the controllers before releasing the grip buttons. And while you hold the main hand trigger button, you can do 45° instant turns using the main hand stick or touchpad.

By default, you don’t collide with the table and can walk through it. In the interface settings, you can turn on table collision. That allows you to teleport yourself on top of the table and make yourself smaller to walk around among your game pieces! In the settings, you can also switch to fly mode, which won’t restrict you to standing on the ground and allows you to move up and down with the main hand stick/touchpad.