gitwtfhub

wtf is painkiller-vr-mod?

fluorescenthallucinogen/painkiller-vr-mod — explained in plain English

Analysis updated 2026-05-18

18Audience · generalComplexity · 2/5Setup · moderate

TL;DR

A fan-made mod that adds OpenXR virtual reality support to the classic shooter PainKiller so it can be played in a VR headset.

Mindmap

mindmap
  root((PainKiller VR Mod))
    What it does
      Adds VR via OpenXR
      Works with Meta Quest 2
    Tech stack
      OpenXR
    Use cases
      Play PainKiller in VR
      Combine with other mods
    Audience
      PainKiller fans
      VR gamers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play the original PainKiller game in a VR headset like the Meta Quest 2

REASON 2

Stream the modded game to a headset using Virtual Desktop

REASON 3

Combine this mod with a separate cheats mod or stereo 3D mod by the same author

What's in the stack?

OpenXR

How it stacks up

fluorescenthallucinogen/painkiller-vr-mod0xblackash/cve-2026-462421038lab/comfyui-agnes-ai
Stars181818
LanguageCPython
Setup difficultymoderateeasyeasy
Complexity2/51/52/5
Audiencegeneralops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires manually copying files into the game folder and editing a config.ini line by hand, no automatic installer.

Wtf does this do

PainKiller VR Mod adds virtual reality support to the original PainKiller video game, an old first-person shooter made by People Can Fly and published by DreamCatcher. The mod uses OpenXR, a standard that lets software talk to many different VR headsets, so the game can be played in headsets like the Meta Quest 2 instead of only on a flat screen. The README is direct about what it needs. It requires version 1.64 of PainKiller: Heaven's Got a Hitman and or PainKiller: Battle Out of Hell. The author only tested it against the PainKiller: Black Edition release on Steam, a Meta Quest 2 headset, and an app called Virtual Desktop that streams PC games to a headset, but the mod is expected to work with other OpenXR compatible headsets too since it relies on that shared standard rather than one specific device. Installing it is a manual, drag and drop process rather than an automatic installer. A person downloads a ZIP file from the project's releases page, then copies the executable and DLL files out of that ZIP's Bin folder into the actual game's own Bin folder, replacing or adding to what is already there. After that, turning the feature on means opening a plain text configuration file called config.ini and adding one line, Cfg.VideoVR = true, then saving the file. The README also notes that this mod plays nicely alongside other mods, as long as those other mods do not themselves modify the game's executable files. The same author has two related, separate projects listed: a cheats mod for PainKiller, and a side by side stereo 3D mod for the same game, for people who want stereoscopic 3D without full VR headset tracking. Overall this is a small, focused fan project. It does not add new content to PainKiller. Instead it changes how an existing, already owned copy of the game is displayed and controlled, turning a flat screen shooter from the 2000s into something playable in a modern VR headset.

Yoink these prompts

Prompt 1
Explain how to install painkiller-vr-mod by copying files into the game's Bin folder
Prompt 2
What does adding Cfg.VideoVR = true to config.ini actually enable in this mod
Prompt 3
Help me troubleshoot OpenXR VR headset compatibility for a game mod like this one

Frequently asked questions

wtf is painkiller-vr-mod?

A fan-made mod that adds OpenXR virtual reality support to the classic shooter PainKiller so it can be played in a VR headset.

How hard is painkiller-vr-mod to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is painkiller-vr-mod for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.