Modding:Creating and Exporting Meshes in Blender

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

This should show up in your File> Import menu if you have the addon installed correctly.

In this tutorial we will assume you are generally knowledgable about how to use 3d software, so this will focus on things specific to Baldur’s Gate 3 exporter made by Norbyte. Remember, there are many general youtube tutorials about how to weight paint and edit meshes in Blender.

BG3 Tutorials and Resources

Be sure to watch this video tutorial series by Druu using the BG3 Blender plugin and follow along. It is older but still very relevant and helpful.

Setup

Check here for a list of tools.

Here we are using Modder's Multitool, Blender 3.6, and Norbyte’s Blender installer. Until the update specifically says it has been updated to work with Blender 4.0, we recommend sticking with Blender 3.6 currently.

Make sure you install it correctly- this video should give you some example of how to install it.

You should also install Padme’s Addon, ‘Create LODs’. You may also find use of the 'Reset Transforms' tools as they are helpful when weight painting a model.

Extracting a model to work with

Imported meshes.

Now open your modder’s multitool. Click ‘Search Index’. Filter by .GR2. Search something like HUM_F_ARM_ and browse the in game meshes available to regular size humanlike females. You may also wish to consult this table- Clothing and Armor models by Saku. (This lists HUM F only but most outfits fit male and other races as well)

You should at least extract HUM_F_NKD_Body_A (or whatever nude you are basing your outfit on) to fit your new outfit around.

When you have found a model to your liking, click the extract file/open folder. You should find the mesh in .GR2 and .dae form on your computer. Use the .dae- the Blender importer likes .dae format a lot more than it likes .gr2.

A mesh importing. It has only 1 Lod.

You generally cannot import a modded-in mesh without the plugin crashing Blender. Hopefully you are sensible and you save your own work often and can re-export it from there, and have obtained permission to edit all the modded items you want to import anyway.

Importing

It will be a fairly standard rig with an Armature modifier (see Modifier tab).

Your armatures will import in at 90 degrees. This will cause it to export flat to the floor and follow a naked character around like a weird sad windsock, so you need to fix it.

[Object Mode] Object > Apply> All Transforms on the armature, until the coordinates for its location all read 0, 0, 0. You may need to do the same thing on the meshes as well.

Your mesh will likely import this way- note 90 degree angle.

The mesh will import in with 1 or more LODS. These are level of detail meshes, intended to be viewed at a distance so they are lower poly. You only need the best quality one as we are making new LODs later, so delete anything that has LOD in the name.

If your mesh you imported has a skirt, it may have an undetailed boxy thing called a ‘Cloth Mesh’. This has to do with Physics (see below).

Editing Meshes

If you wish to combine two meshes for whatever reason, remember that each mesh will have its own name for the UV map and colour maps. You need to rename the UV maps and Colour maps to be the same before you combine them, or one will be absorbed into the other.

The UV map may seem bare when you tab into the UV display, but BG3 meshes have an odd habit of not being on the actual UV square itself, as the UV tiles. So you may need to scroll out quite far to see the full UV. You can drag it back (Snap to Vertex can be useful with this) or keep it there, it usually does not matter.

Your UV map and Colour maps, found in Object Data tab.

Depending on what type of mesh you imported, it will not have all the bones- circlets for example may only import in with the head bone.

If making a new full body mesh, it is generally a good idea to parent your mesh to a naked body, which does have all the bones, as this can avoid weighting issues.

Remember that genitals are attached later via lsx code and aren't a part of the body mesh.

Vertex Paint

This underwear has its green vertex paint, which tells it to vanish when a top is equipped.

Tab into Vertex Paint mode to look at the naked body.

The game’s armour system works by vertex paint. It uses this, in combination with the .lsx code, to tell it what to hide and what to show. For example, an armour mesh may unload the torso as it will not be shown. The bottom half of a pant leg may not show when boots are equipped. Genitals have their own vertex paint and only load in when nothing with the 'hide genitals' tag is equipped. You can use existing meshes as a reference for this.

Check here for a reference and Hex codes for the vertex paint including physics colours.

Keeping the HUM_F_NKD_Body_A in the scene is useful as reference here. For example, if you set an upper arm to be hidden for some gloves, you may wish to fit it around these seams to ensure there is no gap in the body showing.

You can turn on the vertex paint to look at it in non-Vertex Paint modes by touching the Blender attributes menu.

You can also turn on Flat shading from the same menu, to get a better view of things if you are creating your own vertex paint for outfits.

Generally outfit meshes are black in vertex paint, with some dark green on elements intended to disappear such as the pant legs. You may not need to touch the vertex paint if you are just editing existing outfits!

If you intend to use part of an underwear mesh on an outerwear outfit, make sure you paint it black in Vertex Paint or it will hide when it’s not supposed to.

How to view Vertex Paint in Object Mode

How to Vertex Paint Sleeves and Pant Legs

If you handpaint vertex paint on your own meshes, the mesh will often glitch. You may need to use this method to make it work.

Go into Edit mode.

Select the vertices you want painted.

Shift + D to copy the vertices (right click so they stay in place)

Go into Vertex color and click the little icon on top that makes sure you only paint on selected vertices.

Fill vertex color.

Remember also you need to have a VertCut material set up in your LSX for Vertcut to take effect.

Fixing meshes that import in wrong

Fixing Meshes that import in wrong: Sometimes the normals of skirts import this way- unusable in game.

Sometimes meshes will import in with broken shading and stuck together, usually on skirt meshes. This is because the verts were too close together and the importer couldn't interpret it. This is often an issue with the normals as well.

See this video for how to fix meshes that import in with messed up normals and export looking like see through checkerboards.

You can also fix with [Edit Mode] Mesh> Clean Up> Merge By Distance, and then put a solidify modifier at 00.1 thickness.

How to view face orientation overlay on Blender. Blue is outside, red is inside. Red will be invisible in-game, unless you set up a 2 sided shader in your LSX code later.

Physics

Unfortunately physics are not quite at game quality yet at this stage.

Physics are set with red vertex paint. Hot pink vertex paint counterbalances the physics.

A cloth mesh (Generally named something like HUM_F_CLT_Daisy_Dress_A_Cloth_Mesh and will import in) is the collider mesh, which stops it clipping through things. Sadly you may need to delete it as it can cause your mesh to be exported with errors.

Here is a tutorial about how to add physics to your mesh by ReallyLazyIcarus.

Some people have had success pasting the code from in game meshes into their lsx mesh code, specifically clothbuffer values, which caused the physics to be less flappy and enabled the collider mesh to be exported without issues. Which is worth a try if you have a lot of patience and experience with coding.

Example of red vertex paint for Physics. (Daisy Dress Mesh)

If you learn anything new, add it here!

Lods and Load Order

Here is a video of Padme’s addons being used.

Using Padme’s addon tool, click the button to generate LOD and you will have your nice new set of LODs. You may need to edit the LOD0 it’s a new mesh, as it won't know what settings a BG3 mesh should have.

LOD order in BG3 settings. You can find this in your Object/Object Properties tab.

-LOD Level is what level of LOD it is. LOD0 is the best quality, cutscene one. Meshes generally have no more than 4-5 LODS, usually depending on how 'common' an asset it is. (A common peasant shirt will have many LODS, while an armour intended only for the player or important NPC may have only 1 LOD.)

-Lod Distance is the distance from which your mesh swaps to the next LOD. For this reason, your highest quality mesh should probably be something like 9-15 metres, your middle ones 15-20, while your last LOD always needs to be set to 0. Or it will vanish from a distance. There are certain cutscenes in Act 3 and elsewhere where your player character is seen from a very long distance, so this is important!

If you don’t particularly care about it performing well on bad computers, you can have no LOD and just set your high quality mesh to have a Lod distance of 0.

-Export order. Generally all your LOD0 meshes go first, then your LOD1, LOD2, LOD3, assuming you have multiple LOD0 meshes. Look at imported game meshes for reference. If there is not a consistent 1, 2, 3, 4, export order, the mesh will refuse to export.

If you get the export order wrong in the code, some meshes may end up with the wrong material assigned to them.

Exporting

Remember to set all of your mesh to the same material in Blender, or delete all materials assigned to the mesh before exporting, or some parts of the outfit may not show up in the game.

Default export settings are fine to use. See here for an example.

Remember to save as .GR2 not .gr2 and use that in all your code, the game is very concerned with capitalisation.

Your mesh will export x-mirrored. Meshes import in from the multitool x-mirrored, so they are the right way around now!

If you parented your mesh to the nude body armature, remember to delete the nude body before exporting it!

Default export settings for Blender 3.6

Testing in Game

It is recommended to test the mesh first by exporting it as a replacer for an existing mesh(even one from a mod you have unpacked) if you are new to modding, as there’s a lot of things that can cause an item to not show up in your code.

For adding the item in game as a seperate item, see here- Coding an Item.