How do I check whether my part tree is valid?

如何检查我的部件树是否有效？

Last updated: 2026-10-21

How to check whether your part tree is valid

如何检查你的部件树是否有效

Every part must have a unique Part ID, and each Parent ID must point to an existing part. Broken links or duplicate IDs make parts fly apart or fail render.

每个部件必须有唯一的 Part ID，且每个 Parent ID 必须指向已存在的部件。断链或重复 ID 会导致部件飞散或渲染失败。

How to do it in 3SAX V3

在 3SAX V3 中如何操作

1. Open the SG Material Group panel and check every uploaded PNG part has a filled Part ID, Parent ID, baseX/baseY, Anchor X/Y, Scale, Layer and Z-perspective.

1. 打开 SG 素材组面板，检查每个上传的 PNG 部件是否已填写 Part ID、Parent ID、baseX/baseY、Anchor X/Y、Scale、Layer 和 Z 透视。

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

2. 查看每个输入框旁的实时提示：绿色为有效，红色为错误并附修复示例。

3. Confirm the root part has an empty or self-referencing Parent ID.

3. 确认根部件的 Parent ID 为空或指向自身。

4. Check every child's Parent ID matches an existing Part ID and the category (join) is set.

4. 检查每个子部件的 Parent ID 与已有 Part ID 一致，且类别（join）已设置。

5. Confirm numbered states (frames) exist for each part used by actions.

5. 确认动作引用的每个部件都有编号状态（帧）。

6. Run whole-project validation and work through the clickable error list.

6. 运行整项目校验，按可点击的错误列表逐条处理。

7. Fix red fields, then re-validate before rendering.

7. 修正红色字段后再次校验，再渲染。

What you CAN and CANNOT do

你能做与不能做

CAN: build parent-child trees, edit Part/Parent IDs, see per-field validation, run whole-project validation.
CANNOT: render with broken parent links or duplicate IDs — parts fly apart or render fails; unfixed red inputs keep the code rejected.

能做：构建父子树、编辑 Part/Parent ID、查看逐字段校验、运行整项目校验。
不能做：在父级链接断裂或 ID 重复时渲染——部件会飞散或渲染失败；未修正的红色输入会使代码被拒绝。

Open the 3SAX V3 creator tool and run whole-project validation on your SG tree now.

现在打开 3SAX V3 创作工具，对你的 SG 部件树运行整项目校验。