Nexus Mods to Toolkit Project Converter

Convert a third party Mod project to a Toolkit project.

For use when porting third party mods to the toolkit or when you lost your editor files.

Make sure to read the instructions first

Uses Python. Run "pip install -r requirements.txt" to install the required libraries.

Unpack any .pak files and put all files you want to convert into a folder named "convert" inside the root of the script. You can also drop an entire project into it.

run "py Convert2Toolkit.py" to start conversion.

Optionally you can download the exe version instead, you wont need to configure any python stuff.

Make sure to add your BG3 installation path to settings.json as follows: "C:/any/folder/until/Baldurs Gate 3/"

This will enable the converter to read all IDs from your BG3 installation and mods to use them in conversion.

If you dropped an entire mod into the conversion folder it will try to setup a project to be used with the toolkit.

If you get any errors about files not existing you probably need to enable long path names.

After project conversion, just paste the contents of the newly created folder into your BG3 Data folder: "/convert/NewMod_uuid/" -> "/Baldurs Gate 3/Data/"

You need to paste the contents of the new "/NewMod_uuid/" folder into your Data folder, not the folder itself.

Visit the github page for more info and the latest updates: https://github.com/Eclip5eLP/bg3-convert2toolkit

You can also join the Larian Discord and get more information there: https://discord.com/invite/larianstudios

The converter is not perfect yet and might still have some quirks, feel free to report any bugs or ask away if you have any questions. Some things like custom VFX files are not supported yet.

Make sure to grab any updates from github. This page will only have the initial download, any updates can be found on github.

Examples of mods I have ported using this:

Moon Head Preset

Wielder Class

Mantis' Tiefling Duo Presets

(Credits to each respective original creator)

They only took seconds to convert and minutes to upload.