How Can We Help?

This post refers to the new-and-improved beta version of Tabletop Playground, and may describe functionality or UX not present in the legacy version. For information about the beta, click here.
Objects in TTP are created from Object Templates. Once you’ve created an Object Template, it’s stored in your Object Library and you can spawn any number of instances of it on the table.
To create a new Object Template, click “New Template” in your Object Library.

This will bring up the “Select Object Type” modal. Select the type of object you want to create in the left-hand window, then use the modal on the right to load whatever initial asset is required for that object.

In the select resource window, click “Import” to open the file browser, then find and select the file on your computer.

This will bring you back to the Select Object Type modal, where you can hit “Create” to generate the object.
TTP will then create an instance of your new object in the center of the table, and bring up the Customize dialogue, also known as the Edit Template dialogue.

Up at the top, you can name your object, and/or write a Description for it. (The Description will serve as the tooltip for the item if present; if left blank, it’ll use the name.)
The main window will by default show you the “Customize” dialogue, which offers the most common options for whatever type of object you’re trying to create. Some less-common options specific to that type of object can be found in the Advanced Options tab. The iconized tab buttons on the left-hand side will let you access other options, common to many types of objects.

Once you’re happy with your object, click “Create” at the bottom of the dialogue.
You’ll see that your new object remains on the table. But that’s not the only place it exists. If you reopen your Object Library, you’ll see your new object template inside. By clicking on it, you can place new copies of it on the table. You can also delete any object on the table (including the “original”) without harming the template.

Mousing over the template, you’ll see buttons allowing you to Edit, Duplicate, or Delete it.
Editing Objects
As discussed above, each object on the table is an instance of its template. If you want to change something about an object, you can either modify the template itself, or you can make a change specific to that instance of it.
Editing the Template
You can get back to the Customize menu you saw when you created your object by right-clicking on it, and choosing “Customize” or “Customize -> Edit Template.” You can also click the “Edit” button on the template in your Object Library, though note that doing so will spawn a new instance of that object at the center of the table.
The dialogue that comes up will be identical to that seen during template creation, except that the options on the bottom will be different; you’ll now see “Close,” “Save as New,” and “Save and Apply.”

- Save as New will create a new template incorporating the changes you’ve just made.
- Save and Apply will save the changes you’ve just made to the template, applying them to all objects that share that template.
If you click “Close” while you have unsaved changes, it will ask if you wish to save. If you say “Yes,” it will do the same thing as “Save and Apply.”
Note: While in a multiplayer game, only a Host can edit a Template.
Editing an Individual Object
You can adjust an individual object without affecting its template using the other options in the “Customize” sub-menu – Scale and Rotate, Appearance, and Properties.
You can also adjust an object’s scale by mousing over it and hitting the associated hot key (+ or – by default). This will behave the same as if you’d altered it using the Scale and Rotate menu.
Changes you make in this way will not affect any other object using the template, and may be overridden should you alter the template later.
In a multiplayer game, these kinds of adjustments can be made by any player (as opposed to template edits, which can only be made by the host).
Editing Objects From Other Packages
On the left side of your Object Library, you’ll see a variety of packages containing basic objects that come with TTP, along with your own package.
You (and all other players in multiplayer) can place these objects freely and make object-level edits to them. However, you can only edit the template of objects in your package. If you attempt to edit the template of one of the built-in objects, you’ll see the normal Customize screen with most of the options greyed out:

But all you need to do to correct this problem is hit the “Save as New” button at the bottom. This will save a copy of the Object Template in question to your package, which you can then edit freely.

Alternatively, you can copy an object to your package by mousing over it in the Object Library and clicking “Duplicate this template.”

If you go back to your package, you’ll see the duplicate there, at which point you can interact with it as you would any other object.

Next Steps
For more about creating and editing certain kinds of objects, refer to the links below:
