Reference
The detailed reference docs, each mirroring a file under docs/reference/ in the repo. These
pages summarize and link out to the committed Markdown, which stays the source of truth. Diagnose pages
describe what a check finds; generate/edit pages describe what a writer emits and what it guarantees;
the preview/runtime pages cover everything after the file layers.
Diagnose
Humanoid bones
Unity humanoid bone set and the VRChat rig requirements the armature layer validates against.
SDK3 lint rules
Every
avatar lint rule, VRC001–VRC062, plus encodings.Armature repair
What
avatar armature fix repairs vs. flags, the Blender repair script, and the FBX writer.Performance stats
The metrics behind
avatar stats (incl. particles & constraints), component recognition, PC/Android thresholds.Typed asset readers
The AnimatorController + AnimationClip readers the controller/clip lint rules consume.
Generate, edit & migrate
Asset generation
.anim clips, blend trees, full FX controllers, expression params/menus, the toggle bundle — deterministic fileIDs.Editing Unity YAML
EditableUnityFile / avatar asset set: surgical, round-trip-safe value + structural edits by span-splicing.SDK2 → SDK3 migration
avatar migrate sdk3: descriptor retype, DynamicBone → PhysBone, FX from gesture overrides, a VCC-openable project.PhysBone tuning
avatar physbone list|set|split|stretch|flare|nudge: retune a prefab's PhysBones in place, with render previews.Preview, runtime & agents
Rendering & preview
The offscreen wgpu pipeline: avatar rest-pose render, world scenes, avatar-at-spawn, the interactive viewer.
The .unitypackage format
Reading the gzip+tar format, extraction into a project tree, the avatar-in-world co-import testbed.
Runtime rig layer
Skin/bind extraction, posing + bone-matrix palette, two-bone IK, tracker input.
OSC runtime
VRChat's OSC address space, codec, UDP client, capture/replay, OSCQuery parsing + advertisement.
MCP server
The stdio MCP server exposing the read/diagnose + generation tools to an agent host. Non-writing by design.
Testing & fixtures
The fixture corpus, env-gated integration tests, and the golden-snapshot harness.