Modding:Hotloading

From Baldur's Gate 3 Wiki
Jump to navigation Jump to search

What is hotloading in BG3 Modding?[edit | edit source]

Hotloading is a way to greatly speed up your modding workflow by reducing the number of times you have to open and close the game. It can be very tedious to have to restart the entire game to test every time you make a change to your mod. With hotloading, you can leave the game open and still see your changes reflected live.

What can I use it for?[edit | edit source]

You can use hotloading for .GR2 aka mesh/model files and .DDS files. Say you are creating a custom head by editing one of the vanilla ones. You can hotload your custom head .GR2 into the game, open Character Creator, and then swap to your custom head each time you export a new version from Blender to see what your changes look like in game. Very handy! All you have to do is make sure you swap away from your hotloaded asset and back to load any new changes. For armor, you may have to un-equip and re-equip it to see the changes.

How do I do it?[edit | edit source]

To hotload, you need to create a mirror of your mod’s files inside Baldur’s Gate 3’s Data files.

For example, say one of your mods has a head .GR2 located here:


SampleMod\Generated\Public\SampleMod\Assets\HUM_F_NKD_Head_LI.GR2


You can then hotload it by creating this filepath in your BG3 Data directory:


C:\Program Files (x86)\Steam\steamapps\common\Baldurs Gate 3\Data\Generated\Public\SampleMod\Assets\HUM_F_NKD_Head_LI.GR2


Then just open the game with your .pak loaded and you should see the new head. If you replace the .GR2 inside the Data directory, swapping to another head and back should reflect the new changes without having to restart the game.


Credit to LazyIcarus for this technique!