VRC Auto-Rigger

VRC Auto-Rigger FBX · Unity Humanoidby McDudeMan

Support me on Ko-fi

Move

Blend shapes0

Preview only: sliders never change the shapes.

Size

Drop model files or a .zip

Working…

Import a model

Pick the model and any texture files it uses, or one .zip containing everything. Supported: .glb .gltf .vrm .fbx .obj (+.mtl), textures .png .jpg .tga .webp.

Choose files…

Or drag files onto the viewport. If the file already has a skeleton, you choose whether to keep it, re-rig from its joints, or start over. Everything stays on your computer.

Orient & scale

Keeping your rig: the export puts the model back exactly where your file had it, so turning it here only changes your view. Height changes are kept.

The model should stand upright (Y up). Avatars should face you in the Front view, with their left side on your right. The model is placed on the ground and centred automatically.

Rotate 90°

Height

Model height in metres

Typical VRChat avatars are 1.2–1.9 m; props should be their real-world size. Files authored in centimetres are scaled down automatically.

Skeleton

Using your rig exactly as it is. Bones, bone names and orientations, weights, mesh names and blend shapes are exported unchanged. Add extra bones in the next step: only the area inside their influence radius changes.

Add mouth blend shapesAdds the 15 VRChat visemes as new blend shapes. Your existing shapes are not changed.

Drag each marker onto the matching joint, seen from the front. Depth is centred inside the body for you; check from the Side view if a limb is unusual. Head goes at the base of the skull (about level with the ear lobes), Groin at the crotch.

Found a skeleton in your file. Using it.

Character's leftCharacter's rightCentre

SymmetryMoving one side mirrors the other. Finger bonesAdds a fingertip marker per finger (3 bones each) for VRChat hand gestures. Eye bonesFor VRChat eye tracking. Separate eyeball meshes near a marker follow the eye bone. Upper chest boneFour-bone spine (Hips, Spine, Chest, UpperChest). Mouth blend shapesGenerates the 15 VRChat visemes plus jaw and lip shapes. Needs a mouth that can open (separate upper and lower lip); the Mouth marker shows what was found.

Fingers

Curl the fingers

Show every bone (advanced)Adds a small handle on each joint without a marker (spine, shoulders, finger joints…) so you can fine-tune it. R resets the selected one.

Build any skeleton by clicking on the model. Each click adds a joint as a child of the selected one, so clicking along a tail makes a chain. Select an earlier joint to branch. Drag joints to adjust.

Name

Parent

Joints with no children are end points: they shape the bone before them and carry no weights. Del removes the selected joint, Esc deselects.

For objects that aren't avatars: a dangling charm, an antenna, a cable, a tail on a hat. A Root bone holds the rigid part of the prop; chains attached to it are what PhysBones will move.

Root bone

The pivot the prop hangs from. Drag the yellow marker, or snap it.

Auto chain

Runs a chain through the length of a mesh, starting from the end nearest the root.

Mesh

Bones

Start from the far end

Draw a chain

Extra bones

Add non-skeletal chains for hair, ears, tails, antennae, skirts or accessories. They come out as ordinary bones you can drive with VRChat PhysBones. Each chain only takes weight from vertices within its radius.

Attach to bone

Only affect mesh

Name

Bones

Influence radius

Click on the model from root to tip. Bones = 0 makes one bone per click; any other number resamples the chain evenly. Enter finishes.

Test

Sways the model and lets the extra bones swing on springs, roughly the way PhysBones will move them. The teal shapes show each chain's influence radius.

Rig & weights

Weight smoothing

Joint blend width

Test motion

Pose a bone

Bone

Rotate X

Rotate Y

Rotate Z

Show weights of this bone

Paint weights

Paints the bone picked above. Drag on the model to paint; drag off the model (or switch the brush off) to orbit the view. Red is full weight, blue is none.

Brush radius

Strength

Set weight to

Only the mesh under the brushSeparate meshes nearby (a base, an eyeball) are left alone. Mirror across XAlso paints the opposite side, on the mirrored bone (Left/Right, _L/_R).

Give a whole mesh to this bone

Export FBX

File name

Advanced options

Combine meshes into one "Body"Fewer skinned meshes is better for VRChat performance. Blend shapes are kept either way. Bake arms into T-poseRotates the arms level before export so Unity's Humanoid setup needs no pose fix. Off keeps the pose as modelled. Also include textures as separate filesThey are always embedded inside the FBX as well.

Updating a model that's already in Unity?

Keep the same file name (it starts as your original's name).
In your file browser (not inside Unity), copy the new .fbx over the old one in your project's Assets folder and choose Replace. Unity reimports it and keeps its settings, materials and everything that points at it. Dragging it into Unity instead makes a second copy.

New to Unity import?

Drop the .fbx into your VRChat avatar project.
Model tab: leave Scale Factor 1, Convert Units on. Materials tab: Extract Textures, then Extract Materials.
Rig tab: Animation Type Humanoid (custom skeletons: Generic), Avatar Definition Create From This Model, Apply.
Avatars: drag the model into the scene and add a VRC Avatar Descriptor. Add VRC Phys Bone components to the first bone of each extra chain.
Generated visemes: in the Avatar Descriptor set Lip Sync to Viseme Blend Shape, Face Mesh to the mesh holding them (Body when combined), then Auto Detect.
Props: Animation Type Generic, no Avatar Descriptor needed. Put a VRC Phys Bone on each chain's first bone (listed in the README).

Something went wrong?

Copy a short report (model size, the options you picked, any warnings and errors) and paste it where you ask for help. It contains no model data.

VRC Auto-Rigger

Rig an avatar or a prop and export an FBX that's ready for Unity and VRChat.

Your model never leaves your computer. Everything runs in your browser. Nothing is uploaded, stored or tracked.

Works offline: save this page and open it any time.

How do I know?

The whole tool is this one page. Its code and the 3D libraries it uses are inside the file; nothing is loaded from anywhere else.
Turn off your internet after the page has loaded, or open a saved copy offline: importing, rigging and exporting all still work.
Your browser's developer tools (F12, Network tab) show no requests when you import, rig or export.
The code is readable: right-click the page and choose View Page Source.

What's in your file

How should the tool use your skeleton?

Keep my rig and add to itRecommended Bones, names, weights, mesh names and blend shapes stay exactly as they are. Use this to add physics bones (a ponytail, a tail, a skirt) to a finished avatar. Re-rig using my file's jointsRecommended Starts from your bone positions, renames them to Unity's standard names and rebuilds all the weights. Use this when the weights are bad. Start from scratch Ignores the file's skeleton and finds the joints from the shape of the mesh.

Match bones by hand

Pick the bone in your file for each body part. Parts marked * are required by Unity Humanoid. The tool filled in what it could.

Keyboard shortcuts

WASD: Orbit the view (arrow keys too, when nothing is selected)
+ −: Zoom in / out
F: Frame the selected marker, or the whole model
1 2 3: Front, side and top view
Tab / Shift+Tab: Select the next / previous marker
Arrow keys: Nudge the selected marker (hold Shift for fine steps)
X Y Z: Lock movement to one axis; press again to release
M: Midline lock: stay on the centre line
Shift + drag: Lock to the direction you start dragging in
Ctrl+Z / Ctrl+Y: Undo / redo marker moves (and weight painting in step 5)
Esc: Deselect, or close a window
Enter: Finish a chain / confirm a finger step
B: Weight brush on/off (step 5)
?: This list