Modding:Hair Mod Mesh Setup
Essential Tools
First off, get yourself these tools.
- Blender (version 3.6 recommended)
- Lslib by Norbyte
- BG3 Multi-Tool by ShinyHobo
- Collada/GR2 import/export Blender plugin by Norbyte
Because we’ll be using Blender to make the mesh for our hair mod, we recommend at least having a cursory knowledge of how to use Blender before attempting to follow this guide. If you don’t have that, we recommend Blender Guru’s Donut tutorial series. But any tutorial that teaches you the basics of how to move around, shape the mesh, create objects, etc, should be fine.
Open up your Multitool and unpack the Models.pak game files. This should contain all of the vanilla hair models we are going to use.
Open Blender 3.6 and install the Collada/GR2 exporter plugin. This will allow you to import and export .GR2s, which is the file type BG3 uses for its models.
Loading a Mesh
Let’s load a hair mesh into Blender! Go to the Modding:Hair Meshes page and pick a mesh that you like. Take note of the Asset Name—that’s what it’s called in the game files. Open the Multitool and search the index for this Asset Name. It should have a .GR2 extension, e.g. Hair_GTY_F_GithyankiCut_Short_A_Spring.GR2. Once you find it, copy it to a project folder to make it easier to find. Then go into Blender, go to File, and Import the .GR2.
Here is an example video of installing the plugin and importing a GR2.
You should now see your mesh in Blender! But it looks all white… we should fix that and make it look closer to what it’s going to look like in-game.
To visualize the texture in Blender, follow this tutorial.
Once finished, your hair should now display a texture in Blender.
If you’re not really sure what you’re looking at, BG3’s hair models are composed of pieces called “hair cards” that are essentially just long strips of mesh, or planes, with a hair texture applied. This is a (comparatively) low-poly way of making hair.
If you want to see how the hair looks on a head, you can import a head model into Blender too using the exact same method you used for the hair. Just make sure the race of the Head Model you choose matches the hair you’re working with—so if you’re editing HAIR_HUM_F_Afro_Long_A, choose a human or humanlike head.
Editing the Mesh in Blender
Now comes the fun part—playing with the hair in Blender. Make it longer or shorter, remove some parts, add some parts. There’s a lot you can do even without making any custom hair parts from scratch, so get creative!
Mesh Editing FAQ
Here are some common issues you might run into while editing the hair in Blender:
Will there be issues if I import a second (or more) vanilla hair mesh to add parts of it to my hair? You can definitely do this, and it’s a great way to make a hairstyle look unique. However, make sure all of your meshes are parented to one armature. If your hair meshes use the same material (same hair texture), we recommend combining them for simplicity once you’re done.
My hair is stretching weirdly, or even appearing on the floor in game. You need to apply transforms on the hair mesh and armature using CTRL + A > All Transforms.
Is there an easier way to select an entire part of the hair (such as a ponytail) without manually selecting each vertex? It’s hard for me to do this when the hair gets close to the scalp. Yes! Use the Box or Circle select tool to select as much of the ponytail as you can. Then, to get those pesky roots without grabbing other parts of the hair, press CTRL + +, and continue pressing those keys to Select More of the parts you already have selected.
Can I add custom highlights/greying to my hair if I don’t like the vanilla ones? Yes! This is done using Vertex Paint. See this tutorial for more details. The tutorial should work the same way for adding greying—just paint with a red color instead of a blue one.
None of the vanilla hairs seem to have the part I want. Can I make my own custom hair for BG3? Tutorial for this coming soon(TM)!
Exporting the Mesh
If using the GR2 plugin, you want to first make sure you have your export order set up, which you can find in the Object Properties tab:
Set the LOD Level and LOD Distance to 0. For the first part of your mesh set the export order to 1. Increase the export order number for every part you have. So part 1 is Export Order 1, part 2 is Export Order 2, etc... Blender will throw an error if you don't have these in order.
Once you have all that set up, if you haven't already sometime in your process, select the armature and all your meshes, and apply transforms with Ctrl + A > Apply Transforms.
Now you can export the mesh(es). These are the export settings to use when exporting with the GR2 plugin:
The settings below this cutoff remain as they are by default. If you don't apply transforms, turn back on the Convert to Y-Up.
Done with editing the mesh in Blender? Follow this tutorial to set up the files for inclusion into the game!