Menu

Individual skill

gam-export

0upvotes

将 gam 的普通 PNG 序列、逐帧裁剪偏移和按帧触发音频导入 Godot 4，生成动画资源与可播放预览场景。

gam-export/SKILL.md

Read pinned source

Source commit a2e1d6cbe72d95ff4d0845344d06df0f3ed86766

What was checked

Matches the observed repository HEAD
Yes
Scanner rules are current
No
Repository scan complete
No
Skill scan complete
No
Observed behavior
Not checked yet
Last checked
Nov 7, 2026

These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.

Install this skill

Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.

An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.

Repository context

Repository stars (not skill ratings)
29
Repository last updated
Nov 2, 2026
License
MIT

Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.

Files and excerpt

File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.

Browse files
Read excerpt

# gam 导出

将 gam 已处理好的素材导入 Godot 4，生成动画配置和可播放的预览场景。此 skill 负责导出与 Godot 验证，可作为制作指导 skill 的最后一步。

## 场景变换约束

导入时保持导出器生成的节点变换和已有场景布局。禁止为居中预览、适配视口或消除告警而擅自修改节点的 `position`、`rotation`、`scale`，或新增父节点调整布局；只有用户明确要求调整布局时才可修改。逐帧 `offset` 仍严格读取素材元数据，不得用它对角色整体移位。遇到根节点变换告警时说明原因，不自行重置变换或修改位置。

## 引导流程

1. 确定素材目录与目标 `project.godot`。读取实际目录，判断输入是单个动作还是包含多个动作的目录。面向新用户，每次说明一个当前步骤；需要补充信息时一次只问一个问题。
2. 有 `_frame_data.json` 时，读取 `output_name`、帧序与 offset；没有时，按文件名的数字自然顺序读取 PNG，偏移为零。普通序列应使用统一画布和对齐位置；不同尺寸但没有偏移数据时，先说明可能抖动并让用户确认对齐方式。
3. 有 `_audio_timeline.json` 时，使用其 `animation_fps` 和 `clips[].placement_frame`，关联同目录的 `file`。这些触发帧已经映射到最终导出序列，索引从 0 开始；向用户说明时换算为第几张图片。`source_placement_frame` 仅用于溯源，不再次换算。没有音频清单时仅导出动画，不猜测 WAV 的触发位置。
4. 没有 FPS 元数据时询问播放速度，通过 `--fps` 指定。默认 10 FPS 仅是 CLI 回退值，不代表源视频帧率。默认 idle/walk/run 循环，其他动作不循环；按用户意图用 `--loop` 增加循环动作。
Back to top