This mod was originally made by ZNix on GitLab, last updated in 2018 (v0.6.1). Hugo Zink then forked it and continued development, releasing version 0.6.5R in 2020, although that repo seemed to disappear at some point in 2022.
As the project is licensed under GPL, I've uploaded the source code here (unfortunately only version 0.6.1). I have no experience making PAYDAY 2 mods, so I can't continue development/fix bugs, but if you can then feel free to fork it and/or make a pull request.
Happy heisting! Original readme continues below:
The PD2VR Improvements mod (referred to as VRPlus in code, in case you run across that) is a mod for the VR Beta of PAYDAY 2, adding many quality-of-life fixes such as smooth locomotion, moving you're health wheel to you're wristwatch (as per the trailer), and snap-turning support, and fading the screen to red while on very low health.
Most of these changes are disabled by default, and must be enabled in the mod settings. See below for a list of the settings, and what they do.
The GitLab issue tracker is the primary way to keep track of problems and suggestions for this project. If you don't have a GitLab account, you can use single-sign-in to from Google, Twitter, GitHub or BitBucket.
Please do not hesitate to post your issue (be it a bug report, or any kind of suggestion) on here. Preferrably look at the list of issues to see if any clearly match yours, but I don't have any problem with the occasional duplicate issue.
If this is a crash bug, please pastebin your crash.txt file and include a link to it.
If you've installed the mod by downloading it from the Steam group, you're good to go. If you've got your copy straight from GitLab for some reason, you'll have to rename the mod folder 'payday2-vr-improvements-master-....' to 'vrplus' before it will work. The game will prompt you to do this, and in the future may be able to automatically correct this issue.
In the lower left-hand corner of your screen, you should see an indicator telling you if you have any available updates. If it says you do, click on it, then click 'Download Manager', and finally click the update button for VR Enhancements (the little radio in a circle button).
In the past, there were issues where the IPHLPAPI.dll file (BLT Hook) would always appear in this list, and couldn't be updated. That has since been fixed.
This mod has an official Steam group. Not so much now there's automatic updates, but from time to time I post announcements that may be useful for users of this mod.
It also contains the main discussion thread, which contains instructions on how to download, install and set up this mod. Also, unless specificly instructed to do so, download the mod zip off that thread rather than from GitLab - not doing so breaks automatic updates (which the mod will warn you about).
See CHANGELOG.md.
ZNixian - Coding blinkVR - Mod icon, helping find and replicate bugs Sergio - Russian translation
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
This mod is extensively customizable, and by changing you're settings you'll get the most out of this mod. To open you're settings, open the game and click Options->Mod Options->VR Improvements. From there, you can customize the various aspects of the mod.
Almost all of these options can be changed while playing and will take effect instantly - no need to restart PAYDAY or restart the heist (for those not aware of it, starting, restarting or stopping a heist will almost always have the same effect as restarting PAYDAY 2 - you can install a mod and then restart the heist to have it take effect, without restarting PAYDAY 2, or disable a mod while on the main menu and this takes effect when you next start a heist).
Therese settings are about the ingame user-interface.
This moves you're health wheel to you're wristwatch, as seen in the trailer or seen here. This does remove it, not duplicate it, but I'm looking into fixing that.
Changes to this option will not take effect until a new heist starts.
Default: Enabled
For those affected by simulator sickness, smooth locomotion is usually worse than teleporting in this regard. These options help try to mitigate this.
Also, they can adjust some controls that some Vive users may find painful over time.
Enabling this will artifically limit the player's walking and running speeds, to an adjustable amount.
Default: Disabled
This allows you to select, when using an empty hand, which buttons on the motion controller can be used to interract with items (pick locks, start drills, answer pagers, etc). For Vive users who find their grip button uncomfortable, this may be extremely useful.
It allows you to either select the Grip button, Trigger button or both as possible inputs.
Default: Either Grip or Trigger. Vanilla: Grip Button.
Once you start interacting with something (same as above - locks, drills, pagers, etc) you can release the button you used to start interacting with it, and the interacton will continue.
You can interrupt an interaction by pressing the interact input a second time.
Default: Disabled
These options adjust how input is taken from the motion controllers
Enabling this uses trackpad/thumbstick locomotion to move around in-game, while disabling it uses the vanilla warp/teleport system.
When this is enabled, the controls are as follows: The hand you'd normally teleport with is changed to moving you around using the thumbstick/trackpad. Briefly clicking the trackpad/thumbstick will cause you to jump, holding down for longer will make you start running.
Default: Enabled
This can be used to switch between no turning, smooth turning, and snap turning. When it is enabled, you're firemode and gadget buttons will be remapped to up and down, respectively, on you're weapon-side thumbstick, and left-right will rotate your view.
Note this works regardless of 'Enable Locomotion'.
Default: Disabled
When this is enabled, you only need to hold down on your trackpad/thumbstick to start running, then you can let go. When this is disabled, you have to hold your thumbstick down to continue sprinting.
Note that as of v0.1.9.0, jumping is broken when this is disabled - see #30.
Default: Enabled
When this is enabled, you move in the direction you're pointing with the hand whoose thumbstick/trackpad you're using to move around. When this is disabled, you move in the direction you're looking.
As an example, if you're looking forwards and are holding your hand out towards something off to your side. When this is enabled, moving the thumbstick/trackpad forwards will move you in the direction of what you're pointing at, while when disabled you will move in the direction you're looking.
Default: Enabled
In percent, how much of the trackpad between the center and the edge is considered a deadzone - you will not move while your thumb/thumbstick is in that zone.
Default: 10%
How long, in seconds, you have to hold down the thumbstick/trackpad to start sprinting, as opposed to jumping.
If you find you're unable to jump, ensure you did not set this to some very low value.
Default: 0.25 Seconds
This controls options for how the camera is handled in VR
When you put your head into (or close to) a wall in VR, your screen will fade to black. Once it has reached a certain percentage of blackness (vanilla: 95%), it starts a timer to teleport you out after an amount of time (vanilla: 1.5 seconds).
Fade Distance: The minimum distance from an object you must be before you're screen will start fading. Vanilla: 13. Default: 2.
Camera Reset Percentage: The percentage blackness that your screen must fade to for the teleport-out timer to start. Vanilla: 95%. Default: 95%.
Camera Reset Timer: The time in seconds that must pass while you're screen is over the reset percentage black before you will be teleported out. Vanilla: 1.5 seconds. Default: 0.25 seconds.
Redout is where, when running low on health, you're screen will be tinted red in proportion to how close to going down you are as an indicaton. I've never tried this in game, so if you think making it fade out (or have any other suggestions) after a time would be useful, please post a comment on the Steam group or (preferrably) open an issue on the issuetracker.
Redout %HP Start: When you're below this percentage of your health, your screen will begin it's fade to read.
Redout Max Fade: At zero health, what percentage opacity is the red tint?
Random, misc options that probably aren't very important.
The laser pointer options allow you to set the colour of the laser pointer in the main menu. The hue slider lets you adjust the hue of the beam, and disco mode makes the pointer fade through the colours of the rainbow at a speed determined by the hue option.
Note that disco mode uses a logarithmic scale, so while setting the hue slider to 100% will do two rainbows per second, at 10% it will only do two rainbows every 100 seconds (10%=0.1, 0.1^2=0.01, 1/0.01=100).
Default (hue): 33.3%. Vanilla: 33.3%
Default (disco): Disabled