Roblox Blender plugin: Match parts to bones

niltrace · November 30, 2025, 7:58pm

This plugin is likely more useful for rigs with many parts and many names. It is still useful for ones with less, but renaming the parts manually may be faster. (You can do whatever you feel is best)

In Roblox, using the Blender animation plugin (from Cautioned, the older version, or any other one), there are 2 ways to export an animation rig, one is legacy, one is normal, normal exports the rig but it is bad at preserving textures (does it weirdly), meshes, and probably other stuff, however the parts are automatically connected to bones so no waiting (best for game animations, just quickly start working, no need for details)

Legacy export preserves the textures and meshes, but the part names are scrambled and not connected to the bones, so first you need to rename all the bones back to the originals (For custom rigs with many parts, you must continuously switch to studio and back to see the names and paste them into Blender, unless you remember them which is unlikely) this is time consuming and annoying

I created a plugin that automatically does this, you export the rig in both legacy and normal (separate folders). First (order doesn’t really matter but I’d suggest just doing this) import legacy to blender, rename main folder to Rig2, the parts to Parts2, and the armature to Armature2, then copy it and delete it (delete hierarchy, it is fastest), then you import the normal one and rename the main folder to Rig1, the parts Parts1, and the armature Armature1, after you are done paste the Rig2 back into the scene collection, then you select all the parts of the Parts2 folder (inside rig2), and at last the Armature2 (inside rig2), then you press the “match parts to bones” button and it will do this for you

Make sure the names are correct
Make sure all the parts are selected from the Parts2 and Armature2 is the last thing you selected
Make sure the Rig1 folder and it’s child folders are not hidden while matching parts to bones, otherwise it will process none
Make sure you are in object mode

Only tested on version 4.5 of Blender, i don’t know if previous or newer versions will support it.

When you are done you can simply delete the Rig1 folder or keep it.

Plugin: Match parts to bones Roblox Blender plugin - Pastebin.com

License:
You can use this for your own commercial works if you first ask me permission and tell me why you want to use this in your work (drastic improvements enough to create your own version, wanting to incorporate it into one of your own plugins to add more uses, etc), if i approve, then you can do whatever you want with the plugin as long as it has to do with the work you have told me about, and as long as i am given credit

Yarik_superpro · November 30, 2025, 8:17pm

Cool but i already made a script to do that:

niltrace · November 30, 2025, 8:39pm

I believe our plugins serve different purposes.

Yarik_superpro · November 30, 2025, 8:41pm

I meant that:

Full Roblox ↔ Blender Rig Animation Pipeline (Motor6D + Bone Compatible) IK,FK, IK/FK switching

import bpy

armature_name = "Armature.001"
armature = bpy.data.objects.get(armature_name)

if not armature or armature.type != 'ARMATURE':
    raise ValueError(f"Armature '{armature_name}' not found or isn't an armature.")

# we'll store the previous active object so we can restore it later
prev_active = bpy.context.view_layer.objects.active

for obj in bpy.context.selected_objects:
    if obj == armature:
        continue

    bone_name = obj.name
    if bone_name not in armature.data.bones:
        print(f"Bone '{bone_name}' not found in '{armature_name}'. Skipping '{obj.name}'.")
        continue

    # make object active (required for operator)
    bpy.context.view_layer.objects.active = obj

    # create the constraint
    constraint = obj.constraints.new(type='CHILD_OF')
    constraint.name = f"ChildOf_{bone_name}"
    constraint.target = armature
    constraint.subtarget = bone_name

    # update so transforms are correct
    bpy.context.view_layer.update()

    # set inverse using correct operator
    bpy.ops.constraint.childof_set_inverse(constraint=constraint.name, owner='OBJECT')

    print(f"Added Child Of constraint on '{obj.name}' → bone '{bone_name}'")

# restore previous active object
bpy.context.view_layer.objects.active = prev_active

Yeah, Roblox DevForum wants me to yap, or else char limit skibidi.

niltrace · November 30, 2025, 8:47pm

Full Roblox ↔ Blender Rig Animation Pipeline (Motor6D + Bone Compatible) IK,FK, IK/FK switching

import bpy

armature_name = "Armature.001"
armature = bpy.data.objects.get(armature_name)

if not armature or armature.type != 'ARMATURE':
    raise ValueError(f"Armature '{armature_name}' not found or isn't an armature.")

# we'll store the previous active object so we can restore it later
prev_active = bpy.context.view_layer.objects.active

for obj in bpy.context.selected_objects:
    if obj == armature:
        continue

    bone_name = obj.name
    if bone_name not in armature.data.bones:
        print(f"Bone '{bone_name}' not found in '{armature_name}'. Skipping '{obj.name}'.")
        continue

    # make object active (required for operator)
    bpy.context.view_layer.objects.active = obj

    # create the constraint
    constraint = obj.constraints.new(type='CHILD_OF')
    constraint.name = f"ChildOf_{bone_name}"
    constraint.target = armature
    constraint.subtarget = bone_name

    # update so transforms are correct
    bpy.context.view_layer.update()

    # set inverse using correct operator
    bpy.ops.constraint.childof_set_inverse(constraint=constraint.name, owner='OBJECT')

    print(f"Added Child Of constraint on '{obj.name}' → bone '{bone_name}'")

# restore previous active object
bpy.context.view_layer.objects.active = prev_active

Yeah our plugins are completely different. Your plugin relies on the part names being the same as the bone names, which is exactly what Cautioned’s animation plugin already does
My plugin does the naming automatically

Sorry if i sounded aggressive i don’t mean to.