Installing the mod

Download and run the latest installer on

After the install, if you restart steam you’ll have Half-Life VR and Half-Life VR: Episode One in your steam library.  You’ll need to right click them and select Properties -> Set Launch Options and add -vr -novid to the textbox ( -novid kills the startup video that isn’t rendered in stereo and can be really disorienting).  Aside from that you should be good to go, just make sure your hydras are on the base station when you start the game.  Also make sure you don’t have motion creator or the razer hydra tray apps running as they will try to inject their own gestures and control schemes that will completely ruin the experience.

Configuring the movement modes

The following options can be set either in the game console ( accessed by pressing the ~ key) or by adding them to your autoexec.cfg under {steam}/steamapps/sourcemods/halflife-vr/config ( or the folder for the episode you’re playing).

mt_control_mode 0

By default things should work with a hydra in each hand and a pretty standard gamepad controls scheme.  This is probably the easiest way to play the mod but only leverages the left hydra as a controller so it lacks the full positional tracking you can get from the other modes.

mt_control_mode 1

If you have an xbox 360 controller (or even better a ps move navigator with drivers to emulate one), this control mode will allow you to use that in your left hand rather than the left hydra.  Just enable your controller (before starting the game, the source engine doesn’t hot-load controllers), and in the game options map your controller buttons to the normal left hand functions. Now you’ll need to find a way to keep the left hydra in a fixed position on your chest ( use the calibration location outlined in the default calibration step below as the ideal position to fix your hydra to your chest, at the base of the neck will get you the best results as your movements will be closer to 1-1 than they would further down your chest).

mt_control_mode 2

If you don’t have the spare xbox controller around but want to try out the positional tracking, you can use mt_control_mode 2 instead.  In this mode, you’ll use the left hydra attached to your chest just like the previous control mode, but the right hydra will now include all the necessary controls to play the game.  Since there aren’t enough buttons on the hydra to cover all the necessary commands, the right bumper behaves as a shift key and remaps the button and stick behaviors.  For example, the stick x-axis defaults to strafing, but when the bumper is depressed it turns the player instead.  This is admittedly less intuitive than the other control modes but it’s a good way to get a feel for how much positional tracking can add.


To calibrate for mt_control_mode 0, make sure that your head and torso are both facing forward relative to the hydra base station, hold the left hydra up to your collar bone and press the right hydra start button (See example picture below) .
Tip: The actual specific orientation of the left hydra isn’t important but here’s how I tend to hold it for consistency.  While the orientation of the right hand during calibration has no bearing on the calibration itself, if you hold your right hand in front of you, you can repeatedly calibrate while making slight movements with your left hand until you find the “right” position, when the virtual hand and your own hand are in the same place.
instruction-2To calibrate in either mt_control_mode 1 or 2, the hydra should already be fixed to your chest in the correct position.  As long as it is, just make sure you’re head / torso is facing forward relative to the hydra base and press the right hydra start button.

HMD Calibration / FOV Adjustments

I’ve had several questions about how to adjust the rift IPD and FOV settings in the mod.  Currently the best way to do this is to use the TF2 calibration utility and then copy the settings from TF2 over to the mod since HL2 doesn’t currently have it’s own calibration tools.  Hopefully this is a short term situation.
Instructions on calibrating TF2 can be found here.  Once you’ve made it through that, browse to your TF2 config folder and open config.cfg:
{steam}/steamapps/common/team fortress 2/tf/config.cfg

Now copy all 8 settings that start with vr_ipdtest_ to your clipboard.

vr_ipdtest_left_t "157"
vr_ipdtest_left_b "672"
vr_ipdtest_left_i "624"
vr_ipdtest_left_o "118"
vr_ipdtest_right_t "163"
vr_ipdtest_right_b "679"
vr_ipdtest_right_i "617"
vr_ipdtest_right_o "106"

Now you’ll need to put those into the mod config, which can be found at:


Find the same settings in this file, delete them, and paste in the values you copied earlier. The same will need to be done for any other halflife-vr-* folders for the episodes etc as well.  The paths may vary if you use custom source install directories.

25 thoughts on “Instructions

  1. I’ve learned how to calibrate in mt_control_mode 0.
    but i cant archive that my virtual hand and my own hand are in the same place in mt_control_mode 1.

    can you specific where to put the right controller in the mode 1 calibrating mode?

    thank you

  2. the recallibration never seems to do anything (put left hydra to neck, press middle thin button (that’s the start right?) on right, absolutely nothing happens)

    also, I never see the gun because it seems to always be behind me, and I can not find a way to recalibrate the right hydra… help?

    • You’re hitting the thin center button on the right controller and it’s not calibrating? Do you use an international key set, I know there were issues earlier on with certain keybindings. You are using v1.2 correct?

      • I think it’s 1.1, I’ll download 1.2 now and see if that works any better. In all honest I’m still getting the hang of the hydra’s as a whole, not been able to calibrate them well with most games yet

      • Yeah it’s all working, I also noticed my biggest issue with the Hydra in general was because I kept leaning forward to grab the hydra, then lean back, causing the games to think I was pulling my arms back, I fixed it by standing over the sensor so when my arms are outstretched they are right over it

    • Given that they recently upgraded to the latest version of the source sdk it actually probably works if you copy the right files to the right places, I’ll see if I can put together the installer that does that automatically. I haven’t played it yet specifically because I wanted to hold out until I could get my mod worked in, the videos I’ve seen of it look great.

      • Got yeah! Yeah I am waiting to play through the game for your Mod support 😀 I thought it might work already if i found out how to get it to work I may mess around with while waiting for your installer. Great work man, Half life VR was my best VR experience I have had with my Rift and hydras.

    • There’ll be a new version releasing soon that’ll use your oculus configuration. Until then I’m afraid there’s not much you can do, I’ve heard people figured out how to translate an IPD to all the vr_* config entries the existing mod needs but haven’t seen it myself.

    • It unfortunately no longer exists, I’ve got an updated version of the mod that you can try that uses the oculus calibration info if you want to try it. Still working on some additional features but it should be playable.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s