Skip to main content

Running your mod

To load your .dll files in VotV for testing, you will need to place it into a specific folder so that the modloader can load it.

The UE4SS's docs also include info on installing your C++ mod, which you can read for some additional info. That guide assumes you are using a manual installation.

Locating your mod folder​

You will need to find the location of your installation's mod or Mods folder. Follow the following directions based on your modding installation.

In a mod manager​

Go into your mod manager's settings, and search for the button "Browse profile folder". This will open a folder in your file explorer, and from there navigate into the shimloader folder, and into the mod folder. Then follow the next steps.

In a manual installation​

Go to the location of your download of VotV, then navigate to the \VotV\Binaries\Win64\ue4ss\Mods directory. Then follow the next steps.

Creating your mod's folder​

Once you are in your mod folder, you will see some other files and folders such as "BPML_GenericFunctions". Here you will need to create a new folder, and name it the exact name your mod uses.

Once you have done that, enter that folder and create a folder named dlls, and inside that folder place your dll file. Your dll can be either named <the name of your mod>.dll, or just main.dll.

📂 mod/Mods
    📁 MyExampleMod
        📁 dll
            📄 MyExampleMod.dll
                OR
            📄 main.dll

Finally, to enable your mod, you can either:

  • Create a blank enabled.txt file in your mod folder (alongside your dlls folder). This force-enables the mod.
  • Add a line of text like <My modname> : 1 to the mods.txt file in the base mod folder. Make sure to place your text before the keybinds : 1 line.

Automating the process​

Repeatedly copy+pasting the file and renaming it every time you want to test it can become very annoying and repetitive, so I recommend making a small batch file or script that simply helps copy and rename the file automatically for convenience.

For example, a batch file on Windows would have a single command that would look like this:

copy /y "<path to your mod project>\build\MyExampleMod\Game__Shipping__Win64\MyExampleMod.dll" "<path to your mod folder>\MyExampleMod\dlls\MyExampleMod.dll"

Running this file will copy the file over and rename it, rewriting the old pak file while its at it.