Modding The Witcher 3 with Vortex
The Witcher 3: Wild Hunt
The Witcher 3: Wild Hunt is a 2015 action role-playing game developed and published by CD Projekt.
Genre: Action RPG
This guide is designed to help you set up Vortex to install and manage mods for The Witcher 3: Wild Hunt.
- 1 Requirements
- 2 Getting Set Up
- 3 Managing your W3 Load Order
- 4 Troubleshooting
Before we get started, this guide assumes that you have installed The Witcher 3 and Vortex at their default locations. You will also need to be logged in to your Nexus Mods account in Vortex. Other than that, if you are planning to use more than 3-5 mods, it is recommended to set up the Witcher 3 Script Merger.
Getting Set Up
To begin, open up Vortex and navigate to the games section. If you don’t already see Witcher 3 under the “Managed” tab, check the “Discovered” section. Use the “Manage” button on the game tile to add it to your managed games.
xImage Witcher 3 unmanaged
If you can’t see Witcher 3, you can scan for it or define it manually.
Managing your W3 Load Order
|This content applies to Vortex 1.2.0 and above.|
As of Vortex version 1.2.0, you can manage your Witcher 3 load order directly in Vortex via the "Load Order" tab.
- You can drag and drop mods anywhere in the list to create the load order you want.
- For Witcher 3 (this may be different for other games) the topmost mod overrides the other mods (only if there are conflicts). In other words, the mod with the lower index number will override a mod with a higher one (a mod that is further down the list). In Witcher 3 the first mod to load wins the conflict. This is important when deciding on which mod to sort before another if they both do the same or similar things (e.g. texture replacers which affect the same things in the game).
- "Merges" generated by the Witcher 3 Script Merger have to load first and are automatically locked to the first slot in the load order.
- Vortex will only pick up on mods that you have installed via Vortex. If you have manually installed some of your mods, you need to add them by either editing your mods.settings file, or by reinstalling them with Vortex. Both options are explained below.
Adding manually installed mods
If you have previously installed mods manually by unpacking them into the Witcher 3 mods folder, Vortex (or any other mod manager) does not know about them and they will not be loaded by the game.
However, there are two simple ways to add manually installed mods so they show up in the load order tab within Vortex:
Adding mods to the mod settings file
For our example, we will take a look at what your Vortex/mods setup would look like if you had two mods. One installed with Vortex, and one installed manually (by dropping the contents of an archive into the Witcher 3 mods folder).
The above is what the contents of your mods folder would be. However, since only one of these mods is installed with Vortex, only that one would show up in the mod list in Vortex:
Likewise, only this one mod would show up in the "Load Order" tab:
The mod we had installed manually "modManuallyAddedExample" needs to be added to the "mod.settings" file which is a file that can be found in C:\Users\YourUsername\Documents\The Witcher 3:
Open that file and insert the exact name of the mod you want to add as it appears in the Witcher 3 mods folder in square brackets. In our example it would look like this:
You DO NOT have to add or worry about "Enabled, Priority, or VK" - Vortex will apply those parameters automatically the next time you deploy.
Now, go back to your Vortex Load Order tab and click "Refresh" as shown in the image:
This should bring up the recently added mod:
Make sure to hit the "Deploy Mods" button once you are done so Vortex can update the mod.settings file to add the needed parameters.
Optional: You can double-check that everything went smoothly by checking your mod.settings file again (after refreshing and deploying). It should have added the Enabled, Priority, and VK parameters for the mod we just added:
Reinstalling mods via Vortex
The other option is to simply zip up the mod/mods you have installed manually and install them again via Vortex.
- Navigate to your Witcher 3 mods folder (typically this would be in: C:\Program Files (x86)\Steam\steamapps\common\The Witcher 3\mods
- zip up the mod you want to reinstall with Vortex
- Important: Make sure to delete the manually installed mod from the Witcher 3 mods folder.
- Drag and drop the zip archive into the Vortex drop zone (at the bottom of the mods tab)
The mod will now be added and can be installed with Vortex:
For older versions of Vortex
IMPORTANT NOTICE: Managing your load order is only supported in Vortex 1.2.0 and above. If you are using an older version of Vortex, please update as you are missing out on the most powerful features of the Witcher 3 game extension.
My mod does not work/is not recognised by the game. Why is that?
If your mod is seemingly ignored by the game, make sure it actually shows up in your load order. A mod that does not show in the load order tab in Vortex will not be loaded by the game. Make sure it is actually installed and enabled. If it is a mod that you have installed manually, you will need to add it to the mod.settings file or reinstall it via Vortex (see above).
I'm getting a security prompt each time I install a mod, can I stop that?
Depending on your settings, Vortex may select "Symlink Deployment (Run as Administrator)" as the default deployment methos. This is perfectly fine to use but will require you to accept a security prompt from Windows each time you deploy or change your mods.
To avoid this, you may want to go to Settings > Mods and change the deployment method to "Hardlink deployment", then click "Apply". This will require one final security prompt to save the change.
See also: Deployment Methods