spritecook-generate-tilesets

SpriteCook 瓦片集生成

使用此技能生成 SpriteCook 瓦片集。将其与 spritecook-workflow-essentials 搭配使用，以了解点数、清单、安全下载和素材追踪。

需要： 已连接的 SpriteCook MCP 服务。如果未连接，请说明需要建立连接，并在获得授权时使用宿主的原生连接流程。请勿在美术任务中安装软件或更改身份验证设置。

工具

list_tileset_options

需要了解当前支持的视角、组成块集合、瓦片尺寸、高度、边缘模式、输出尺寸或默认值时，请调用此工具。

generate_tileset

生成可用于游戏的瓦片集。默认情况下，此工具会立即返回一个任务；请按照返回的 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-piece 俯视视角
variations	int	1	变化版本数量，1-4
model	string	null	可选的模型覆盖值。省略时使用 SpriteCook 的瓦片集默认模型
colors	string[]	null	可选的十六进制颜色参考，最多 64 种
force_enabled	bool	false	强制输出倾向于使用 force_colors
force_colors	string[]	null	可选的强制十六进制调色板，最多 64 种
project_id	string	null	要放入瓦片集的自有项目
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 账户。

建议的默认值

• 对于俯视像素自动拼接瓦片，建议从 style_mode="pixel"、perspective="topdown"、piece_set="15-piece"、tile_size=32、edges="transparent" 开始。
• 对于俯视内角基础瓦片，请使用 piece_set="17-piece-base"，并保持 edges="transparent"。
• 对于侧视平台游戏，请使用 perspective="platformer"、piece_set="autotile-16-set"、edges="transparent"。
• 对于精细的俯视瓦片集，请使用 style_mode="detailed"，并在选择尺寸／高度前调用 list_tileset_options。
• 仅当用户明确想比较模型时才使用 model。

参考工作流

• 当用户要求使用已保存的图块集预设时，先使用 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 会继承并锁定这些设置。
• edges 不会被继承。当源图块集是 two_surfaces 集时，每次编辑或参考生成都要再次传入 edges="two_surfaces"；否则请求会回退到 transparent。
• 编辑和参考生成会跳过新生成时使用的布局参考网格，因此更容易失败或生成无法拼接的图块。编辑可能会因 tileset_unusable 而失败；积分会退还。编辑连续失败两次时，请将该图块集作为 reference_asset_id 生成，或使用更清晰的提示词重新开始，不要重复尝试相同的编辑。

提示词

• 提示词应简短，并聚焦于材质：snowy stone path、muddy swamp grass、volcanic rock、clean wooden floor。
• 对于单表面图块集，请指定一种主要材质。
• 对于 two_surfaces，请明确指定两种表面：grass and water、volcanic rock and lava。
• 避免要求在图块集中加入标签、UI、角色、道具或场景构图。

输出处理

• 在 generate_tileset 中传入 wait_seconds=90；大多数图块集会在此时间内完成，因此通常无需轮询。否则，请按照返回的轮询约定使用 check_job_status，直到任务进入终止状态。
• 使用前检查每个变体。大约三分之一的变体可能存在完整内部图块无法无缝拼接的问题（相对边缘的亮度不同），或图块无法严密衔接，而响应不会标记这些问题。比较完整图块的左右边缘和上下边缘；对于 15-piece 集，使用 spritecook-use-dual-grid-tilesets 绘制一张小型测试地图。无法无缝拼接的完整图块会在大面积区域显示为棋盘格。选择干净的变体或重新生成。
• 15-piece 集的对角线会保留网格的阶梯状轮廓。海岸线边缘会较柔和，但对角海岸线仍会呈现阶梯状。
• 将每个返回的 asset_id 保存到项目清单或任务备注中。
• 使用 sprite_url 作为规范的可下载图块集图片。
• 将 url、pixel_url 和 raw_url 视为兼容性别名。
• 如果成功响应包含 warning.code="asset_output_unavailable"，请执行提供的 warning.recovery 工具调用。