Skip to content

Instantly share code, notes, and snippets.

@Diyagi

Diyagi/linuxvotvmodding.md

Last active May 25, 2026 13:06
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save Diyagi/2fa085858e6c2f3f9f75b37b46d5c036 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save Diyagi/2fa085858e6c2f3f9f75b37b46d5c036 to your computer and use it in GitHub Desktop.
Download ZIP
Linux VotV + R2Modman Setup Guide
Raw
linuxvotvmodding.md

🐧 Linux VotV + R2Modman Setup Guide

Note: This guide assumes you're running Linux with Steam and want to play Voices of the Void with mods via R2Modman.


Step 1 — Install R2Modman

Download and install R2Modman if you haven't already. Of course.

Step 2 — Add VotV to Steam as a Non-Steam Game

  1. Open Steam and add Voices of the Void as a Non-Steam game.
  2. Right-click the VotV entry → Properties → Compatibility
  3. Enable compatibility and choose your favorite flavor of Proton/Wine. 🍷

Step 3 — Set Up Your R2Modman Profile & Install Mods

Go back to R2Modman, create your profile, and start installing mods.

⚠️ UE4SS Error (Case-Sensitivity Bug)

You may see an error about R2 failing to copy ue4ss.dll. This happens because Linux is case-sensitive — R2 looks for ue4ss.dll but the actual file is named UE4SS.dll.

Fix: Navigate to the path shown in the error, for example:

~/.config/r2modmanPlus-local/VotV/cache/Thunderstore-unreal_shimloader/1.1.7/UE4SS/

and rename UE4SS.dll → ue4ss.dll. After that, all other mods should install without issues.

Step 4 — Launch the Game Once from R2Modman

Click Start Modded in R2Modman.

💡 An error will pop up — that's expected and totally fine, don't panic. We just need R2 to generate the necessary files. We'll actually launch the game from Steam later.

Important: Any time you install, uninstall, or update a mod, click Start Modded in R2 first so it can update the files before you launch from Steam.

Step 5 — Get & Modify the Launch Arguments

  1. In R2Modman, go to Help and copy the launch arguments.
  2. Paste them into your favorite flavor of text editor. 📝

Now make these edits:

a) Remove the wrapper script reference

Delete this part (everything up to, but not including, %command%):

...linux_wrapper.sh

b) Add the required Wine override before %command%:

WINEDLLOVERRIDES="dwmapi,version=n,b"

c) (Optional) Fix the in-game TV — add this before %command% too:

WINE_DO_NOT_CREATE_DXGI_DEVICE_MANAGER=1

d) Add Z: before every Linux path in the arguments.

We need that due to how shimloader works, it bypasses some of Wines unix path handling, like adding the drive letter.

✅ Your final launch arguments should look something like this:

WINEDLLOVERRIDES="dwmapi,version=n,b" WINE_DO_NOT_CREATE_DXGI_DEVICE_MANAGER=1 %command% "--mod-dir" "Z:/home/[USER]/.config/r2modmanPlus-local/VotV/profiles/Default/shimloader/mod" "--pak-dir" "Z:/home/[USER]/.config/r2modmanPlus-local/VotV/profiles/Default/shimloader/pak" "--cfg-dir" "Z:/home/[USER]/.config/r2modmanPlus-local/VotV/profiles/Default/shimloader/cfg"

Step 6 — Paste into Steam Launch Options

  1. Right-click VotV in your Steam library → Properties → Shortcut
  2. Paste your modified launch arguments into the Launch Options field.

Step 7 — Launch from Steam & Enjoy 🎮

Start the game from Steam and things should work™

🆘 Something's Wrong?

Check the UE4SS log for actual clues:

.../VotV/WindowsNoEditor/VotV/Binaries/Win64/UE4SS.log

Or ask for help in the #votv-modding channel on the VotV Discord.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment