Tiled Export
Export tilesets for the Tiled map editor with JSON format, Wang tiles, and dual-grid support.
Overview
Export your pixel art tilesets from spritesynth in a format compatible with the Tiled map editor. The export includes tileset JSON and image references for seamless import.
Export Process
Via Editor
- Open your tileset in the editor
- Click Export → Tiled
- Choose tileset type (top-down, sidescroller, isometric)
- Configure tile size and export options
- Download the export ZIP
Via API
curl -X GET https://api.spritesynth.dev/api/exports/tilesets/{id} \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"engine": "tiled",
"tile_size": 16,
"format": "json"
}'Export Contents
The export ZIP contains:
tileset_tiled_export/
├── tileset.json # Tiled tileset definition
├── tileset.png # Tileset image
└── README.md # Import instructionsImporting into Tiled
- Open Tiled map editor
- Go to Map → New Tileset
- Click Browse and select the
tileset.pngimage - Set tile width and height to match your export (default 16px)
- The tileset is ready to use in your map
Tileset JSON
The JSON file follows Tiled's native tileset format:
{
"columns": 8,
"image": "tileset.png",
"imageheight": 128,
"imagewidth": 128,
"margin": 0,
"name": "spritesynth_tileset",
"spacing": 0,
"tileheight": 16,
"tilewidth": 16,
"tilecount": 64,
"type": "orthogonal"
}Tileset Types
Top-Down
Standard overhead view tilesets. Compatible with Tiled's default orthogonal maps.
- Walkable terrain, walls, objects
- Best for RPGs, strategy games
Sidescroller
Side-view tilesets for platformer games.
- Platforms, backgrounds, foregrounds
- Best for platformers, side-scrolling adventures
Isometric
Diamond-shaped tiles for isometric maps.
- Isometric grid layouts
- Best for simulation, strategy games
Advanced Features
Wang Tiles
Export supports Wang tilesets for terrain blending:
- Corner and edge Wang sets
- Auto-tiling in Tiled
- Seamless terrain transitions
Dual-Grid
Dual-grid tileset support for:
- More flexible terrain transitions
- Reduced tile count compared to Wang sets
- Compatible with Tiled's latest features
3x3 Tileset Format
Compact 3x3 tileset format for:
- Minimal tile sets with maximum variation
- Efficient memory usage
- Quick auto-tiling setup
Sprite Fusion Compatibility
Exports are compatible with Sprite Fusion:
- Import sprite sheets directly
- Matching tile conventions
- Seamless workflow between spritesynth and Sprite Fusion
Tips
- Keep tile sizes consistent (16x16 or 32x32 recommended)
- Leave 1px margin between tiles to prevent texture bleeding
- Use power-of-two image dimensions for best performance
- Label tile groups in spritesynth for easier import organization
Need help?
Join our Discord community for support and tips.
Was this page helpful?