Skip to main content

TTS Deck Editor Tool

Learn how to create card sheets for Tabletop Simulator by uploading your card images and generating ready-to-use PNG files.

Updated over a week ago

Welcome to the TTS Deck Editor! This tool makes it easy to create professional card sheets for Tabletop Simulator (TTS). Whether you're prototyping a card game or preparing a deck for digital playtesting, we've simplified the process so you can focus on your game design.

What is the TTS Deck Editor?

The TTS Deck Editor takes your individual card images and arranges them into a grid layout that Tabletop Simulator can use. Instead of importing cards one by one, you upload all your cards at once and generate a single sheet (or multiple sheets) that TTS can read automatically. This saves hours of manual work!

Understanding Tabletop Simulator Card Sheets

Tabletop Simulator uses a specific format for card sheets:

  • Cards are arranged in a grid (rows × columns)

  • The maximum grid size is 10 columns × 7 rows (70 cards total)

  • One slot is reserved for the "hidden" card back (the card face you see when cards are face-down)

Important: The last image you upload will automatically become the hidden card back for all cards. This means if you have a grid that fits 70 cards, you can upload 69 front card images plus 1 back card image.

Getting Started

Step 1: Access the Tool

Navigate to Tools → TTS Deck Editor from your account dashboard. You'll see three main sections:

  • Grid Settings (left) - Configure your sheet layout

  • Upload Cards (middle) - Add your card images

  • Preview (bottom) - See your sheets before generating

Step 2: Configure Your Grid Layout

Before uploading cards, set up your grid layout:

Columns (max: 10)

  • Enter the number of columns you want (between 2 and 10)

  • More columns = more cards per row

  • Default is 10 columns

Rows (max: 7)

  • Enter the number of rows you want (between 2 and 7)

  • More rows = more cards per column

  • Default is 7 rows

Understanding Capacity:

  • Maximum grid: 10 columns × 7 rows = 70 total slots

  • One slot is reserved for the hidden card back

  • So you can have: (rows × columns - 1) front cards + 1 back card

Examples:

  • 10 columns × 7 rows = 69 front cards + 1 back = 70 total

  • 5 columns × 4 rows = 19 front cards + 1 back = 20 total

  • 3 columns × 3 rows = 8 front cards + 1 back = 9 total

Tip: The tool shows you exactly how many cards you can fit based on your current grid settings. Watch this number as you adjust rows and columns!

Step 3: Upload Your Card Images

Click in the upload area or drag and drop your card image files. You can:

  • Upload multiple files at once - Select all your card images in one go

  • Upload images in any order - Arrange them later if needed

  • Use any image format - PNG, JPG, and other common formats work great

Key Points:

  • Upload all your front card images first

  • Upload your back card image last (it will become the hidden card)

  • The tool accepts unlimited images, but you'll generate multiple sheets if needed

  • Each image should be a single card design

Example Workflow:

  1. Upload 69 front card images (for a 10×7 grid)

  2. Upload 1 back card image as the last file

  3. The back card automatically becomes the hidden card for all cards

Step 4: Review the Preview

The preview section updates automatically as you:

  • Change grid settings

  • Upload or remove card images

What You'll See:

  • Live preview of your card sheets

  • Numbered placeholders for empty slots (if you have fewer cards than slots)

  • Multiple sheet previews if your deck spans multiple sheets

  • Sheet labels showing which sheet number you're viewing

Using the Preview:

  • Check that all your cards are visible and correctly positioned

  • Verify that the last uploaded image is being used as the card back

  • Make sure the grid layout looks good for your deck size

  • Adjust rows/columns if needed before generating

Step 5: Generate Your PNG Files

Once you're happy with the preview:

  1. Click the "Generate PNGs" button in the top right corner

  2. Watch the progress indicator - it shows "Generating (1/3)" for example

  3. Your browser will automatically download each sheet as a separate PNG file

  4. Files are named: tts-deck-sheet-1.png, tts-deck-sheet-2.png, etc.

What Happens:

  • The tool creates high-quality PNG images

  • Each sheet is exactly the right size for Tabletop Simulator

  • Multiple sheets are created automatically if your deck is large

  • All sheets download to your computer's download folder

Understanding Multiple Sheets

If you upload more cards than fit in one sheet, the tool automatically creates multiple sheets:

Example:

  • Grid: 10 columns × 7 rows = 69 cards per sheet

  • You upload: 150 front cards + 1 back card

  • Result: 3 sheets generated

    • Sheet 1: Cards 1-69 + back

    • Sheet 2: Cards 70-138 + back

    • Sheet 3: Cards 139-150 + numbered placeholders + back

Numbered Placeholders:

  • Empty slots are filled with numbered placeholders

  • These help you see where cards are missing

  • In TTS, you can ignore these or use them as blank spaces

Tips for Success

Preparing Your Card Images

Best Practices:

  • Consistent sizing - Cards will be resized to 409×585, but starting with similar sizes helps

  • High quality - Use the best quality images you have

  • Clear borders - Ensure cards have clear edges so they look good when arranged

  • File organization - Name your files logically so you know which is which

Image Formats:

  • PNG (recommended) - Best for cards with text and clear graphics

  • JPG - Works well for photos or illustrations

  • Other formats - Most common image formats are supported

Planning Your Grid

For Small Decks (under 20 cards):

  • Use a smaller grid like 4×3 or 5×4

  • This makes it easier to see all cards in the preview

  • Faster generation time

For Medium Decks (20-69 cards):

  • Use the maximum 10×7 grid

  • Fits everything on one sheet

  • Most efficient layout

For Large Decks (70+ cards):

  • Still use 10×7 for maximum efficiency

  • Multiple sheets will be created automatically

  • Each sheet includes the card back

Using Your Generated Sheets in Tabletop Simulator

  1. Import the sheet:

    • In TTS, go to Objects → Components → Custom → Deck

    • Click "Side Deck" and select your PNG file

    • TTS will automatically detect the grid layout

  2. Configure the deck:

    • Set the number of rows and columns to match your grid

    • TTS will create individual cards from the sheet

  3. For multiple sheets:

    • Import each sheet separately

    • Create separate deck objects, or

    • Combine them in TTS if needed

Pro Tip: The tool uses standard TTS card dimensions, so your cards will work perfectly without any additional configuration!

Common Use Cases

Creating a Standard 52-Card Deck

  1. Set grid to 10 columns × 7 rows (or smaller like 10×6)

  2. Upload 52 front card images

  3. Upload 1 back card image last

  4. Generate - you'll get 1 sheet with all cards

Creating a Large Custom Deck (100+ cards)

  1. Set grid to 10 columns × 7 rows (maximum)

  2. Upload all front card images

  3. Upload 1 back card image last

  4. Generate - you'll get multiple sheets automatically

  5. Import each sheet into TTS separately

Creating a Small Prototype Deck (10-15 cards)

  1. Set grid to 4 columns × 4 rows (16 slots = 15 cards + 1 back)

  2. Upload your front card images

  3. Upload 1 back card image last

  4. Generate - you'll get 1 compact sheet

Troubleshooting

Preview shows "Upload cards to see a preview":

  • Make sure you've uploaded at least one card image

  • Check that the file upload completed successfully

  • Try refreshing the page if upload seems stuck

Cards don't appear in the preview:

  • Verify your images are valid image files

  • Check that files aren't corrupted

  • Try uploading a smaller batch first to test

Generated sheets look wrong:

  • Check your grid settings match what you expected

  • Verify you uploaded the correct number of images

  • Make sure the last image is your card back design

Multiple sheets were generated unexpectedly:

  • This is normal if you have more cards than fit in one grid

  • Check the grid capacity: (rows × columns - 1) for front cards

  • Reduce rows/columns if you want fewer cards per sheet

Downloaded files are missing:

  • Check your browser's download settings

  • Look in your default download folder

  • Some browsers may ask for permission to download multiple files

The card back isn't working in TTS:

  • Make sure you uploaded the back card image last

  • In TTS, the hidden card should be in the bottom-right slot

  • Verify the grid settings in TTS match your grid settings

Advanced Tips

Organizing Large Decks

If you have a very large deck (200+ cards), consider:

  • Batch processing - Create multiple smaller decks if needed

  • Category sheets - Create separate sheets for different card types

  • Naming convention - Use clear filenames to track which cards go where

Optimizing Image Quality

  • Resolution - Cards will be resized, but starting with good quality helps

  • File size - PNG files can be large; consider compression if needed

  • Consistency - Keep card designs consistent for best visual results

Working with Multiple Decks

If you're creating multiple decks:

  • Generate each deck separately

  • Use descriptive filenames when saving

  • Keep track of which sheet belongs to which deck

Need More Help?

If you encounter issues:

  • Check that all images uploaded successfully

  • Verify your grid settings are within limits (2-10 columns, 2-7 rows)

  • Make sure you have at least one card image uploaded

  • Try with a smaller set of images first to test

  • Contact support if you need assistance with specific requirements

Ready to Create Your Deck?

You're all set! The TTS Deck Editor makes it simple to go from individual card images to ready-to-use Tabletop Simulator decks. Upload your cards, configure your grid, preview your sheets, and generate—it's that easy! 🎮

Did this answer your question?