spritecook-generate-tilesets

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SpriteCook Generate Tilesets

SpriteCook 瓦片集生成

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.

本技能用于SpriteCook瓦片集生成。搭配

spritecook-workflow-essentials

使用，可实现积分管理、清单维护、安全下载和资产追踪功能。

要求： 编辑器需连接SpriteCook MCP服务器。可通过

npx spritecook-mcp setup

进行设置，或查看spritecook.ai。

Tools

工具

list_tileset_options

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_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.

Parameter	Type	Default	Description
`prompt`	string	required	Terrain/material request, e.g. `mossy dungeon floor`
`style_mode`	string	`pixel`	`pixel` or `detailed`
`perspective`	string	`topdown`	`topdown` , `platformer` , or `isometric`
`piece_set`	string	registry default	`15-piece` , `17-piece-base` , `autotile-16-set` , `isometric-3x5-32` , or `isometric-2x4-64`
`tile_size`	int	registry default	Final tile size in pixels
`elevation`	string	registry default	`no-elevation` or `minimal` where supported
`edges`	string	`transparent`	`transparent` or `two_surfaces` ; `two_surfaces` only works for 15-piece top-down
`variations`	int	`1`	Number of variations, 1-4
`model`	string	null	Optional model override. Omit to use SpriteCook's tileset default
`colors`	string[]	null	Optional hex color guidance, max 64
`force_enabled`	bool	`false`	Force the output toward `force_colors`
`force_colors`	string[]	null	Optional forced hex palette, max 64
`reference_asset_id`	string	null	Existing tileset asset to use as source/reference; tileset settings are inherited
`edit_asset_id`	string	null	Existing tileset asset to edit; tileset settings are inherited
`style_asset_id`	string	null	Existing asset to use as visual style guide only
`wait_seconds`	int	0	Optional bounded wait from 0-90 seconds before returning the polling contract

reference_asset_id

and

edit_asset_id

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

生成可直接用于游戏的瓦片集。默认情况下，该工具会立即返回一个任务；请按照返回的

poll.tool

和

poll.arguments

进行轮询，直到标准

assets

条目准备完成。

参数	类型	默认值	说明
`prompt`	string	必填	地形/材质需求，例如 `mossy dungeon floor`
`style_mode`	string	`pixel`	`pixel` 或 `detailed`
`perspective`	string	`topdown`	`topdown` 、 `platformer` 或 `isometric`
`piece_set`	string	注册表默认值	`15-piece` 、 `17-piece-base` 、 `autotile-16-set` 、 `isometric-3x5-32` 或 `isometric-2x4-64`
`tile_size`	int	注册表默认值	最终瓦片尺寸（像素）
`elevation`	string	注册表默认值	支持的情况下可选 `no-elevation` 或 `minimal`
`edges`	string	`transparent`	`transparent` 或 `two_surfaces` ； `two_surfaces` 仅适用于15组件的俯视瓦片
`variations`	int	`1`	变体数量，范围1-4
`model`	string	null	可选模型覆盖参数。省略则使用SpriteCook的瓦片集默认模型
`colors`	string[]	null	可选十六进制颜色参考，最多64种
`force_enabled`	bool	`false`	强制输出向 `force_colors` 靠拢
`force_colors`	string[]	null	可选强制十六进制调色板，最多64种
`reference_asset_id`	string	null	用作源/参考的现有瓦片集资产；瓦片集设置将被继承
`edit_asset_id`	string	null	待编辑的现有瓦片集资产；瓦片集设置将被继承
`style_asset_id`	string	null	仅用作视觉风格指南的现有资产
`wait_seconds`	int	0	返回轮询协议前的可选等待时长，范围0-90秒

reference_asset_id

和

edit_asset_id

不可同时使用。引用的资产必须属于SpriteCook账户。

Recommended Defaults

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.

当用户要求使用已保存的瓦片集预设时，先调用
```
list_presets(mode="tileset", query=...)
```
和
```
get_preset_settings
```
，然后将返回的瓦片集设置映射到
```
generate_tileset
```
中。
如果用户提供本地图片文件路径，先调用
```
spritecook-upload-assets
```
，然后将返回的资产ID作为
```
reference_asset_id
```
、
```
edit_asset_id
```
或
```
style_asset_id
```
传入。
如果用户提供小型数据URL或原始base64值，先调用
```
import_asset
```
，然后将返回的资产ID作为
```
reference_asset_id
```
、
```
edit_asset_id
```
或
```
style_asset_id
```
传入。
当需要基于现有瓦片集引导新生成并保留其瓦片尺寸/布局时，使用
```
reference_asset_id
```
。
当用户想要直接修改现有瓦片集时，使用
```
edit_asset_id
```
。
当图片仅需影响视觉风格、调色板、比例和渲染，而不影响瓦片集布局时，使用
```
style_asset_id
```
作为风格指南图片。除非用户要求强调特定细节，否则提示语无需重复说明该图片是风格指南。
引用或编辑瓦片集时，请勿更改
```
style_mode
```
、
```
perspective
```
、
```
piece_set
```
、
```
tile_size
```
或
```
elevation
```
；SpriteCook会继承并锁定这些设置。

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.

提示语应简洁且聚焦于材质：例如

snowy stone path

、

muddy swamp grass

、

volcanic rock

、

clean wooden floor

。

对于单表面瓦片集，仅命名一种主要材质。
对于
```
two_surfaces
```
，需清晰命名两种表面：例如
```
grass and water
```
、
```
volcanic rock and lava
```
。
请勿在瓦片集中要求添加标签、UI界面、角色、道具或场景构图。

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.

使用
```
check_job_status
```
按照返回的轮询协议进行检查，直到任务进入终止状态。
将每个返回的
```
asset_id
```
保存到项目清单或任务笔记中。
使用
```
sprite_url
```
作为可下载瓦片集图像的标准链接。
将
```
url
```
、
```
pixel_url
```
和
```
raw_url
```
视为兼容性别名。
如果成功响应包含
```
warning.code="asset_output_unavailable"
```
，请执行提供的
```
warning.recovery
```
工具调用。