Editing Modding:Installing mods

{{PageSeo
|title=Modding Resources
|description=This page is a hub for everything related to Modding Baldur's Gate 3. Check out the following guides to learn how to mod BG3.
|image=Modding_resources.webp
}}{{NavModding}}Having trouble with your installed mods? See our [[Modding:Mod troubleshooting|Mod Troubleshooting]] page.
*Script Extender (bg3se) by Norbyte
**[https://github.com/Norbyte/bg3se/releases/tag/updater-20231028 Latest Version Found here]
** Can be installed manually or by using BG3MM: Tools -> Download & Install the Script Extender
** Updates itself when starting the game
*BG3 Mod Manager (BG3MM) by LaughingLeader
** [https://github.com/LaughingLeader/BG3ModManager/releases Found here]
== Baldur's Gate 3 Mod Manager ==
Before doing any of these steps, please ensure that you have downloaded the [https://github.com/LaughingLeader/BG3ModManager/releases Baldur's Gate 3 Mod Manager] (simply scroll down to the Setup instructions and click on the highlighted "Grab the latest release."). Please note that as of Patch 9 in EA, your profile within the mod manager must be set to "Public" to use the mod manager properly. This option will be at the top left of the mod manager.
# Find the mod you would like to download and download the file. This is usually a zip file. When downloading mods from Nexus Mods, make sure to select "Manual Download" to have the file downloaded to your computer.
# Open the zip file. This is quite simple, all you need is a folder unarchiving software such as [https://7-zip.org 7zip]. Double click the zip file and open it with the software. The zip file usually contains an {{c|info.json}} JSON file, {{c|README}} text document, and the actual mod itself which will be a {{c|.pak}} file. 
# In another window, open your file explorer and go to the mod folder for Baldur's Gate 3. The mod folder will be located at a location generally named {{c|C:\Users\<yourusername>\AppData\Local\Larian Studios\Baldur's Gate 3\Mods}} . Please note that the {{c|\AppData\}} folder is hidden by default. To be able to easily access it as well as other hidden folders, click "View" at the top left of the file explorer and check mark the "Hidden Items." box.
# Go back to the window of the zip file, and drag the mod's {{c|.pak}} file into the "Mods" folder for BG3.
# Open the BG3 Mod Manager. The mod you just dragged into the Mods folder should appear on the right of the screen. If it does not, try clicking Refresh above it. The Patch 3 Mod Fixer is an exception, and does not appear in the mod manager nor does it need to be activated. Repeat steps 1-4 for all the mods you want.
# Click and drag all the mods to the left side of the screen. Please note that load order can be crucial for some mods, so make sure to put mods that other mods are dependent on '''above''' them in the load order. Once you have dragged all the mods you would like to use to the left side of the screen, make sure to save your load order by clicking the save button beside the "Mod Order" label. 
# Export your order to the game by clicking the first icon beside the word "Export" at the top bar. 
BONUS STEP FOR DIRECTX 11 USERS: You will need to enable DirectX 11 mode for the mods to work if you are using that version of the game. Simply click "Settings" in the top most bar, click on "Open Preferences", tick "Enable DirectX 11 Mode" then click on "Save" at the bottom. 
<br>
Launching the game: You will need to launch the game through the mod manager for most of the mods to work properly. At the top bar, beside "Shortcuts", there are a few icons; a file icon that will automatically open the Mods folder mentioned in step 3, an icon that opens the workshop folder, an icon that opens the logs, and the BG3 icon. Click on the BG3 icon to launch the game. The launcher should open and you should be able to simply press play and enjoy your mods. Note that some mods need you to turn off the sending of analytical data to Larian, which you can do at the launcher by simply going into settings at the bottom left.


For mods that aren't {{c|.pak}} files, you will need to follow any instructions the mod author has posted. Usually, mods that replace base game files need to be placed in the downloaded files, usually in {{c|Program Files(x86)}} then the app you used to download the game, then in {{c|Baldurs Gate 3\Data}} or {{c|bin}}. Be sure to follow the mod author's instructions.

== Manually ==
# Download the mod(s).
# Unzip into the [[Modding_the_Game#Paths|Mods folder]] using a program like [https://7-zip.org 7zip].
# If the mod comes with its modsettings code in the description or pinned in the Posts section use that.
## Add the mod to the <code>modsettings.lsx</code> file located in [[Modding_the_Game#Paths|PlayerProfiles/Public]].
## Save and exit.
# If no code is provided you'll have to make it yourself. This is easy.
## Open <code>Larian Studios/Baldur's Gate 3/PlayerProfiles/Public/modsettings.lsx</code>.
## Copy and paste the GustavDev entry below itself. From <code><node id="ModuleShortDesc"></code> to the closing <code></node></code>.
## Change '''Name''', '''Folder''', and '''UUID''' to match the <code>info.json</code> that should have come with the mod you are currently installing.
## Save and exit.
# Repeat either 3 or 4 as needed for each mod you want to install.
# Set <code>modsettings.lsx</code> to read only. If this isn't done, the game will overwrite the file and changes will have to be made again.
<br>
If the mod you are installing doesn't come with an <code>info.json</code>, ask the mod author nicely to either provide one or supply the code for manual install. 
=== Mod Order ===
Some mods have load order requirements. In the example below, the section with <code><node id="ModOrder"></code> determines what order your mods are loaded in. BG3MM and Vortex do this automatically, but if you're on Mac or Linux it's very important to set this up correctly if you have lots of mods installed.
<br>
'''Gustav''' should always be the first item loaded in this file as it's the whole game.
<br>
The mod order you need depends on what the descriptions of each mod you have says. Please carefully read the description, comments, and bugs sections of any mod you download.

==== Example Modsettings File ====
File from [https://www.nexusmods.com/baldursgate3/mods/87 Basket Full of Equipment. SFW version (Full Release v1.0.8b)].
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<save>
  <version major="4" minor="0" revision="8" build="2" />
  <region id="ModuleSettings">
    <node id="root">
      <children>
        <node id="ModOrder">
          <children>
            <node id="Module">
              <attribute id="UUID" value="28ac9ce2-2aba-8cda-b3b5-6e922f71b6b8" type="FixedString" />
            </node>
            <node id="Module">
              <attribute id="UUID" value="b200f917-43ec-45d9-9dff-ac6191d62388" type="FixedString" />
            </node>
          </children>
        </node>
        <node id="Mods">
          <children>
            <node id="ModuleShortDesc">
              <attribute id="Folder" value="GustavDev" type="LSString" />
              <attribute id="MD5" value="41a80562831251b58df743c05a7af21b" type="LSString" />
              <attribute id="Name" value="GustavDev" type="LSString" />
              <attribute id="UUID" value="28ac9ce2-2aba-8cda-b3b5-6e922f71b6b8" type="FixedString" />
              <attribute id="Version64" value="144396877804629717" type="int64" />
            </node>
            <node id="ModuleShortDesc">
              <attribute id="Folder" value="BasketEquipmentSFW" type="LSString" />
              <attribute id="MD5" value="" type="LSString" />
              <attribute id="Name" value="BasketEquipmentSFW" type="LSString" />
              <attribute id="UUID" value="b200f917-43ec-45d9-9dff-ac6191d62388" type="FixedString" />
              <attribute id="Version64" value="144115196665790673" type="int64" />
            </node>
          </children>
        </node>
      </children>
    </node>
  </region>
</save>
</pre>

== Vortex ==
This section requires instructions.

However most mods do not recommend you use Vortex over BG3MM, as it is has been known to cause issues.
[[Category:Modding guides]]