spritecook-generate-tilesets

SpriteCook Generate Tilesets

Use this skill for SpriteCook tileset generation. Pair it with spritecook-workflow-essentials for credits, manifests, safe downloads, and asset tracking.

Requires: SpriteCook MCP server connected to your editor. Set up with npx spritecook-mcp setup or see spritecook.ai.

Tools

list_tileset_options

Call this when you need current supported perspectives, piece sets, tile sizes, elevations, edge modes, output dimensions, or defaults.

generate_tileset

Generate a game-ready tileset. The tool returns a job immediately by default; follow the returned poll.tool and poll.arguments until canonical assets entries are ready.

reference_asset_id and edit_asset_id are mutually exclusive. The referenced asset must belong to the SpriteCook account.

Recommended Defaults

• For top-down pixel autotiles, start with style_mode="pixel", perspective="topdown", piece_set="15-piece", tile_size=32, edges="transparent".
• For top-down inner-corner base tiles, use piece_set="17-piece-base" and keep edges="transparent".
• For side-view platformers, use perspective="platformer", piece_set="autotile-16-set", edges="transparent".
• For detailed top-down tilesets, use style_mode="detailed" and call list_tileset_options before choosing size/elevation.
• Use model only when the user explicitly wants to compare models.

Reference Workflow

• When the user asks to use a saved tileset preset, use list_presets(mode="tileset", query=...) and get_preset_settings first, then map the returned tileset settings into generate_tileset.
• If the user has a local image file path, use spritecook-upload-assets first, then pass the returned asset ID as reference_asset_id, edit_asset_id, or style_asset_id.
• If the user supplies a small data URL or raw base64 value, call import_asset first, then pass the returned asset ID as reference_asset_id, edit_asset_id, or style_asset_id.
• Use reference_asset_id when the existing tileset should guide a new generation while preserving its tile size/layout.
• Use edit_asset_id when the user wants a direct change to an existing tileset.
• Use style_asset_id as a style guide image when the image should affect only visual style, palette, proportions, and rendering, not tileset layout. The prompt does not need to repeat that the image is a style guide unless the user asks to emphasize a specific detail.
• When referencing or editing a tileset, do not change style_mode, perspective, piece_set, tile_size, or elevation; SpriteCook inherits and locks those settings.

Prompting

• Keep prompts short and material-focused: snowy stone path, muddy swamp grass, volcanic rock, clean wooden floor.
• For single-surface tilesets, name one main material.
• For two_surfaces, name both surfaces clearly: grass and water, volcanic rock and lava.
• Avoid asking for labels, UI, characters, props, or scene composition inside the tileset.

Output Handling

• Follow the returned polling contract with check_job_status until the job reaches a terminal state.
• Save each returned asset_id in the project manifest or task notes.
• Use sprite_url as the canonical downloadable tileset image.
• Treat url, pixel_url, and raw_url as compatibility aliases.
• If a successful response contains warning.code="asset_output_unavailable", execute the supplied warning.recovery tool call.