SPT-VR brings the immersive, intense experience of Tarkov into the realm of virtual reality. Engage in intense firefights, loot dangerous environments, and survive the unforgiving world of Tarkov—all in full VR.
SPT-VR (Single Player Tarkov VR Mod)
SPT-VR (Single Player Tarkov VR Mod)
SPT-VR brings the immersive, intense experience of Tarkov into the realm of virtual reality. Engage in intense firefights, loot dangerous environments, and survive the unforgiving world of Tarkov—all in full VR.
Table of Contents
Setup
Prerequisites
- Single Player Tarkov (SPT) Installation: Make sure you have a working copy of SPT installed.
- SteamVR: The mod requires SteamVR to support VR hardware.
Installation Steps
- Ensure SPT is up to date: Make sure you have the latest version of SPT installed on your system.
- Download the latest release: On the right side of this page (if on GitHub), download the latest release from the “Releases” section.
- Navigate to SPT’s root directory: This should contain the SPT.Launcher, SPT.Server files, and the BepInEx folder.
- Extract the downloaded files: Merge the folders from the release with the folders in the SPT installation.
- Launch SteamVR: Ensure that SteamVR is running and your headset is connected before launching the game.
- Launch the game through the SPT Launcher.
Uninstalling
To uninstall the mod, go to your SPT installation and remove the BepInEx/plugins/sptvr/SPT-VR.dll file, which will stop the game from launching in VR. To reinstall it, simply drag the .dll file back into the directory.
Controls
Movement
- Walking: Left joystick.
- Look around: Right joystick.
- Sprint: Click the right joystick.
- Jump: Push the right joystick up.
- Vault: Hold the right joystick up at a ledge.
- Crouch: Pull down on the right joystick, physically crouch, or do both.
- Prone: Fully crouch, release the joystick, then pull down again.
Weapon Controls
- Fire: Right trigger.
- Two-hand weapon: Support the gun with the left grip when it vibrates (toggle option available).
- Aim: Looking down the sights automatically increases accuracy.
- Steady aim: Hold the left trigger to hold your breath.
- Weapon interaction mode: Hold the right grip when not aiming to interact with the weapon:
- Check Magazine
- Reload
- Inspect Weapon
- Fix Malfunction
- Toggle Tactical Devices
- Change Tactical Device Mode
- Toggle Firemode
- Fold Stock (not implemented yet)
- Reload: Press B or use the interaction mode.
- Toggle Firemode: Press A or use the interaction mode when two-handing.
- Change red dot/holo mode: Press the left grip when your hand vibrates near the sight.
- Change optic zoom: Pull the right joystick or rotate the left hand near the scope.
- Grenades: Select from the quick slot radial menu, then hold the right trigger to pull the pin and aim using your in-game pointer finger.
In-Game Interactions
- Swap Weapon:
- For a pistol, bring your right hand to your hip and press the right grip.
- For primary weapons, bring your right hand to your shoulder and press the right grip.
- Use the radial menu by holding the right grip at your shoulder.
- Quick Slot Items: Open the radial menu by bringing putting left hand to your left side and gripping (don’t look left when doing this, it’ll move the collider)
- Interacting with doors/containers/bodies/loose loot/etc:
- Through a menu by looking at the object, which will bring up the menu where you’re looking, then using the right joystick you can navigate it and use the A button to select an option.
- Bring your left hand up to the object and press the left grip to perform the primary operation, or with loose loot you can hold the left grip to pick it up and bring it over your left shoulder and release to place it in your inventory if there is room.
- Toggle head visor/night vision: These can be toggled by bringing the left hand up to your head and pressing the left grip.
Menus & Menu Interactions
- Select: To interact with menu items, buttons, etc, press the A button while hovering over it with your laser pointer.
- Open Inventory: Press X while in a raid.
- Open Menu: Press Y while in a raid.
- Dragging Items: Hold the right trigger to move items.
- Opening Item Sub-Menu: While hovering over an item, hold down the A button to bring up a dropdown menu for that item.
- Opening Item Display Window: Double tap A while hovering over an item to open the item display window.
- Quick Equip: While holding the left grip, pressing the A button on an item will automatically equip it to its respective slot.
- Quick Transfer Item: While holding the right grip, pressing the A button on an item will automatically transfer it in or out of your inventory.
Configuring your experience
If you go into the Tarkov settings menu, you will see a VR tab, which allows you to modify some of the VR-specific settings.
Performance Guide!
So, there’s a lot of people that think this mod is impossible to play and actually have decent performance. That is not true unless you’re going to streets of course which runs horrible even on flatscreen. So here’s what I suggest to get the best performance.
For reference my specs -
RTX 3080 10GB
32GB of ram
Ryzen 5 7600x
NVME SSD
- Set all graphics settings to lowest/off except textures, shadows, anisotropic, and LOD/visibility (set those to whatever you want) AA should always be set to FXAA, nothing else works
- Check boxes on graphics settings at bottom, Grass shadows, high quality color, and streets low quality textures. Everything else unchecked, volumetric lighting is your preference
- Install VRPerfKit - https://github.com/RavenSystem/VRPerfKit_RSF/releases
- Open the .yml file in notepad for perfkit and change renderscale to like 30
- In SteamVR settings set resolution for tarkov to something really high, I set mine to about 400% with my valve index (this step and 4 can be adjusted based on the VRAM you have available on your graphics card and which headset you use, you may be able to go higher, my graphics card only has 10GB of VRAM)
- Learn how to use a headless fika client, there’s videos and guides online (this is the biggest improvement you can get in performance) even running the headless on your own PC will be a pretty good help, if you do run it on your own PC, you should have at minimum 32GB of RAM
- Install a bot spawner mod such as MOAR or ABPS, these are also big helps to performance because the main killer of performance in SPT is the AI. These mods are much better at managing spawns.
- Last thing I’d suggest which may not apply for many people, I disable my 4k monitor whenever I play which seems to help a bit.
FAQ
What controllers and headsets are supported?
The mod supports most VR headsets. The following controllers work out of the box:
- Quest 2/3
- Valve Index
- Vive
If your controller isn’t working, configure the control scheme through SteamVR bindings.
Does this work with the non-SPT Escape From Tarkov?
No, using this mod with the official version of Escape From Tarkov can result in a ban.
Does it support FIKA?
Yes, it supports FIKA. VR players will appear as non-VR players in multiplayer. Experimental support currently, it’s not very stable.
Are other mods compatible with the VR mod?
Several mods have been confirmed to work. However, mods that add a new UI may not work, new guns might be missing features, and some graphics mods may cause issues. Please remove all incompatible mods before reporting any bugs.
Current list of known compatible mods:
- FIKA
- Amands Graphics
- Swag + Donuts
- SAIN
- EFTApi Disabled for now
- Waypoints
- Declutterer
- Questing Bots
- BigBrain
Do I need to buy this mod?
No, the mod is free, and the source code is open-source.
Contributions
A huge thank you to these primary testers who helped shape the mod:
- groundzeroday: Check out his work at hexler.net
- Havviks: Thanks for making the trailer, go watch his videos on YouTube
- MaTSix: Offered a lot of helpful ideas which greatly decreased the jankiness of the mod
Get in contact
If you want to reach out to me personally, you can send an email to [email protected]
Development Environment Setup
If you wish to make your own changes to the mod or want to check it out for any purpose, follow the steps below:
- Clone the Repository: This can either be done by downloading the source code from the GitHub page or using the command below: git clone https://github.com/cybensis/SPT-VR.git
- Open it in your IDE: I’ve only ever used Visual Studio for development, so I would recommend using that. Opening the .sln file will open Visual Studio, which should already be configured to build without issue.
- Make your changes and build: After making your changes, to test them simply go to the Build dropdown menu at the top of Visual Studio and select Build Solution.
- Add the build to your SPT installation: After building the mod, you should find the new file under bin/Debug/TarkovVR.dll or bin/Release/TarkovVR.dll depending on whether you’ve built a debug or release version. Then, in your SPT installation, replace the BepInEx/plugins/sptvr/SPT-VR.dll file with your new one and you should be good to go.
SPT 3.11.3
70 Downloads
The Return of Clouds! Also modded gun compatibility!
- Highlight bug fix (this was when you’d do the gun interact where it highlights your guns, sometimes multiple highlights would get stuck on your screen)
- Fully custom dynamic cloud system tied to Tarkov’s weather system, these are VR compatible clouds that I imported into Tarkov. Totally separate from BSG’s clouds. They will change color with time of day, increase/decrease density based on weather, their speed will increase/decrease based on wind, and rain will make them darker
- Scopes load from json file now in bepinex/plugins/sptvr/configs - can now add modded scopes without needing to rebuild the whole project.
- Weapons no longer rely on being added one by one, they are now automatically detected and highlight weapon interaction will work on any gun (this allows for better modded gun compatibility, I can’t guarantee it’ll work for all modded guns though)
- Added a new vertical hand position offset slider, it’ll move your hand up/down. It’s bottom slider in the VR settings menu.
Important - Make sure you copy all of the files over from the .zip, not just the .dll otherwise you will not get the clouds. You can also just make sure to copy the customclouds file from the assets folder into your sptvr assets folder.
Unknown SPT Version
345 Downloads
Quick Update
- Fixed clouds - there was an instance of clouds spawning for every bot and caused them to overlap and made them look very opaque and ugly
Note to self: Always test raids with bots before release
SPT 3.11.3
341 Downloads
Read pinned comment
Big Update! Lots of necessary fixes!
-
Scopes have been fully completed and should be way more consistent now. Smooth zoom will work even with the first zoom when you first spawn in. There shouldn’t be anymore issues where it’s showing the wrong reticle either
-
Body rotation has been tied to head rotation, hurts a bit with immersion by not separating it from the legs but it makes the arms IK wayyy more stable
-
Gun does not shift anymore when saving settings and exiting menu, it will always be in the correct position now
-
Complete rewrite of the head to leg sync. You can lean left and right more now without your body following you and your legs will never be in front of your head anymore. If they do, just walking will reset the legs back to the right position
-
Adjusted quickslot collider (for meds and nades) to left side, like how you take out map in ITR. The chest position felt a bit inconsistent and caused accidental opening pretty often. Avoid looking left when going to grab, looking left will make the collider move and become harder to reach.
-
Made the inventory always open directly in front of you regardless of your rotation, always at the same distance
-
Adjusted fog a bit so that the alpha is never at 1.0, 1.0 is pretty much just opaque and it doesn’t look nice, I’ve capped it at 0.7
-
Went the ITR2 route, arms will disappear when going prone and instead only shows hands. This avoids the really bad IK while prone (IK that I refuse to touch and destroy lol)
-
Fixed bugs with some guns with changing fire select causing nulls and breaking a lot of functionality
-
Added support for all the new guns from EFT 0.16
-
Unfortunately, I’m thinking Fika support may need to be partially dropped. I’ve gotten it to a point where it isn’t even throwing any errors anymore but it still crashes randomly. Base SPT has no issues like this, it seems like there’s been quite a few changes from Fika 3.9 to now. This VR mod changes so many different things, I think a special sptvr fika compatibility mod needs to be made for whoever is hosting and I’m just not capable of doing that and maintaining it, at least not yet. I’ve done some testing and it seems like self hosting fika when you have sptvr installed works a bit better though.
-
Other random UI and bug fixes
Unknown SPT Version
346 Downloads
Fika support back on the menu!
Updates:
- Random CTD when using fika headless client seems to be resolved, keep in mind, there may still be some issues with fika but the main crash seems fixed (thanks a bunch Lacyway for pointing out the cause)
- Grenades now explode when playing as client connected to Fika headless or someone hosting without sptvr installed
SPT 3.11.3
99 Downloads
New person here! Hey!
Just want to start off by saying, Cybensis is a genius and I have the utmost respect for what he’s done to get this mod to the state it’s in. I am just a very passionate dude that didn’t want to see this die.
On that note, I just want to let everyone know what my plans are for this mod. I’m less interested in compatibility with other mods. Imo, this mod changes too much in the game to be expected to keep up with other peoples mods and make sure they work. This is meant to be a sole installed mod sort of deal. Don’t expect anything to be compatible with it. Fika is the one mod that I want to try and keep this working with though because using a headless dedicated client is a massive help with performance when VR really needs every bit of it.
-Also a quick shout out to the few people that were testing this. I was pushing out new testing builds often so I really appreciate any time you spent making sure things were working!
Thank you Havviks, groundzeroday, gbtonzee, and LiftIsTheWhey
Big update!
- Updated to SPT 3.11
- Added smooth variable zoom similar to how it works in tarkov now, all variable scopes are smooth, non-variable switch between the two. I’m not using BSG’s implementation of this, I’ve completely re-did the way scope zoom works.
- Added variable smooth zoom sensitivity to settings
- Added “disable run animation” option in VR settings
- Added “Disable prism effects” in VR options, this totally disables the post processing component BSG uses (may not work nicely with amands)
- BIG: W.I.P. Enabled a new fog using prism effects, BSG fog is totally broken in VR so needed a new solution. Currently the fog is setup to where it will actually move dynamically based on the weather. I tied the fog to the fog density calculations which are running every frame in game. And… YES the fog can be disabled (this may also not work nicely with amands) Best thing about this new fog is that it no longer has graphical issue, I’ve made it look exactly the same in and out of the scope. There is some random times where you can notice the fog isn’t appearing great in VR but it works significantly better than old fog
- Fixed random bugs that came up with 3.11
- Fixed AddOffer menu not working
- Picking up loose loot and putting it behind your back is now instant, no longer does pickup animation
- Fixed loads of other just random small bugs and nulls
- FIKA EXPERIMENTAL SUPPORT ….. it works, sorta. You can get into games fine but there’s random nulls and I know for sure a big null when you get killed which may require restarting your game. I’ve probably heavily over-engineered some of the patch fixes for it, I’ll come back to it
- Temporarily disabled EFT API, was having trouble with this, I’ll come back to it at some point. Not very important.
- Changed the way weapon hiding works when going into your inventory. This fixed a big bug that a lot of people probably had where if you changed scopes in inventory and exited the inventory after the animation of changing the scope finished, the scope would not work. That is resolved now, this may also fix some other random bugs.
Unknown SPT Version
632 Downloads
Changes:
- Fixed FIKA support, it should be back to how it was on 3.9 Read below
Yes, I was dumb. I was fixing FIKA support around when I first picked up on the development here and had no idea what I was doing. I overdid a lot of it because of a dumb mistake, reduced code back to pretty much what Cybensis had there but made some slight adjustments.
NOTE: Just did some further testing, it’s a lot more stable but there is still a crash that happens occasionally on extract. I’ll get it figured out.
Read stickied comment if you’re experiencing an issue where both eyes are appearing in one eye!
Not quite yet...
Details
-
Additional Authors
-
License
-
Source Code
-
Latest Version VirusTotal Result
https://www.virustotal.com/gui/file/2825cba6d43e15975dead9f0caa413f61e5b85f120f36a4522ddd49fe9e472a8
-
Includes AI Generated Content