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:
Upload 69 front card images (for a 10×7 grid)
Upload 1 back card image as the last file
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:
Click the "Generate PNGs" button in the top right corner
Watch the progress indicator - it shows "Generating (1/3)" for example
Your browser will automatically download each sheet as a separate PNG file
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
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
Configure the deck:
Set the number of rows and columns to match your grid
TTS will create individual cards from the sheet
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
Set grid to 10 columns × 7 rows (or smaller like 10×6)
Upload 52 front card images
Upload 1 back card image last
Generate - you'll get 1 sheet with all cards
Creating a Large Custom Deck (100+ cards)
Set grid to 10 columns × 7 rows (maximum)
Upload all front card images
Upload 1 back card image last
Generate - you'll get multiple sheets automatically
Import each sheet into TTS separately
Creating a Small Prototype Deck (10-15 cards)
Set grid to 4 columns × 4 rows (16 slots = 15 cards + 1 back)
Upload your front card images
Upload 1 back card image last
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! 🎮
