Wombo icon

Wombo

Wombo 是一款本地运行的开源 AI 游戏资产工作室,可根据文本提示生成 2D 角色的正面、侧面和背面参考图、动画序列、精灵表、音效及音乐,并支持在本地项目中保存草稿、整理资产和保留历史版本,适合游戏开发者使用,方便持续查看和优化生成结果。

Wombo

面向 2D 游戏项目的 AI 生成资产

Wombo 是一款本地运行的 AI 游戏资产工作室,可根据文本提示创建 2D 角色、动画、声音和音乐。它以开源 GitHub 项目的形式提供,旨在支持需要生成资产的游戏开发工作流,而不是作为通用图像编辑器使用。

应用从命名角色开始,在使用这些参考图指导动画序列之前,先生成对齐的侧面、正面和背面参考图。生成的内容会保存到仓库之外的项目中,同时保留草稿和较早的资产版本,方便创作者随时查看并逐步优化输出。图像和视频生成使用 OpenRouter 路由,声音和音效生成则直接通过服务器使用 ElevenLabs。

主要功能

角色参考图生成

用文本描述角色,选择图像模型,并在透明的 1024×1024 画布上生成对齐的侧面、正面和背面参考图。

基于提示词创建动画

使用角色和动作提示词生成待机、行走或战斗等动画序列;如果所选视频模型支持,还可以选择性地提供起始图像和结束图像。

帧选择与精灵表

查看动画帧,选择包含或排除单个图块,并根据选定的帧集重新生成输出精灵表。

适用于游戏的 2D 输出

自动保存 PNG 精灵表和匹配的 Aseprite 动画,然后生成循环预览以供查看。

声音和音效生成

通过“声音与音效”工作流,根据提示词创建命名的声音和音乐,并直接从服务器使用 ElevenLabs。

本地项目与版本历史

在本地项目结构中整理角色、动画、声音、版本和项目元数据,并通过自动保存保留较早的版本。

实际使用场景

  • 制作可游玩的角色动画原型

    独立开发者可以描述角色,生成对齐的方向参考图,并将角色制作成命名的待机、行走、战斗或转身序列,无需手动组装每一帧。

  • 构建衔接的动画序列

    游戏团队可以使用已保存的姿势,以及较早动画中最后一个被纳入的帧来连接序列,例如从转身过渡到向新方向迈步。

  • 优化生成的动画资产

    创作者可以只选择生成帧中质量最好的部分,然后重新生成精灵表和 Aseprite 动画,再将资产导入游戏项目。

  • 维护本地游戏资产库

    项目可以将视觉资产与生成的声音和音乐放在一起,并保留每项资产的设置、当前文件和之前的版本,以便迭代。

  • 支持早期游戏原型开发

    探索 2.5D 或风格化游戏原型的团队可以使用该工作流制作临时角色、动画和音频资产,同时使用 Unity 和 Blender 等工具开发更完整的游戏。

Pros and Cons

Pros

  • 在一个面向项目的工作流中涵盖角色参考图、动画、精灵表、声音和音乐。
  • 自动导出 PNG 精灵表和 Aseprite 动画文件。
  • 在本地有序保留项目草稿、当前资产和较早生成的版本。
  • 在所选模型支持的情况下,可使用已保存的参考图和较早动画中的帧来保持姿势连续性。

Cons

  • 需要在本地配置 Node.js 20+、ffmpeg 和提供商 API 密钥。
  • 生成的角色和动画仍需检查一致性;文档特别建议检查不同参考视图中的人体结构和服装细节。
  • 不同提供商的模型能力各不相同,因此可用的起始图像和结束图像组合取决于所选视频模型。

FAQ

如何设置 Wombo?

Wombo 需要系统中安装 Node.js 20 或更高版本,并将 ffmpeg 添加到 PATH。使用 npm install 安装依赖后,将 .env.example 复制为 .env,添加所需工作流对应的提供商密钥,然后使用 npm run dev 启动本地应用。

Wombo 使用哪些 API 密钥?

角色和动画生成使用 OPENROUTER_API_KEY。声音和音效生成使用 ELEVENLABS_API_KEY,并直接从服务器调用。每个工作流只需要配置其提供商对应的密钥。

Wombo 会生成哪些文件?

角色参考图和动画输出会保存为 PNG 精灵表及匹配的 Aseprite 文件。生成的资产存储在项目目录中,JSON 清单会指向当前文件,同时保留之前生成的版本。

项目和生成的资产存储在哪里?

默认情况下,Wombo 会将项目和生成的资产存储在仓库之外的 ~/.ai-game-studio/ 中。你可以通过设置 AI_GAME_STUDIO_HOME 选择其他位置,应用会在安装期间创建存储目录。

Quick Facts

产品类型
开源 AI 游戏资产工作室
主要输出
角色参考图、PNG 精灵表、Aseprite 动画、声音和音乐
运行环境
本地开发环境
所需运行时
Node.js 20+ 和 ffmpeg
图像和视频提供商
OpenRouter
声音和音效提供商
ElevenLabs