SuperAPI AI 工具集

spritecook-generate-tilesets

设计与创作

查看项目

更新于 10-16 09:31

技能介绍

用途:这是 SpriteCook 的瓦片集(tileset)生成技能,用于通过 SpriteCook MCP 工具生成可直接用于游戏的 autotile 瓦片集。需与 spritecook-workflow-essentials 配合,以处理积分、清单、安全下载与素材追踪。使用前提是编辑器已连接 SpriteCook MCP 服务器,可用 npx spritecook-mcp setup 配置,或参见 spritecook.ai。

主要能力:list_tileset_options 查询当前支持的视角、拼块集、瓦片尺寸、高度、边缘模式、输出尺寸与默认值;generate_tileset 生成瓦片集,默认立即返回任务,需按返回的 poll.tool 与 poll.arguments 轮询,直到 canonical assets 就绪。参数包括 prompt(必填,地形/材质描述)、style_mode(pixel 或 detailed)、perspective(topdown、platformer、isometric)、piece_set(15-piece、17-piece-base、autotile-16-set、isometric-3x5-32、isometric-2x4-64)、tile_size、elevation、edges(transparent 或 two_surfaces,后者仅支持 15-piece 俯视)、variations(1-4)、model、colors、force_enabled、force_colors、reference_asset_id、edit_asset_id、style_asset_id、wait_seconds(0-90)。reference_asset_id 与 edit_asset_id 互斥,引用素材须属于该 SpriteCook 账户。

推荐默认:俯视像素 autotile 用 style_mode="pixel"、perspective="topdown"、piece_set="15-piece"、tile_size=32、edges="transparent";俯视内角基础瓦片用 piece_set="17-piece-base";侧视平台用 perspective="platformer"、piece_set="autotile-16-set";精细俯视用 style_mode="detailed" 并先调用 list_tileset_options。仅在用户明确想比较模型时使用 model。

使用方式:使用已保存预设时,先 list_presets(mode="tileset", query=...) 与 get_preset_settings,再映射到 generate_tileset;本地图片先经 spritecook-upload-assets,小 data URL 或 base64 先 import_asset,再传回 asset ID。reference_asset_id 用于保留原尺寸/布局引导新生成,edit_asset_id 用于直接修改,style_asset_id 仅作视觉风格参考。引用或编辑时不要更改 style_mode、perspective、piece_set、tile_size、elevation,这些会被继承并锁定。

提示词:保持简短、聚焦材质,如 snowy stone path、muddy swamp grass;单表面只写一种主材质,two_surfaces 需写清两种表面;避免在瓦片集中要求标签、UI、角色、道具或场景构图。

输出处理:按轮询契约用 check_job_status 直到终态;保存每个 asset_id 到项目清单;sprite_url 为规范可下载图像,url、pixel_url、raw_url 为兼容别名;若成功响应含 warning.code="asset_output_unavailable",执行提供的 warning.recovery 工具调用。

限制:需连接 MCP 服务器;引用素材须属同一账户;two_surfaces 仅限 15-piece 俯视;variations 上限 4,colors/force_colors 上限 64;其余平台、收费与效果信息暂未提供。