Skip to main content

Export a deck to Tabletop Simulator

Game Piece Studio publishes one live Tabletop Simulator deck per design. Studio hosts its sheets and provides a saved-object JSON file; Tabletop Simulator loads the hosted artwork when you spawn that object.

Hosted Tabletop Simulator export is available on Lite and Pro plans. A hosted build supports up to 500 saved dataset rows.

Anyone who has the saved object can request its capability-protected artwork. Treat the file and its URLs as private when the game is private.

Tabletop Simulator export settings for sheet columns, rows, image size, rotation, format, and orientation

Publish and import the deck​

  1. Save the design, dataset, and image changes you want to test.
  2. Review the generated collection in Export QA.
  3. In Export settings, enable Tabletop Simulator.
  4. Open Advanced sheet settings only if you need to change the sheet grid, 4096-pixel maximum, rotation, JPG/PNG format, or Sideways behaviour for landscape-card ALT zoom.
  5. Choose Publish hosted deck (the button reads Start exports or Export batch when other formats are also enabled) and wait for the hosted build to become ready.
  6. Open Hosted exports, choose Details on the design's Tabletop Simulator export, and download the stable saved-object JSON.
  7. Move the JSON file into the Saves/Saved Objects folder inside your Tabletop Simulator data directory.
  8. In Tabletop Simulator, open Objects → Saved Objects and spawn the deck.
  9. Check the card count, order, names, fronts, backs, orientation, and physical scale before beginning the playtest.

Keep Mod Caching enabled for normal play. Avoid Cloud Manager's Upload All on this object: it replaces the Studio-hosted asset sources, so the object will no longer follow Studio's live version.

Rebuild after a change​

A successful rebuild creates a new version and makes it live at the same stable URLs. Studio retains the five most recent versions.

  • Artwork-only change: publish again, then reload the room. Tabletop Simulator checks Studio's verified texture URLs once per session; start a new room or restart Tabletop Simulator if cached art remains.
  • Structural change: download and import the saved object again when card count, order, names, sheet layout, back mode, orientation, or another deck-structure value changes. Existing spawned objects do not learn a new structure from refreshed textures.

The build uses the source captured for that version. Changes made after it begins require another rebuild.

Use versions safely​

Open the export's Details in Hosted exports to view versions. Choose Make active to make a retained version live again. Studio warns when its structure differs from the current live version; in that case, import that version's saved object again.

Deleting a non-live version breaks its fixed-version URL. Deleting the live version falls back to another retained version when possible, and can require a fresh import if the structure differs. With no fallback, the stable URL stops working until you publish again.

Replacing the stable URL with Replace URL is a security reset. Every old object using it stops loading, so download and distribute the new saved object afterward.

Manual custom-deck setup​

The normal route is the saved object. If you need to build a Custom Deck manually:

  1. Open the export's Details, then expand Create a deck manually in TTS.
  2. In Tabletop Simulator, choose Objects → Components → Custom → Deck.
  3. Copy the listed face and back URLs with Copy for TTS.
  4. Enter the exact Width, Height, Number, Unique Backs, Sideways, and Back is Hidden values.
  5. If Studio lists several sheets, make one Custom Deck for each sheet and combine them in Tabletop Simulator.

Troubleshooting​

  • Old art after a ready rebuild: reload the room, start a new room, or restart Tabletop Simulator. Persistent cache settings can retain files longer.
  • Old card count or order: this is structural; download and import the saved object again.
  • Blank cards or a load error: confirm the export is still present and has a live version. A deleted export, deleted live version without fallback, or replaced stable URL invalidates the old object.
  • Wrong backs: verify the design uses the intended shared or unique back, rebuild, and re-import if that choice changed.
  • Unexpected landscape zoom: check Sideways and rotation in the export settings, then rebuild and re-import.
  • Cards split into several decks: the generated deck exceeded one sheet. Use the saved object, or create and combine every sheet when configuring manually.

See Tabletop Simulator's asset importing guide, data-folder locations, and Custom Deck reference for client-specific details.