¶ Installing Mods
Below is a guide on how to install mods for Single Player Tarkov, as well as common issues which users encounter and how to fix them.
¶ Before installing your mods
You can find mods for SPT on The Forge. The Forge is the main hub of mods for SPT, and is the only place to get mods which are supported in the SPT Discord.
It is highly recommended that you download and install 7-Zip before you proceed to install mods. Other archiving programs such as WinRAR are known to have corrupt files upon extracting without telling you. 7-Zip has a much lower chance of this happening, as well as informing you should there be an issue.
Notepad++ is another useful tool to have installed. It simplifies editing config files, and will let you know if there’s any formatting issues with the edits you made.
Make sure that you have already loaded SPT up to the main menu or stash as outlined in the Installation Guide.
When selecting the mods you want to install, make sure that you only install mods that have been updated to your SPT version. If you are unsure what version of SPT you are on, you can see the SPT version in the top left of the server window or in the bottom left while in-game.
Read the modpage of the mods you want to install. The majority of the time the mod page contains important information as to what to expect from the mod, how to install the mod, how to configure the mod and incompatibilities with other mods. It is important that you read the modpages as this will help you identify issues you may encounter in game.
SPT MUST BE FULLY CLOSED BEFORE YOU INSTALL MODS
¶ Installing Mods
- Open the mod archive using 7zip
- If the mod archive has a
BepInExoruseror both folders, drag and drop the contents of the archive to the empty space in your SPT folder - If the mod archive has just a folder or files, read the mod page for install instructions
- For mods that go into your
userfolder, drag and drop the mod folder intouser\mods - For mods that go into your
BepInExorplugins, drag and drop the mod folders and files intoBepInEx\pluginsfolder
¶ Profiles
Nearly all mods can be added to an existing profile. However, removing some mods might be impossible without making a new profile. Mods that add new traders, quests, or items will require a new profile. Always read the modpage, as the author should specify if a mod is unsafe to remove from a profile.
If you removed a mod that broke your profile, you can attempt to fix it by changing removeModItemsFromProfile and removeInvalidTradersFromProfile to true inside SPT_Data\Server\configs\core.json. This is not guaranteed to work. SPT will do the best it can to remove any item that’s in your profile from the removed mod, but some mods make irreversable changes to your profile.
¶ Load order
You do not need to edit your load order manually unless a mod specifies you to do so. By default, with an empty order.json SPT loads mods alphabetically from A to Z. Mods expect to be loaded in that order.
Mods that load first get overridden by those loaded later. However, they will only override the values they both alter, not the entire mod.
If you need to edit it, you should use a tool like Load Order Editor or Load Order Editor Drag-Drop. Your edited load order should still be A to Z, with only few mods moved.
To create a new, empty load order, delete your user\mods\order.json. SPT will create a new one the next time you run it.
Note: Mods like SVM can override/break any mod loaded before it, so it’s recommended to load it first.