RIG Swapping Garments - other body conversion

Guide originally written by Pinkydude


Created: ??? by PinkyDude 🦝on Google Docs Last documented update: Jul 05 2024 by manavortex

Pinky's note: Thanks to ITzsassha for motivating me in writing this tutorial! 💛

This tutorial will teach you how to swap a garment to a different rig.

This is how you convert items from the male body rig to the female, or vice versa. The example will put Mateo's shirt on Placide, but you can use any two body types!



>= 8.14 (Stable | Nightly)

For modifying game files and packing your mod

The most recent version (github)

Importing and exporting from Wolvenkit

As supported by the IO suite. As of August 24, that is 4.0.1

Doing the actual work

If you don't have one yet, you can check out Adding new items and download the example project.

Step 0: Getting the file into Blender

You need both the body you want to refit for and the item you want to refit in Blender.

Find body mesh file paths listed under Cheat Sheet: Body

These steps won't be covered here in detail — for a step-by-step guide, see R&R: Refitting (step by step) -> Step 1: Adding the meshes to your project

Mateo uses the “Man Average” (MA) rig, so all of his garments do as well.

Placide uses the “Man Big” (MB) rig!

Step 1: Refitting

These steps won't be covered here in detail — for a step-by-step guide, see R&R: Refitting (step by step)Step 4: Refitting

Doing a simple mesh refitting won’t work since the rigs don’t match/the bones don’t align correctly!

Step 2: Rig swapping

Once the MA garment’s meshes are refitted to the MB body, we need to Rig Swap it. For that, I will import a MB rig mesh! I choose to import Placide’s body, so it has every bone he’d possibly need.

Once imported, I’ll select the first submesh, enter Edit Mode [TAB], select all of the model [A] and press [DELETE] > [FACES] to empty the submesh! Do that for every submeshes of the MB garment.

Take note that Mateo’s shirt has 3 submeshes (the main shirt, the stitches decal and the buttons decal) Placide’s body, the MB garment that I just imported, only has 2 submeshes.

I will duplicate one of the submesh [SHIFT+D] to match the numbers of submesh from the refitted MA garment! (In my case, 3!)

Once that’s done, be sure to rename the MB submeshes to match the MA’s garment submeshes names. You can manually rename them or copy/paste the names of both the (orange) submesh and the (green) submesh!

Once renamed, I recommend deleting all of the vertex groups from the MB submeshes you just renamed. For that, select a submesh in Object Mode, go to the Object Data Properties tab, click on the little drop down menu arrow and select [DELETE ALL GROUP]

You’re now ready to actually transfer your refitted garment to its new rig; you’re ready to “Rig Swap”!

In Object mode, first select the first MA submesh. While pressing [CTRL], click on the MB submesh of the same name (submesh0 on submesh0) to select it as well. Be sure to have your cursor placed on the viewport (main window, not in the right column, for some reason blender doesn’t like it) and then press [CTRL+J] to merge your MA submesh into the MB submesh!

Your refitted garment now has the right rig! \O/

Step 3: Exporting

⚠ Before Exporting!

Some NPC garments have a bone called “NeckCollar_JNT” and cause meshes to collapse around the neck area. An easy way to fix that is to check in the submeshes’s vertex group list if it’s in there, and to rename it simply to “Neck” (even if there’s already a “Neck” vertex group, it will stack!)

Once that’s done, you can export your refitted and rig swapped garment!

You can now test your newly refitted mesh in game :D

And Voila! 🤙

Don’t mind his missing body parts, I didn’t bother fixing his body mesh and I spawned the regular Placide from AMM

Same-gender refits are relatively easy (MA to MB, WA to WB…) because, as said earlier, the rig structure are the same and share the same names.

For cross-gender refits (WA to MA, MA to WA) the rigs are different and you will have to export your refitted garment over a same-gendered vanilla garment, to then transfer the mesh render data (mlsetup, mlmask, normal map…) in WolvenKit from the original Mesh to the refitted one!

Hopefully this is easy enough to follow 🤲

As always, have fun and I wish y’all a good modding, chooms! 💛

Thank you for reading -Pkd

Last updated