用途:在 game-designer 产出含 tilesetPalette 的 GDD 后,生成瓦片集 PNG 与清单元数据,可与 sprite-artist、bg-artist 并行运行。
主要能力:两种模式。默认 GPT Image 2 模式在存在 FAL_KEY 时,对每个非 SKY 瓦片调用一次 API,512×512 生成后缩至 32×32,得到鹅卵石、砖缝、草叶等真实像素纹理;程序化回退模式无密钥、免费,输出带 1 像素深色描边的纯色格子。两者生成的清单条目一致,下游 Preload 与 Game.js 无需区分。SKY 瓦片填纯品红 #FF00FF,由 Game.js 用 setAlpha(0) 隐藏以透出视差背景。
用法:调色板每项含 id、color、passable,可选 desc(作为 GPT 提示词,强烈建议提供);缺 desc 时按 id 查内置描述表,未命中则用 id 与颜色拼通用提示。核心函数为 src/lib/sprites.js 中的 generateTilesetGPT(),参数含 palette、outPath、tileSize、genre、tagline、quality、log,返回 { sheet, tileSize, ids }。也可用 scripts/paint_tiles.mjs <project-dir> 或 scripts/generate_tiles_gpt.mjs <project-dir> [--quality low]。依赖 sharp 与 FAL_KEY(环境变量或 ~/.all-skills/.env)。
输出:public/assets/tiles.png 为水平条带,(tileSize × numTiles) × tileSize 像素;清单 tiles 含 relSheet、tileSize、ids、passable,索引与关卡 tiles[][] 对应。
限制:GPT 模式每瓦片约 $0.01–0.05(低质量),调用失败则回退纯色不崩溃;无密钥时仅得程序化纯色。具体平台与更多配置资料未提供。