The Witcher 3 Modding Guide for Steam Deck (Linux)

[RasitAyaz]

Updated at 17 November 2024

This is a simple guide on how to set up The Witcher 3 Mod Manager and Script Merger on your Steam Deck running SteamOS. Enter desktop mode and let's get started.

 

Protontricks

• Install Protontricks from Discover store. It is a wrapper script that allows you to easily run Windows executables and Winetricks commands for Steam Play/Proton games. We will use it to run Mod Manager and Script Merger.

• Mod Manager and Script Merger will ask for you to locate your game installation folder. Based on your installation, your game directory should appear in;

• Internal storage: "Z:/home/deck/.steam/steam/steamapps/common"

• SD card: "E:/steamapps/common"

• If your game is installed in internal storage, you need to enable hidden files using Protontricks. Open "Protontricks > Select the default wineprefix > Run winecfg > Drives" and check "Show dot files" box.

 

Script Merger

• I suggest using the New Script Merger by Phaz42 as it has bunch of useful features that makes the process much easier if you're dealing with large number of mods. But you can also use the Original Script Merger.

• Original script merger should work right away when you run it with protontricks. But the new one requires some extra steps, which are explained in 'Steam Deck' section of the mod's description.

 

Mod Manager

• Download Mod Manager, extract to folder, run the executable with Protontricks app and select The Witcher 3 from the game list. This will make it run on TW3's wineprefix.

• It should ask for "witcher3.exe" location, select "bin/x64/witcher3.exe" or "bin/x64_dx12/witcher3.exe" inside your game installation.

• Also locate your Script Merger executable from top menu: "Settings > Configure Settings > Change Script Merger Path".

 

You're ready to go, start installing your mods! Here's a mod I recommend to replace Steam Controller input hints with Xbox hints:

• Steam normally forces Steam Controller icons on the game UI for the deck, you can replace them with Xbox or PlayStation icons using this mod.

Edited April 26 by RasitAyaz

[PIrKo22]

Thx for the guide. I cant make it work. Can u make a video guide?

[RasitAyaz]

  On 10/3/2023 at 3:12 PM, PIrKo22 said:

Thx for the guide. I cant make it work. Can u make a video guide?

at what part did you stuck?

[dphans]

Can you provide absolute path of "Home/Documents", the path "/home/Documents" is correct, isn't it?

[RasitAyaz]

  On 2/13/2024 at 6:51 AM, dphans said:

Can you provide absolute path of "Home/Documents", the path "/home/Documents" is correct, isn't it?

Expand  

you probably figured it out by yourself a month ago but it should be /home/deck/Documents

Edited March 10, 2024 by RasitAyaz

[RAIDEROFTHELASTARCH]

Excellent guide Rasit!

I've looked everywhere on Dolphin but i cannot find  'Home/.steam/steamapps/compatdata/292030/pfx/drive_c/users/steamuser/Documents'.

Any advice?

It would be much appreciated...

With my thanks.

 

[RAIDEROFTHELASTARCH]

Finally found it.

Thanks a million....

[RAIDEROFTHELASTARCH]

Hi

I'm back with another question:

Managed to successfully launch both the Mod Manager and the Script Merger;

But then the Mod Manager started: [finishing for prefix "Witcher 3". Exit code is: "-1"] and kept quitting and not opening.

Can anything be done about it? Can the Mod Manager made to stop shutting down Rasit?

Awaiting your kind reply.

With my thanks.

 

[RasitAyaz]

@RAIDEROFTHELASTARCH late response but I've completely revamped the guide by following a much more simpler approach. you can check it out if you're still having issues.

[bschwartz525]

Thank you very much for the guide.  I have Script Merger installed now, and directed to my game location.  It detects the mods I have installed, however it's not recognizing any conflicts!  The game, however, still refuses to launch.