Skip to content
forked from cybensis/SPT-VR

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.

Notifications You must be signed in to change notification settings

Jocelyn-JE/SPT-VR

 
 

Repository files navigation

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.

Game Preview


Table of Contents

  1. Setup
  2. Controls
  3. FPS/Graphics Guide
  4. FAQ
  5. Contributions
  6. Support the Mod
  7. Development Environment Setup
  8. Get in contact

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

  1. Ensure SPT is up to date: Make sure you have the latest version of SPT installed on your system.
  2. Download the latest release: On the right side of this page (if on GitHub), download the latest release from the "Releases" section.
  3. Navigate to SPT's root directory: This should contain the SPT.Launcher, SPT.Server files, and the BepInEx folder.
  4. Extract the downloaded files: Merge the folders from the release with the folders in the SPT installation.
  5. Launch SteamVR: Ensure that SteamVR is running and your headset is connected before launching the game.
  6. 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

  • Shoot: 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:
    1. For a pistol, bring your right hand to your hip and press the right grip.
    2. For primary weapons, bring your right hand to your shoulder and press the right grip.
    3. Use the radial menu by holding the right grip at your shoulder.
  • Quick Slot Items: Open the radial menu by bringing your left hand to your chest and holding the left grip.
  • Interacting with doors/containers/bodies/loose loot/etc: There are two different ways to interact with the aforementioned objects:
    1. 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, or
    2. You can 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 bringing it over your left shoulder and releasing will 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 and it will bring up a dropdown menu for said item.
  • Opening Item Display Window: To open the items display window, double tab A while hovering over it.
  • 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.


FPS/Graphics Guide

NOTE: Keep in mind these settings were based on my personal performance is likely very inaccurate. Additionally, messing around with some settings in raid can cause some bad visual glitches, so be aware of this before reporting any bugs

In game graphics guide

  • Resolution likely doesn't matter too much as it's always going to render to the quality of your headset or what SteamVR is set to, but it's posssible lowering the resolution to as low as possible may net some frames.
  • Anti aliasing should be off or on FXAA - No FPS difference noticed between the two, and other options cause bad visual glitches
  • Resampling should be off/1x otherwise it may cause visual glitches
  • DLSS and FSR don't work properly so turn them both off
  • HBAO - Looks better but takes a massive hit on performance - off gets about around 10-20 fps increase
  • SSR - Low drops frames by around 2-5, ultra by about 5ish. I don't personally notice any visual improvements but it seems like if you have it on, you may as well go to ultra
  • Anistrophic filtering - No real FPS difference
  • Sharpness at 1-1.5 I think any visual gain falls off after around 1.5+
  • POST FX - Turning it off gains about 8-10 FPS in some situations, or does nothing in others

Additional FPS guide

  • The VR Performance Toolkit (vrperfkit) can net about 10-20 extra FPS with the default configuration at the expense of some graphical fidelity, could help people with less powerful computers

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.

Are other mods compatible with the VR mod?

There are several mods the testers and myself were able to confirm as working, as for other mods, anything to do with adding a new UI is likely to not work, adding new guns might work but will be missing new features, and some graphics mods may also cause issues with the VR mod, so please keep in mind before reporting any bugs, remove all mods that are not listed below.

Here is the current list of known compatible mods:

  • FIKA
  • Amands Graphics
  • Swag + Donuts
  • SAIN
  • EFTApi
  • 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

Support the Mod

Donations are appreciated but not required. All content is free to ensure everyone has the same access, those who still wish to donate can do so using the link below

Buy Me A Coffee


Get in contact

For reporting bugs or recommending improvements, go to either the SPT discord or Flat2VR discord servers, if you want to reach out to me personally, you can send me an email at [email protected]

Development Environment Setup

If you wish your own changes to the mod or want to check it out for whatever purpose, follow the below steps:

  1. Clone the Repository: This can either be done by downloading the source code through the GitHub page or by using the below command
    git clone https://github.com/cybensis/SPT-VR.git
  2. Open it up in your IDE: I've only ever used Visual Studio for development so I would recommend using that. Opening the .sln file will open up Visual Studio which should already be configured to build without isssue
  3. 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 go Build Solution
  4. 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.

About

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.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 100.0%