NO6KIKO/gorest-2d-animation-spritesheet-generator

Gorest 2D 动画精灵图集生成器

是什么 – 一个开源的基于网页的编辑器，用于构建 2D 游戏场景并生成动画就绪的精灵图集。该工具没有传统意义上的图形用户界面；您通过描述所需内容（或拖拽资产）来工作，本地的 Codex 驱动代理会自动更新项目文件。它能够生成、导入和编辑精灵图集，附加元数据（动作名称、方向、循环模式、触发器等），并直接在浏览器中预览结果。

为何重要 – 创建 2D 游戏资源通常涉及手动流程（绘制帧 → 组装图集 → 添加元数据 → 导入游戏引擎）。Gorest 自动化了这一循环：向 Codex 输入一个提示即可创建完整的透明 PNG 精灵图集，应用程序立即显示播放预览，您无需离开浏览器即可调整图层顺序、场景构图和交互数据。它还支持“伪 3D”查看器，可旋转预渲染的精灵图集，营造出 3D 物体的错觉。

主要功能

• 场景构图器 – 自由形式画布，可将背景、角色、道具、UI 元素和动画精灵作为独立图层放置。
• 精灵图集页面 – 列出当前场景中使用的所有图集，支持预览、下载和编辑单个片段的元数据。
• Codex 辅助工作流 – 输入自然语言提示（例如 “生成一个 16 帧的金鱼缸精灵图集”），本地代理会自动创建或更新资产。
• 元数据丰富的资产 – 每个片段存储角色、片段名称、触发类型/值、游戏状态、方向、循环模式、标签，以及可选的 viewMode（用于伪 3D 旋转器）。
• 伪 3D 物体旋转 – 将精灵图集视作可配置方位角/仰角帧、灵敏度和自动旋转的转盘。
• 本地优先存储 – 所有生成的 PNG 文件和 game_asset_library.json 均保存在 public/generated/ 目录下，使原型完全自包含。
• 键盘快捷键 – 支持标准的复制/粘贴、撤销/重做、复制、删除等快捷键，实现快速场景编辑。
• 可部署 – 开发使用 npm run dev，生产环境使用 npm run build + npm start。

典型使用场景

1. 快速原型设计 – 设计师可以绘制横版过关关卡，放入动画道具，无需导出到独立引擎即可查看游戏效果。
2. AI 增强的资产创建 – 艺术家可以描述角色或道具，让 Codex 生成完整精灵图集，然后在应用内微调。
3. 可复用的资产库 – 一旦精灵或道具保存，即可拖入任意未来场景，保留其元数据以支持游戏逻辑。
4. 教育演示 – 教师可以展示 2D 动画流程以及 LLM 驱动的代理如何自动化重复步骤。

快速上手

# 1. 安装 Node.js 20+
# 2. 克隆仓库
git clone https://github.com/NO6KIKO/gorest-2d-animation-spritesheet-generator.git
cd gorest-2d-animation-spritesheet-generator

# 3. 安装依赖
npm install

# 4. 本地运行
npm run dev   # 打开 http://localhost:3000（或设置 PORT）

应用程序完全在本地运行；除非后续启用云图像生成服务，否则无需 API 密钥。

许可证 – 代码采用 MIT 许可证发布。媒体资产（精灵图集、背景、演示图像）仅用于预览，不采用 MIT 许可证；具体条款请参见 public/ASSET_LICENSE.md。

---

以上所有信息均直接取自仓库的 README，未推断任何额外功能。