🎮 Pixel Asset Pipeline

AI 生成像素游戏素材 → 自动处理为 Godot 可用格式。

Pipeline 概览

Prompt → AI生图(Seedream) → 去背景 → 切帧 → NEAREST缩放 → Godot sprite sheet + 单帧PNG

依赖

• - Python 3.8+ with Pillow (pip install Pillow)

Quick Start

bash

1. 处理已有的大图

2. 批量生成+处理

支持的生成后端

输出格式

• - {name}spritesheet.png — 横排 sprite sheet，Godot 设置 hframes=N 即可
• frames/{name}frame00.png ~ frame_XX.png — 单帧透明 PNG

Prompt 技巧

像素风 prompt 模板（英文效果最佳）：

16-bit pixel art sprite sheet, [角色/物品描述], top-down RPG, [N] frames, white background, clean outline, no shading

示例：

• - 角色：16-bit pixel art sprite sheet, green slime monster, top-down RPG, 4 frames idle animation, white background
• 物品：pixel art, silver sword with blue glow, 16x16 icon, white background, game asset
• 瓦片：pixel art tileset, grass and dirt path, top-down RPG, seamless tiles, white background

关键后缀：加 white background 或 black background 确保可去背景。

完整使用示例

1. 1. 用 Seedream 生成：

1. 2. 处理为 Godot 素材：

1. 3. 在 Godot 中：Texture2D → Hframes = 4，搞定。

scripts/

• - processspritesheet.py — 单图处理（去背景→切帧→缩放→输出）
• batch_generate.py — 批量生成+处理（读JSON配置）