Common mistakes when setting action frames?

设置动作帧时常见错误：动作组 AG

Last updated: 2026-10-21

Common mistakes when setting action frames in AG

动作组 AG 中设置动作帧的常见错误

Most action-frame errors come from one cause: the AG action unit's target part (join) and its seq frame range don't match the states that exist on the bound material group.

多数动作帧错误只有一个原因：AG 动作单元的目标部件（join）与 seq 帧范围，和已绑定素材组上实际存在的状态不匹配。

How to do it in 3SAX V3

在 3SAX V3 中怎么做

1. Open the SG panel first. Confirm every part has a Part ID, a category (join), and numbered states. Frames you want to animate must exist here.

1. 先打开 SG 面板。确认每个部件都有 Part ID、category（join）和编号状态；要动的帧必须在这里存在。

2. Open AG. Bind the correct material group.

2. 打开 AG，绑定正确的素材组。

3. Add an action unit. Set the target part = join, not a raw Part ID.

3. 添加动作单元。目标部件填 join，不要填原始 Part ID。

4. Click auto-suggest sequence so the seq (e.g. 01:0-5) matches the target part's available states.

4. 点击自动建议序列，让 seq（如 01:0-5）匹配目标部件的可用状态。

5. Set relative rotation, scale, X/Y offsets, swap part, or trigger event per unit.

5. 为每个单元设置相对旋转、缩放、X/Y 偏移、替换部件或触发事件。

6. Check the real-time hint beside each input: green = valid, red = error with a fix example.

6. 查看每个输入旁的实时提示：绿色为有效，红色为错误并给出修正示例。

7. Open CANVAS to preview; drag to adjust dx/dy or edit rot/scale, and changes sync back into the codes.

7. 打开 CANVAS 预览，拖动微调 dx/dy 或修改 rot/scale，改动会同步回代码。

8. Run whole-project validation before render and fix every clickable error.

8. 渲染前执行整项目校验，逐条点击修复错误。

What you CAN and CANNOT do

能做与不能做

CAN: build a state machine with multiple action units, swap parts, trigger EVT events, and save the action to LIBRARY for one-click reuse.
CANNOT: reference frames or states that the material group does not have; AG has no camera or music settings (use CAM and MG).
Wrong target join or out-of-range seq: parts jump or fly apart and the code is rejected.
Missing rest-fill confirmation: render fails.

能做：用多个动作单元搭状态机、替换部件、触发 EVT 事件，并把动作存入 LIBRARY 一键复用。
不能做：引用素材组不存在的帧或状态；AG 不含相机和音乐设置（用 CAM 和 MG）。
join 填错或 seq 越界：部件乱跳或飞散，代码被拒绝。
缺少补休确认：渲染失败。

Try the 3SAX V3 creator tool and validate one action unit at a time.

现在就用 3SAX V3 创作工具，一次只校验一个动作单元。