Vi3W
Skip to content

Guides

Import a mesh with bones into Roblox Studio

How to import a skinned mesh with bones into Roblox: rig rules, Blender export settings, Importer Rig Type options, and fixing common errors.

3 min read

A low-poly faceless mannequin with glowing bones and joints visible through a translucent body
Illustration. Bones inside the mesh let it bend.

Quick answer

Can you import a rigged mesh with bones into Roblox?

Yes. Export an FBX or glTF with the armature and skinning, then import it with the 3D Importer and set Rig Type to R15 or Custom. Each vertex can be influenced by at most 4 bones, bones must be frozen with the root at the origin, and each file can carry only one animation.

When you need a rigged mesh

A static mesh can move, rotate and scale, but it can't bend. If your model needs to walk, wave, flap wings or open a jaw, it needs bones and skinning, which say how much each bone moves each vertex. That's a rigged, or skinned, mesh.

A translucent low-poly arm with three glowing bones inside, bending at the elbow
Illustration. Skinning tells each vertex which bones move it.

Roblox's rig rules

From Roblox's mesh specifications:

  • At most 4 bone influences per vertex.
  • Freeze all bones: scale 1, 1, 1 and rotation 0, 0, 0.
  • Root bone at position 0, 0, 0, with no influences on the root itself.
  • One animation per file. Export each animation separately.
  • Under 20,000 triangles per mesh, like any mesh.

For avatars there are extra rules about R15 bone names and per-part budgets. If you're making a player character, it's usually easier to let Avatar Setup build the rig for you.

Step 1: Export from Blender

  1. Apply all transforms on the armature and mesh (Ctrl+A ⟩ All Transforms).
  2. In Weight Paint mode, use Limit Total set to 4, then Normalize All.
  3. Export FBX with Armature and Mesh selected, Add Leaf Bones off, and Apply Scalings set to FBX Unit Scale (export requirements).

Roblox's official R15 rigs for Blender are a good starting skeleton. See Roblox rigs for Blender.

Step 2: Import with the right Rig Type

In the 3D Importer:

  • Rig Type: R15 for a humanoid that should use Roblox's character systems, Custom for anything else, or No Rig to ignore bones. The Importer picks one automatically from the file, but check it.
  • Rig Scale (R15 only): Default, Rthro or Rthro Narrow.
  • Keep Zero Influence Bones: off by default, which removes bones that don't move anything. Turn it on if you need empty bones as attachment points.
  • Anchored: imported rigged meshes aren't anchored, since they need to move.

Step 3: Make it move

  • Humanoid rigs use the Animator inside the Humanoid.
  • Custom rigs need an AnimationController with an Animator child (using animations).

Load an animation with Animator:LoadAnimation() and call Play(). If nothing happens, see custom rig not animating.

Common import errors

  • "Too many influences": limit weights to 4 per vertex.
  • Model is huge or tiny: wrong unit scale. Check Apply Scalings and the Importer's Scale Unit.
  • Mesh explodes when animated: transforms weren't applied before skinning.
  • Bones missing: they had zero influence and were removed.

Where Vi3W fits

Vi3W generates the static, unrigged mesh: body shape and texture, retopologised and exported as GLB, FBX or OBJ. Rigging happens afterwards in Blender, Avatar Setup or another rigging tool. Our guide to rigging an AI-generated character covers that step. Make a mesh to rig in Vi3W.

Last reviewed