Game Assets Maker

视频 → 透明游戏动画，三步搞定。

Video → game-ready animation, in three steps.

下载 / Download · 官网 / Website · GAM Skills · 反馈 / Issues

中文 · English

同一组真实动画帧，去背景前后同步播放，10 FPS 循环预览。 / The same animation frames before and after background removal, playing in sync at 10 FPS.

---

中文

Game Assets Maker（GAM）是一款开源桌面工具，面向独立游戏开发者，将视频处理为透明 PNG 动画帧序列。已有视频可以直接开始；需要创作新角色或动作时，也可以使用内置的 AI 图片 / 视频生成。

本地抽帧、去背景、对齐和裁剪免费，无需登录或购买积分。AI 生成按所选服务计费。

下载安装 · 使用说明 · Agent 与 Godot · 常见问题 · 开发与部署

实际能做什么

• 视频变动画帧：抽帧 → 去背景 → 挖孔与对齐，逐步预览结果。
• 批量裁剪：统一包围盒，或逐帧紧致裁剪并保存偏移 JSON。
• 细节修整：描边、孤立像素清理、边缘优化、颜色替换；支持隐藏异常帧。
• 角色与动作管理：按角色整理待机、行走、跳跃、攻击等动画，保存每步参数。
• 可选 AI 创作：Seedream 图片生成与 Seedance 视频生成，支持 ForFuner AI 或自定义火山方舟 Key。
• Agent 协作与 Godot 4：通过 GAM Skills 编写提示词、操作客户端，并将帧序列、偏移和音效导入 Godot 4。

下载安装

普通用户下载安装包即可，不需要安装 Python、Node.js 或克隆源码。

前往 最新 Release，在 Assets 中选择对应系统的安装包；此入口会随正式版本更新。

系统	下载	安装方式
Windows x64	最新版 EXE 安装包	在 Assets 中下载 windows-x64-Setup.exe 结尾的文件并运行；缺少 WebView2 时按提示联网安装。
macOS Apple Silicon（ARM64）	最新版 DMG 安装包	在 Assets 中下载 macos-arm64.dmg 结尾的文件，打开后将应用拖入 Applications。

目前未提供 Intel Mac 或 Linux 安装包。macOS 包尚未签名或公证；若系统阻止打开，请按包内安装说明，在“系统设置 → 隐私与安全性”中选择“仍要打开”。校验文件 .sha256 见 Release 附件。

使用说明

1. 准备素材

打开 GAM，在动画库创建角色 / 动作项目并导入视频。建议第一次先用一段短动作，走通流程后再批量制作。

去背流程支持以任意单一底色为主的背景，并容忍轻微不均匀。 背景颜色从原始帧边缘自动采样；角色用色应与背景明显区分，相近颜色仍可能被误删。先检查素材背景、角色轮廓和动作完整性。

没有视频时，可先在“图片生成”准备角色图，再在“视频生成”中以角色图为首帧生成动作视频；AI 配置见下方说明。

2. 三步处理

步骤	怎么操作	重点检查
01 帧提取	选择起止帧、帧提取间隔，点击“开始提取”。	起势和收招是否完整，循环是否顺畅。
02 背景移除	首次按提示选择来源并下载 U2Net 模型（约 176 MB），再运行去背景。	头发、武器、细线和半透明边缘。
03 挖孔与对齐	清理手臂、武器之间的残留背景色；按动作需要启用水平居中或底部对齐。	是否误删主体绿色、跳跃高度或有意位移是否被改变。

每步完成后先播放检查。步骤 02 / 03 可隐藏异常帧，也可恢复；重新抽帧会使下游旧处理结果失效。模型就绪后，本地处理可以离线进行。

步骤 02 完成后，切换到步骤 03 页面即可点击 预览右下角的魔棒或橡皮擦，自动暂停并在当前预览中修整，无需先运行步骤 03；顶部显示工具参数，预览窗内显示简要操作提示。魔棒点击选区、Shift 点击追加、Delete 删除；橡皮擦用左键拖动擦除。滚轮缩放、中键拖动画布，空格仍控制播放。保留当前预览背景、缩放和平移，背景仍可切换。点击“保存当前帧”后标记为已完成处理，动画卡片的第三个状态图标变绿，并保持工具选中，撤销记录以此次保存为起点；切回浏览工具保留未保存修改。播放、切帧、切步骤或离开页面前，未保存修改会提示保存、放弃或留在当前帧。取消丢弃本次未保存修改。修整只修改步骤 03 的这一帧，重新运行步骤 03 会覆盖修整。W / E / V 分别切换魔棒、橡皮擦和移动工具；选中魔棒或橡皮擦时，⌘S / Ctrl+S 保存当前帧；+ / - 调整当前工具的颜色容差或橡皮擦大小。橡皮擦默认大小 5px、羽化 0px；魔棒删除会完全清除选区，并向选区外侧羽化；羽化为 0 时仅清除选区。工具栏的“恢复初始版本”会恢复本轮人工修整前的当前帧（未运行步骤 03 时以步骤 02 结果为基准），跨保存和重启保留；恢复可撤销，点击保存才写入结果。旧备份没有步骤标记、无法确认初始版本时，恢复按钮会禁用并提示重新处理步骤 03。

3. 裁剪与导出

在“批量裁剪”中选择动画：

• 统一包围盒：各帧使用相同画布尺寸，便于直接播放帧序列。
• 逐帧紧致裁剪：缩小每帧透明边缘，同时保存 _frame_data.json；导入引擎时应保留偏移，避免角色抖动。

完成后从结果页打开输出目录，取得 PNG 帧序列及相关 JSON。有音效时间线时一并保留 _audio_timeline.json 与音频文件。Godot 4 导入可使用下方的 gam-export Skill；其他引擎需自行配置帧序列与偏移。

可选：配置 AI 生成

方式	准备	费用来源
ForFuner AI	在 GAM 注册并登录，在生成页面选择 ForFuner AI。	平台积分；提交前查看当前预计消耗。
自定义 Key	在火山方舟开通对应模型，在 GAM 设置中填写并保存自己的 API Key。	自己的火山账户，以官方用量和账单为准。

两种方式分别鉴权和结算。仅做本地处理无需配置；Key 连接检查通过不代表每个模型都已开通。模型、规格和费用以当前生成页面及服务方信息为准。

忘记 ForFuner AI 密码时，可在登录页点击「忘记密码？」，通过邮箱验证码重置。

Agent 与 Godot

六个 GAM Skills 可帮助 Agent 编写提示词、操作客户端、处理素材，并将动画导入 Godot 4。安装工具需要 Node.js/npm；选择对应命令安装全部六个 Skills：

# Codex
npx skills add hyhy111/gam-skills -g -a codex --skill "*"

# Claude Code
npx skills add hyhy111/gam-skills -g -a claude-code --skill "*"

# 自动检测并选择其他 Agent
npx skills add hyhy111/gam-skills -g --skill "*"

Skill	用途
gam-pic-prompt	编写角色图片提示词，明确视角与画风。
gam-video-prompt	根据角色图编写待机、行走、攻击等动作提示词。
gam-workflow	安排素材制作步骤，检查结果并继续处理。
gam-guide	查询功能、参数及账号与 API Key 配置。
gam-cli	通过 gam-agent 填写草稿、查询任务和操作客户端。
gam-export	将 PNG 动画帧、裁剪偏移和音效导入 Godot 4。

也可以在 GAM「设置 → GAM Skills 安装」中选择工具并一键安装，需要 Node.js 22.20 或更新版本及 npm。通过 npx skills 安装后，可选择对应工具并点击「检查更新」。有新版本时点击「更新」即可。启动时检测到更新，首页的 Skills 入口会显示黄色小角标，点击可进入对应工具的安装设置。手动复制、Git 克隆或其他工具管理的同名 Skills 请通过原安装方式维护。

安装后可直接描述需求，例如“用 gam-pic-prompt，帮我写一个侧视剑士的图片提示词”，或“用 gam-export，把这个素材目录导入我的 Godot 4 项目”。

操作客户端前请先安装并打开 GAM，并允许 Agent 访问本地文件和执行命令。安装包自带 gam-agent，固定入口见 开发与打包。gam-export 另需 Python 3.10+，仅依赖标准库；导出时提供素材目录和 Godot 4 项目目录。本地素材处理无需登录，在线 AI 生成使用客户端中的账号或自定义 Key 配置。更多 Agent 的安装选项见 Skills CLI 支持列表。

常见问题

必须使用 AI 或登录吗？ 不需要。已有视频可直接进入本地流程，下载好背景模型后可离线处理。

项目和模型存在哪里？ 安装版默认使用用户目录 ~/.gam（Windows 为 %USERPROFILE%\.gam）；项目和 AI 缓存目录可在设置中调整。更新前退出应用，再覆盖安装。

能直接导出 Godot 场景吗？ 通过独立的 gam-export Skill 导入 Godot 4。它读取 GAM 的裁剪结果、逐帧偏移与音效，并生成资源和预览场景；这一步需要 Agent 与 Godot 项目目录。

去背后有残绿、缺边或动画抖动？ 先检查源素材是否为单色背景、主体用色是否与背景分离，再检查背景色容差、去背景参数和对齐开关。逐帧裁剪结果导入引擎时应应用偏移，不能只加载 PNG。

重命名、默认模型和更新提示的详细行为见 使用参考。模型下载与路径见 MODELS.md。遇到问题请到 Issues 提供应用版本、系统 / 架构、操作步骤与脱敏截图。

开发与部署

源码开发、测试、模型准备、CLI、安装包构建和 Skills 子模块维护见 DEVELOPMENT.md，贡献规范见 CONTRIBUTING.md。

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗