Modding:Hair Mod Mesh Setup

Community • Guides • Modding
Modding guides	Modding:BG3 Mini Tool Modding:Blender Export Settings Modding:Code Snippets Modding:Coding An Item Modding:Compatibility Framework Modding:Creating a custom cloth collider Modding:Creating and Exporting Meshes in Blender Modding:Creating Item Icons Modding:Creating meta.lsx Modding:Creating mods Modding:Editing a Character Creation Preset Modding:Editing Equipment.txt Modding:Hotloading Modding:How To Find A Virtual Texture Modding:Installing mods Modding:Localization Modding:Modding resources Modding:Packaging mods Modding:Texture formatting Understanding Mod Folder Structure Modding:Unpacking and converting files Modding:Working with LSX files
Modding resources	Modding:Armor/Clothing Texture Maps Modding:Body Models Modding:Custom polymorph Modding:Dependencies Modding:Face and body textures Modding:Fixing bone errors Modding:Fixing neck seams Modding:Fixing UV errors Modding:Getting Started with BG3 Modding Modding:Hair Meshes Modding:Head Models Modding:Mod troubleshooting Modding:Modding class icons Modding:NPC Head Models Tiefling Horn Models Modding:Non-VT Shaders Modding:Race UUID Modding:Sample Templates Modding:Texture formatting Modding:Tools Modding:TreasureTables References Modding:Tutorials Modding:VertexColorMaskSlots Modding:Working with LSX files

So, you wanna make a hair mod for Baldur’s Gate 3.

First off, get yourself these tools.

Blender (version 3.6 recommended)
Lslib by Norbyte
BG3 Multi-Tool by ShinyHobo
Mesh import/export Blender plugin by Norbyte

I recommend a cursory knowledge of how to use Blender before attempting to follow this guide.

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.

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.

Modding:Hair Mod Mesh Setup

Navigation menu

Search