¶ WIP Getting Started with 3D Modding
Looking to get into modding game assets like heads, hair, armor, weapons, etc.?
This guide will try to focus on setting up the basics needed to get started. The focus of this page is primarily on working with 3D assets.
What it won’t cover is what happens after the initial set up, i.e. the creation of head/hair/armour/etc. mods. These will be on their own pages, a list of which is listed at the end of this guide.
¶ Overview of Guide
- Tools
- Download and setup of main tools needed to extract, import, and edit assets
- Finding assets
- Useful references
- Searching the files
- Next steps
- Links to specific guides regarding how to proceed, depending on what area you would like to mod.
¶ Tools
¶ Tools Overview
This first part covers the installation of a few core tools needed to get you up and running.
Includes:
- LSLIB / ConverterApp
- Modder’s Multitool
- Blender and core related add-ons
- VSCod(e/ium) and some useful extensions
¶ Tools: LSLiB
LSLIB
use latest beta release
LSLiB is used for many things. Its front end application, ConverterApp.exe, is used for unpacking game/mod paks, converting between various game file formats and editable ones, creating paks, creating virtual textures, and more.
(TODO: create/link page here on how to use various LSLiB functions)
¶ Initial setup
To download, head over to Releases and grab the latest ExportTool zip. For those unfamiliar with Github, the releases will look like this. Just grab the zip and (if you need it) the .NET dependency via the link.
NOTE: the release in the screenshot below may be outdated - just go ahead and grab the most recent beta
You can install/extract this where you want your modding utilities to be.
For the purposes of this guide I have a directory for BG3 Utilities and have extracted it here:
Inside ExportTool-vX.X\Packed you will find ConverterApp.exe (colloquially, LSLiB), open it.
At the moment there isn’t too much to set up, a few notes:
- Game: make sure it’s set to Baldur’s Gate 3
- For most mesh purposes you will want to have X-flip meshes turned OFF (default is on)
¶ Tools: Modder’s Multitool
Modder’s Multitool
use latest release
MMT is another way to unpak/pak game files and mods. Additionally, it is used for indexing these game files for searching and extracting.
¶ Initial Setup
Same as with LSLiB, download from releases.
Instructions for installation and configuration can also be found on the Github page here.
Remember to set up your directories in Configuration:
For most cases you DO NOT need to mass unpack any game files. This will take up a ton of space on your hard drive. What you will want to do instead is index them, so that you can use the “Search Index” option later. Once the files are indexed, you can search them and selectively download the ones you want.
¶ Further Setup
If you want to use the index search for finding/extracting meshes (GR2 files), there is one more step required, as MMT itself does not contain a necessary file to deal with GR2: The granny.
Head over to where you installed LSLiB and copy the granny.dll file from here:
and paste it in your MMT directory here:
¶ Using the Index Search
A small guide on using the index search here. (link coming soon)
¶ Tools: Blender
Blender
as of this writing most plugins will function with v4+ and can be used safely. Using at least v3.6+ is recommended.Note: you may have multiple versions of Blender installed on your PC at a time.
Blender is a free 3D modeling/animation software. Using plugins made for BG3, we can import/export the game’s GR2 files and edit them.
Once we have Blender installed, it’s time to get some core plugins.
Some people have had some issues directly installing these plugins with Blender versions 4+.
It is possible to have multiple versions of Blender installed! So, grab 3.6, install the plugins there, and when you update to a newer version, it should take your plugins and settings with it.
Also, while Blender does have an in-app function to directly import add-ons from zip files, this does not always work with older plugins and can cause it to nest one folder too deep in the install location.
¶ Important BG3 Plugins
¶ BG3/DOS2 Collada Exporter
- This is a necessary plugin to import/export the game’s extracted GR2 files
- Requires LSLIB and setting a path to it in its settings
First, download the zip from Github, located here:
Unfortunately, this cannot be directly installed by dragging into Blender, due to having an extra folder. So what we need to do is extract the zip, look inside for a folder called “io_scene_dos2de”, grab it and drop it into
..\AppData\Roaming\Blender Foundation\Blender\4.1\scripts\addons
(4.1 or whatever version of Blender you are using)
To quickly open the AppData\Roaming folder on Windows, press Windows key + R at the same time, then type %APPDATA% into the box, and hit OK.
If you do not yet have a scripts\addons directory, you may create it.
If you look inside this folder, it should look like this (minus the _pycache_ as this gets autogenerated later):
Now we need to edit its configuration in Blender. Go to Edit -> Preferences -> Add-ons. Use the search box to search for dos or bg3 and it should appear. Expand it with the little arrow, and enter the path to the divine.exe inside your LSLIB directory.
If you wish, you can tick “Convert to GR2 by Default” (otherwise it will always default to .dae export).
¶ LaughingLeader’s Blender Helpers
As of 10/24/2025, this plugin no longer seems to be necessary, as its features are included in the DOS2/BG3 Collada Exporter plugin.
If you are using an old version of the Collada Exporter plugin for some reason, this plugin may still be necessary to display the export settings.
- Adds settings involved with export (i.e. Export Order of meshes, LOD Level/Distance, and some options for mesh type)
- Github page says for Blender 2.79 but it can be used with current versions
Download and install the same way we did the BG3/DOS2 Collada Exporter.
However, in this case there aren’t any specific add-on preferences to set here, and once installed you should see this at the bottom right under Object properties (yellow square):
Some notes about common settings:
- Export Order: for exports with multiple meshes, the order of them needs to be set starting with 1. This order will be replicated in your VisualBank and is important for having the correct materials on the correct meshes.
- LOD Level: LODs are less resource intensive/lower quality version of the same mesh intended to be loaded in the further zoomed out the game camera is. Most modders choose to delete all LODs but 0 (the highest quality). For this it is important to set the LOD Distance to 0m.
- LOD Distance: The max distance the mesh loads with before the lower quality LOD loads in. I.e.
- LOD0 set to 6m: highest quality, working mesh. Will be loaded in until after 6m.
- LOD1 set to 12m: next lower quality, will load in after 6m. If there is a LOD3 it will load in after 12m.
¶ Other Useful Plugins
- Padme4000’s Blender Add-ons
- Includes add-ons for setting head export order, creating LODs, transferring normalmaps, and easy setting of transforms.
- BG3 Armature Tools
- Tools for creating custom head skeletons for modded heads - tutorial for making these found here
- Outfit Builder
- Refit armours via shapekeys (requires shapekeyed body meshes - tutorial for making these found LINK HERE)
- Mesh Data Transfer
- Tool for transferring mesh data from a source mesh to a target mesh.
- Robust Weight Transfer
- For transferring weights between meshes, often giving a better result than Blender’s default weight transfer function.
- Vertex Color Master
- An extension for manipulating vertex paint, including the ability to create linear or circular gradients and adjust HSV of vertex paint colors.
- Volno’s Texture Toolbox
- Not a plugin per se, but a shader set useful for rendering an approximation of BG3 textures in Blender.
- BG3 Lazy Tailor
- Another tool by Volno to refit meshes between body types. Also supports creating your own custom body type presets.
¶ Tools: Getting it into the Game
¶ oh no
For “classic” modding, this section is covered pretty well over on the Setting up a Dev Environment page.
Additionally, consider using the official Modding Toolkit - documentation for it may be found on Larian’s BG3 Modding site and on Mod.io
¶ Finding Assets
¶ References
- References regarding Head, Hair, Beard, Body, Horns, etc. found here
- Includes in-game names, file names, icons, and relevant UUIDs.
¶ Searching
-
Using BG3 Search Engine
-
Using Modder’s Multitool
-
Using the official BG3 Modding Toolkit asset browser
¶ Next Steps
So now we have the basics set up to start some modding. If you’re thinking “that’s great, now what”, you may peruse our growing list of tutorials for visual modding.
If you have further questions, need help, or want to share your progress, you’re welcome to join our discord server.
