Baldur's Gate 3 mod manager: Essential Setup Guide

Managing modifications for Baldur's Gate 3 requires precision to ensure stability and compatibility. The community-standard tool for this purpose is the BG3 Mod Manager. This guide provides a factual overview of how to install, configure, and utilize this tool effectively to manage your custom content.

Getting Started with the Mod Manager

The BG3 Mod Manager is a portable application designed to interface with the game's file structure. Before downloading or attempting to use the tool, it is essential to ensure your environment is prepared correctly.

Initial Game Setup

Before the manager can function, the game needs to generate the necessary directory structures. If you have not done so already, launch Baldur's Gate 3 at least once. This process creates the required profiles and the Mods folder where your files will eventually reside.

System Prerequisites

To run the manager, your system must have the following installed:

• .NET 8.0: The framework required to execute the manager's code.
• C++ Redistributable: The latest version is necessary for the tool to interact with game data files properly.

Once these are installed, download the latest release from the official GitHub repository. Because the manager is portable, avoid extracting it into your Program Files directory, as this can lead to permission issues. Instead, place it in a non-protected folder where you have full read and write access.

Configuring the Manager

Once you have extracted the files, run BG3ModManager.exe. In most cases, the software will automatically detect the pathways to your game’s executable and data folders. If the auto-detection fails, you must manually set these paths:

1. Open the application.
2. Navigate to Settings then Preferences.
3. Set the Game Data Path to the folder containing your game's .pak files (such as Gustav.pak).
4. Click Save and then click the Refresh button to force the manager to load your campaign mod data.

It is critical that you verify your campaign selection within the manager. Ensure a campaign, typically labeled "Main," is selected. The game requires a valid campaign to be exported to the modsettings.lsx file; failing to do this often results in the game failing to load the main menu scene or encountering other critical errors.

Managing Your Load Order

The primary function of the mod manager is to organize the order in which files are loaded by the game engine. This is done through the modsettings.lsx file.

Exporting the Load Order

After you have dragged and dropped your desired mods into your preferred order for the Public profile, you must export this configuration to the game. You can do this by clicking the Export Load Order to Game button or by selecting File > Export Order to Game. This action updates the modsettings.lsx file, which the game reads every time it launches.

Avoiding Common Pitfalls

• Subfolders: Never place mods in subfolders within the %LOCALAPPDATA%\Larian Studios\Baldur's Gate 3\Mods directory. Doing so will cause the game to reset your modsettings.lsx file automatically.
• Error Resetting: If you notice your modsettings.lsx file is resetting every time you load the game, this is a sign that one or more of your mods are encountering an error, forcing the game to clear the load order to maintain stability.
• Dependencies: When highlighting a mod in the list, the manager will display its description and dependencies. If you see a dependency highlighted in red, it means that specific file is missing from your setup.

Advanced Features and Tools

Beyond basic load order management, the tool offers several features for both casual users and mod authors.

Utility for Players

• External Backups: You can save your mod load orders to external JSON files. This is useful for backing up your setup or sharing your specific configuration with friends.
• Importing: You can import load orders directly from save files, which is helpful if you are returning to a specific playthrough and need to restore the exact configuration of mods used at that time.
• Exporting Data: The manager allows you to export your load order into text formats or spreadsheets. These exports often include additional metadata, such as the mod's source URL.

Features for Mod Authors

For those creating content, the manager provides tools to streamline development:

• Version Generator: Located under the Tools menu, this allows you to generate the correct version numbers (major, minor, revision, build) for your projects.
• Extraction: You can extract selected mods with a few clicks, which is useful for studying how other mods are structured.
• Custom Tags: If you are a creator, you can specify custom tags in your meta.lsx file. Separating these with a semi-colon allows the manager to display them within the UI.

For more information on general gameplay or specific character development, you may want to review our Baldur's Gate 3 builds or learn more about the Baldur's Gate 3 classes to ensure your mods do not conflict with your character progression.

Source-aware planning notes

Mod guidance should stay focused on discovery, compatibility, and reader verification rather than promising a particular load order. Use the collected pages as community context, keep backups before changing files, and check the official mod-support information for current boundaries. Do not repeat an unverified download claim, version number, or troubleshooting step as fact; label it as a report or omit it. Use the article's headings as a worksheet: write down the confirmed premise, the next action, and the point at which you need to verify a newer source. This approach keeps the guide useful for a first pass while making its limits visible. It also prevents a concise community summary from being mistaken for a complete rulebook. When you adapt the advice to a different party, difficulty, platform, or patch, preserve the original wording and add your own observation separately. A careful note is more valuable than a confident detail that the collected evidence cannot support.

FAQ

How do I fix the game resetting my load order?

If your modsettings.lsx resets, ensure that you have no subfolders within your Mods folder. Additionally, if a mod is faulty or causing an error, the game will automatically clear the load order to prevent crashes. Check the manager for red, missing dependencies.

Where should I extract the mod manager?

Extract the files into a non-protected folder on your computer. Do not place the manager inside your Program Files or Program Files (x86) folders, as these locations often have restricted permissions that interfere with the manager's ability to save settings and edit files.

Does the manager come with an official website?

No. According to the developer, there is no "official website" for this tool. It is hosted exclusively on the official GitHub repository. Always ensure you are downloading the manager from that specific source to maintain security.