Skip to content

Add FBX pipeline rules and authoring checklist documentation - #110

Merged
SashaRX merged 1 commit into
claude/bake-ao-single-hierarchy-27AwSfrom
claude/fbx-pipeline-checklist-nU9q2
May 2, 2026
Merged

Add FBX pipeline rules and authoring checklist documentation#110
SashaRX merged 1 commit into
claude/bake-ao-single-hierarchy-27AwSfrom
claude/fbx-pipeline-checklist-nU9q2

Conversation

@SashaRX

@SashaRX SashaRX commented May 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • Added comprehensive FBX_PIPELINE_CHECKLIST.md documenting FBX authoring standards, validation rules, and tooling guidance
  • Serves as the source of truth for patch_fbx_materials violations and Unity import warnings
  • Includes 11 sections covering materials, triangulation, layers, vertex colors, hierarchy, skinning, scene-level rules, naming conventions, tooling compatibility, patcher report categories, and authoring checklist

Changed Zones

  • Docs (README.md, CHANGELOG.md)

Checklist

  • .meta files present for all new files/directories (documentation file)
  • No code changes (documentation only)

Test Plan

N/A — documentation file with no executable code.

Review Notes

This document establishes the contract between FBX authoring tools (Max, Blender, UnityMeshLab) and the patch_fbx_materials patcher. It maps each validation rule to:

  • Why the rule exists (Unity import behavior, deformer integrity, etc.)
  • Which patch_fbx_materials --report-file categories flag violations
  • Which Unity console warnings correspond to each rule
  • How to fix violations at source

The document explicitly states that the patcher is a regression net, not the authoring contract — if a tool produces a file that flags any category, the tool is wrong, not the patcher.

Key sections:

  • §1–8: Core FBX rules (materials, geometry, layers, naming)
  • §9: Tooling guidance (UnityMeshLab, TS_ plugin, MeshLab, Unity FBX Exporter)
  • §10: Patcher report category → rule mapping
  • §11: Pre-merge checklist for new FBX export code paths

https://claude.ai/code/session_01HCB65PD6V6PrbkuavHGDmQ

Source-of-truth document for FBX authoring + tooling. Each rule maps
to a patch_fbx_materials report category or a Unity import warning,
with notes on UnityMeshLab / TS_ plugin / desktop MeshLab compatibility.
@SashaRX
SashaRX merged commit ffde751 into claude/bake-ao-single-hierarchy-27AwS May 2, 2026
SashaRX pushed a commit that referenced this pull request May 3, 2026
Brings in the FbxExportIntent API + atomic FBX overwrite + isolated-
channel export core (5 code commits on top of the docs-only #110
that was already squash-merged). Required before migrating
PrefabBuilderTool.ExecBuildSave to the narrow intent path.

https://claude.ai/code/session_01CkRooSFA5QW3Kox9AAFe3F

# Conflicts:
#	Documentation~/FBX_PIPELINE_CHECKLIST.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants