S
spritesynthDOCS

Creating Tilesets & Maps

Generate tilesets for top-down, sidescroller, and isometric games and import them into Tiled.

Overview

spritesynth generates tilesets optimized for real game engines. Choose your perspective, set the tile size, and get a complete set of tiles ready for level design.

Top-down dungeon tileset generated with spritesynth

A top-down dungeon tileset — floor variants, walls, doors, and decorative elements.

Supported Perspectives

TypeUse CaseTypical Tile Size
Top-downRPGs, strategy, overhead views16×16 or 32×32
SidescrollerPlatformers, side-view games16×16 or 32×32
Isometric2.5D games, city builders64×32 (double-width)

Watch: Top-down, sidescroller, and isometric tilesets generated from similar prompts.

Step 1: Generate a Tileset

Describe what you need and specify the perspective:

curl -X POST https://api.spritesynth.com/v1/generations/tileset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "grass, dirt, stone, water tiles for a forest environment",
    "type": "top_down",
    "tile_size": 16
  }'

For sidescroller platformer tiles:

curl -X POST https://api.spritesynth.com/v1/generations/tileset \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "platformer tiles, grass tops, dirt fill, rock platforms",
    "type": "sidescroller",
    "tile_size": 16
  }'

Step 2: Review and Refine

Once generated, open the tileset in the editor to:

  • Check tile edge continuity
  • Adjust colors for palette consistency
  • Remove or replace tiles that don't fit
  • Add custom tiles to fill gaps

Tileset in the editor — individual tiles visible in the layer panel

Reviewing a generated tileset in the editor — each tile is a separate layer for easy editing.

Step 3: Export for Your Engine

Export the tileset as a ZIP with sprite sheets and engine-specific metadata:

curl -o tileset-export.zip https://api.spritesynth.com/v1/tilesets/{tileset_id}/export \
  -H "Authorization: Bearer YOUR_API_KEY"

The ZIP contains tile images, a metadata.json with tile indices and dimensions, and engine-specific import files.

Tiled (JSON Format)

Export the tileset as a Tiled-compatible JSON file with tile indices and image references. Import directly into Tiled's tileset editor.

Tiled editor with spritesynth tileset imported

Tiled editor with a spritesynth-generated tileset — drag and drop to start building levels.

Unity

Export includes a sprite sheet and a metadata JSON file compatible with Unity's sprite importer. Drag the sprite sheet into your Assets folder and Unity auto-slices it.

Godot

Export includes sprite sheets and .tres resource files ready for Godot's tilemap system.

Tips

  • Consistent lighting — Specify "top-left lighting" in your prompt to keep shadows consistent across tiles.
  • Tile size matters — Match your game engine's grid exactly. Common sizes: 16×16, 32×32, 48×48, 64×64.
  • Generate tiles separately — For maximum control, generate each tile type (grass, water, stone) as its own asset, then assemble in the editor.

Comparing two tileset approaches: batch vs individual

Left: batch-generated tileset. Right: individually generated tiles assembled in the editor.

Need help?

Join our Discord community for support and tips.

Was this page helpful?

On this page