Get Baldur's Gate 3 mods working on Steam Deck
— Tutorial, Steam Deck — 3 min read
Here's how you can get Baldur's Gate 3 mods to work on your Steam Deck. You'll need a Windows PC and a way to share files between it and the Deck.
I wanted to play Baldur's Gate 3 on my Steam Deck with mods, but I couldn't get them working. I followed a guide, but ran into problems — I couldn't install the BG3 Mod Manager (to be precise, its .NET dependency). So, here's how I got those mods working without having to mess with Lutris and multiple Wine prefixes.
NOTE: All the mods I installed were
.pak
files I had to add to theMods
folder. I haven't used any mods that modify textures, quests or dialog. This approach might not work for these mods, or you'd have to copy additional files.
Before you start
-
Install Baldur's Gate 3 on a Windows PC. Mine runs Windows 10.
-
Run the game once to make sure it creates the folder structure.
-
Install the game on the Steam Deck.
-
If you've played the game already, back up your save files:
-
Windows:
C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\PlayerProfiles\Public\Savegames\Story -
Steam Deck, in Desktop mode:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/PlayerProfiles/Public/Savegames/Story
-
Install and transfer the mods
On Windows:
-
Install Baldur's Gate 3 Mod Manager.
-
Download and install the mods you want, for example from Nexus Mods.
Most mods' instructions recommend the "Manual" download, and installation with the BG3 Mod Manager.
-
In BG3 Mod Manager, after you've installed all mods, make sure you select the Export Order to Game button.
-
Run the game to see if the mods work.
-
Save your game in a new save file.
-
Copy the following folders and files:
-
The
Mods
folder:C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\ModsTo the Steam Deck, in Desktop mode:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/ModsIf the
Mods
folder doesn't exist on the Steam Deck, create it. -
The
modsettings.lsx
file:C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\PlayerProfiles\Public\modsettings.lsxTo the Steam Deck, in Desktop mode:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/PlayerProfiles/PublicThe
modsettings.lsx
file is what BG3 Mod Manager updates with the mod order when you select Export Order to Game.
-
-
On the Steam Deck, switch back to Gaming mode and run the game. Your mods should now be working!
Workaround for mods getting disabled
Unfortunately, the above didn't guarantee a permanent solution for me.
Sometimes, after I reboot my Steam Deck, the modsettings.lsx
file gets back to its previous, unmodded state.
I guess Steam does this when regularly verifying game files.
Here are two workarounds, manual and kinda-automated-but-still-manual.
Manual:
-
Change to Desktop mode and copy the
modsettings.lsx
file again, from your backup to:/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/PlayerProfiles/Public -
Launch the game from either mode, but don't restart the Deck.
Less manual:
-
Create a script to copy the
modsettings.lsx
file. Edit the first path to where you have saved it:#!/usr/bin/bashyes | cp -rf /home/deck/Sync/BG3/modsettings.lsx /home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian\ Studios/Baldur\'s\ Gate\ 3/PlayerProfiles/PublicThe
yes
command is necessary so you won't be prompted to confirm the copy. -
Save the file as
fix-bg-mods.sh
. -
Make the script executable:
- Right-click the file and select Properties, then the Permissions tab.
- Select the Is executable checkbox.
- Select OK.
-
Add the script to Steam: Right-click the file and select Add to Steam.
Now, whenever you get that error, quit the game, and run fix-bg-mods.sh
from SteamOS.
It's still semi-manual, but at least you don't have to switch to Desktop mode.
File locations reference
Save files
Windows:
C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\PlayerProfiles\Public\Savegames\Story
Steam Deck:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/PlayerProfiles/Public/Savegames/Story
Mods folder
Windows:
C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\Mods
Steam Deck:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/Mods
modsettings.lsx
file
Windows:
C:\Users\your-user\AppData\Local\Larian Studios\Baldur's Gate 3\PlayerProfiles\Public
Steam Deck:
/home/deck/.local/share/Steam/steamapps/compatdata/1086940/pfx/drive_c/users/steamuser/AppData/Local/Larian Studios/Baldur's Gate 3/PlayerProfiles/Public