SuperAPI AI 工具集

spritecook-generate-tilesets

设计与创作

查看项目

更新于 10-16 09:30

技能介绍

用途:在 SpriteCook 中生成游戏用瓦片集(tileset),需配合 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 账户。

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

参考工作流:使用已保存预设时先 list_presets(mode="tileset", query=...) 与 get_preset_settings;本地图片先经 spritecook-upload-assets,小 data URL 或 base64 先 import_asset,再传返回的 asset ID。引用或编辑瓦片集时不要更改 style_mode、perspective、piece_set、tile_size、elevation,SpriteCook 会继承并锁定这些设置。

提示词:保持简短、聚焦材质,如 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 俯视;引用素材须同账户;其余收费、价格、平台等信息暂未提供。