ZOYKUHot Board

hyhy111/game-assets-maker기술 문서

Turn videos into game-ready animation frames. Extract, remove backgrounds, align & trim locally; optional AI generation and Godot 4 skills.

언어 대체 안내:해당 저장소의 한국어 문서가 제공되지 않아 공식 영문 원본(English)으로 표시됩니다.
빠른 설치
pip install game-assets-maker

Game Assets Maker

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

Video → game-ready animation, in three steps.

Latest release License: MIT Platforms

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

中文 · English

Game Assets Maker:绿底视频帧与透明动画帧同步播放 / Synchronized source and transparent animation frames

同一组真实动画帧,去背景前后同步播放,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。


English

Game Assets Maker (GAM) is an open-source desktop tool for indie game developers. Turn videos into transparent PNG animation frames, or create new characters and motion with the optional built-in AI image / video generation.

Local extraction, background removal, alignment, and trimming are free and require no login or credits. AI generation is billed by the selected service.

Download · Usage · Agents and Godot · FAQ · Development

What you can make

  • Video to animation frames: extract → remove backgrounds → clean holes and align, with previews at each step.
  • Batch trim: use a shared bounding box, or tight per-frame crops with offset JSON.
  • Clean up details: outlines, isolated-pixel cleanup, edge optimization, color replacement, and reversible frame hiding.
  • Organize characters and actions: keep idle, walk, jump, and attack animations together with per-step settings.
  • Optional AI creation: Seedream images and Seedance videos, using ForFuner AI or your own Volcengine Ark key.
  • Agents and Godot 4: use GAM Skills for prompting, client control, and importing frames, offsets, and audio into Godot 4.

Download

Install the desktop app. No Python, Node.js, or source checkout is needed for normal use.

Open the latest release and choose the installer for your platform under Assets. This link follows new stable releases.

Platform Download Installation
Windows x64 Latest EXE installer Under Assets, download the file ending in windows-x64-Setup.exe and run it; install WebView2 online if prompted.
macOS Apple Silicon (ARM64) Latest DMG installer Under Assets, download the file ending in macos-arm64.dmg, open it and drag the app into Applications.

Intel Mac and Linux installers are not currently provided. The macOS package is unsigned and not notarized; if blocked, follow the included instructions in System Settings → Privacy & Security → Open Anyway. SHA-256 checksum files are available in the release assets.

Usage

1. Prepare a video

Open GAM, create a character / action project in the animation library, and import a video. Start with one short action before processing a larger set.

The workflow supports any single background color with slight unevenness. Background colors are sampled automatically from original-frame edges; subject colors must remain distinct to avoid accidental removal. Check the source silhouette and motion first.

If you need source material, create a character in Image Generation, then use that image as the first frame in Video Generation. See the AI setup options below.

2. Process in three steps

Step Action Check
01 Extract frames Choose the start, end, and extraction interval, then start extraction. Complete motion and a clean loop.
02 Remove background On first use, select a source and download U2Net (~176 MB), then process the frames. Hair, weapons, thin lines, and soft edges.
03 Clean holes and align Remove residual background colors between limbs and weapons; enable horizontal centering or bottom alignment when needed. Green character details, jump height, and intentional movement.

Play the result after each step. You can hide and restore unwanted frames in steps 02 / 03. Re-extracting frames invalidates older downstream results. Once the model is ready, local processing works offline.

After Step 02, switch to the Step 03 page and choose the magic wand or eraser at the preview’s bottom right to pause and retouch the current frame in place, without first running Step 03. Tool settings appear at the top, with brief instructions inside the preview. Click to select, Shift-click to add, and Delete to remove; left-drag to erase. Scroll to zoom, middle-drag to pan, and use Space for playback. The preview keeps its background, zoom and pan; background switching remains available. Saving marks processing complete, turns the animation card’s third status icon green, keeps the tool selected and starts a new undo history. Browse mode keeps unsaved edits. Before playback, frame/step navigation or leaving the page, choose to save, discard or stay. Cancel discards unsaved changes. Edits affect only this frame in Step 03. Re-running Step 03 replaces manual edits. W / E / V select the wand, eraser and pan tools; Cmd+S / Ctrl+S save the current frame while the wand or eraser is selected; + / - adjust the active tool’s color tolerance or eraser size. The eraser defaults to 5px with 0px feathering. Wand deletion fully clears the selection and feathers outward into neighboring pixels; with feathering set to 0, only selected pixels are cleared. Restore Initial Version restores the current frame’s appearance before manual edits in this run (using Step 02 output when Step 03 has not been run), across saves and restarts. Restoration can be undone and requires Save to update the output. If older backups do not identify their processing step, restoration stays disabled until Step 03 is reprocessed to establish a verified baseline.

3. Trim and export

Select animations in Batch Trim:

  • Shared bounding box: all frames keep the same canvas size for straightforward sequence playback.
  • Tight per-frame crops: save space and retain offsets in _frame_data.json; apply them in your engine to prevent jitter.

Open the output directory from the results to get the PNG sequence and related JSON. Keep _audio_timeline.json and audio files when present. Use the gam-export Skill below for Godot 4; configure frame sequences and offsets yourself in other engines.

Optional: AI setup

Source Setup Billing
ForFuner AI Register and sign in inside GAM, then select ForFuner AI on the generation page. Platform credits; review the current estimate before submitting.
Custom key Enable the required models in Volcengine Ark, then save your API key in GAM settings. Your own Volcengine account and provider bill.

The two sources have separate authentication and billing. Neither is required for local processing. A successful key check does not prove access to every model. Available models, options, and costs follow the current generation page and provider information.

If you forget your ForFuner AI password, choose Forgot password? on the sign-in page and reset it with an email verification code.

Agents and Godot

The six GAM Skills help agents write prompts, control the desktop app, process assets, and export animations to Godot 4. The installer requires Node.js/npm. Choose a command to install all six 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 "*"

# Detect and choose another agent
npx skills add hyhy111/gam-skills -g --skill "*"
Skill Purpose
gam-pic-prompt Write character image prompts with a clear viewpoint and art style.
gam-video-prompt Write idle, walk, attack, and other motion prompts from a character image.
gam-workflow Plan asset creation steps, inspect results, and continue processing.
gam-guide Look up features, parameters, account settings, and API key configuration.
gam-cli Use gam-agent to fill drafts, query tasks, and control the desktop app.
gam-export Import PNG animation frames, trim offsets, and audio into Godot 4.

You can also select an agent and install from Settings → Install GAM Skills in GAM, with Node.js 22.20 or later and npm available. For GAM Skills installed with npx skills, select the agent and click Check for updates. Click Update when a newer version is available. If GAM finds an update at startup, a yellow badge appears on the home-page Skills link, which opens the matching agent's installation settings. Maintain manually copied, Git-cloned, or externally managed Skills through their original installer.

After installation, describe your request, for example: “Use gam-pic-prompt to write an image prompt for a side-view swordsman,” or “Use gam-export to import this asset directory into my Godot 4 project.”

Install and open GAM before controlling the client, and allow your agent to access local files and execute commands. The app bundles gam-agent; see Packaging for its stable entry paths. gam-export also requires Python 3.10+ and uses only the standard library. Provide the asset directory and Godot 4 project directory when exporting. Local processing needs no login; online AI generation uses the account or custom key configured in the client. See the Skills CLI supported agents for other installation options.

FAQ

Do I need AI or an account? No. Process an existing video locally; download the background-removal model once to work offline.

Where is my data? Installed builds default to ~/.gam (%USERPROFILE%\.gam on Windows). Project and AI cache directories can be changed in settings. Quit the app before installing an update.

Can I export a Godot scene? The separate gam-export Skill imports trim results, frame offsets, and audio into Godot 4, creating resources and a preview scene. It requires an agent and a Godot project directory.

Green residue, missing edges, or jitter? Check the solid background, separation from subject colors, background color tolerance, removal parameters, and alignment options. Apply the saved offsets when importing tight per-frame crops.

See Usage reference for renaming, default models, and update behavior, or MODELS.md for model downloads and paths. Report problems in Issues with the app version, OS / architecture, reproduction steps, and redacted screenshots.

Development

See DEVELOPMENT.md for source setup, tests, model preparation, CLI details, installer builds, and Skills submodule maintenance. Read CONTRIBUTING.md before contributing.


MIT © ForFuner

GitHub 공식 원본 저장소에서 아카이브된 문서 미러 · GitHub 저장소 방문
동기화 기준일: 2026-11-14