-
Notifications
You must be signed in to change notification settings - Fork 5
User Guide
See the installation guide: https://github.com/JonnyOThan/Kerbal-VR/wiki/Installation-Guide
To toggle VR in the flight scene, press alt-v. This should allow you to use the mouse to click on things if necessary.
The headset will reset its neutral position whenever you press the C key. You should also be able to do this from inside VR mode by pressing the system button to enter the SteamVR settings.
To press buttons inside the cockpit, extend either index finger and simply push the button with the tip of your finger.
To move switches, extend your index finger and move the switch up or down. Moving at a medium speed generally works better.
Some switches and buttons have covers; in order to move or press them you must fully open the cover by lifting it with your index finger.
Some cockpits have twistable knobs. To turn these, activate the "pinch thumb" and "pinch index" actions (B and Trigger on quest 2) and turn your hand. If you're not using the Oculus Quest 2, you might need to set up custom bindings for these buttons.
A few cockpits have a lever (gear, flaps, etc) that needs to be pinched and moved up or down.
To control throttle, use the grip button on your controller to grab the throttle lever (usually attached to the left side of the seat) and push it forward.
To control roll/pitch/yaw, use the grip button on your controller and grab the flightstick (usually attached to the right side of the seat) and turn it. Note that you can turn it in all 3 axes. Rocket command pods will default to using twist for roll and tilt left/right for yaw, while plane cockpits will use twist for yaw and tilt for roll. You can swap the stick between these two modes by clicking the thumbstick while holding the flightstick.
To control the RCS translation knobs, use the grip button and push it around.
You can move to an empty seat or swap control to a different kerbal by putting your hand in the middle of the seat (where the Kerbal's torso would be) and pressing the SeatInteraction action - the lower face button by default.
To go EVA: find the hatch lever, use the grip button on the controller, and turn it.
The mk2LanderCan from KSA IVA Upgrade has a steering yoke on the left seat. Rotate it to steer rover wheels, and push it forwards or back to control the wheel throttle.
If you're having trouble using a small button or switch, hold the PinchIndex and PinchThumb actions while not near any objects to summon a pointer object that you can use to push buttons and move switches.
KerbalVR now supports FreeIVA, which allows you to get out of your seat and move around the ship.
To unbuckle, press the harness release button on your chest or by your side with your fingertip. If it's an airliner-style buckle, use the grip button to lift the lever. You can also press the SeatInteract action. To get into an empty seat, interact with its harness button or lever in the same way. All of the props that can be manipulated with FreeIva can also be grabbed in VR. You can also move yourself around by using the grip button on any railings or the walls and pulling yourself around.
- Left Thumbstick: Move
- Right Thumbstick: Turn
- Right lower face button: Jump
- Click left thumbstick: toggle crouch
- Click right thumbstick: toggle roll/yaw on horizontal axis
- Triggers: Vertical movement (ladders or zero-g only)
- Grip button: grab prop, railing, ladder, or wall
- PinchIndex/PinchThumb: use prop (PinchIndex for cameras, fire extinguishers; PinchThumb for flashlights, etc.)
Hold the RightClick button (B or Y on quest 2) on either controller. This opens the PAW for your kerbal, and activates a laser on the other hand. Aim the laser at a part you want to interact with and press the RightClick action on that controller to select it. To interact with the PAW, tap it with your fingertip.
Toggling the suit lights is accessible in the PAW.
Deployable science and other parts can be placed through the PAW. Press the jump button to deploy it. There is no cancel button.
You can switch between kerbals on EVA by activating the grip action on their torso (just like IVA) or selecting them with the PAW and tapping "SwitchTo."
When you enter EVA mode, you will likely be holding on to a ladder. To let go, use the grip button in the area of the ladder and release it, or press the jump button.
To move up or down on the ladders, use the left thumbstick or the left/right trigger buttons.
To grab a ladder, use the grip button in the area of the ladder. You must hold it as long as you want to stay on the ladder.
To board the pod, grab the hatch lever/wheel/handle and move it.
- Left Thumbstick: Move
- Right Thumbstick: Turn
- Right lower face button: Jump
- Left lower face button: toggle RCS
- Click left thumbstick: sprint
- Left thumbstick: Move
- Right thumbstick: Yaw/Pitch
- Triggers: Vertical movement
- Left lower face button: toggle RCS
- Click left thumbstick: toggle precision mode (scales down translation movements)
- Click right thumbstick: toggle roll/yaw on horizontal axis
- Use the SeatInteract button on the seat to enter it
- Move the flightstick and throttle just like in IVA
- Press jump to exit the seat
Deploy the parachute through the PAW, and use either thumbstick to steer.
By default, KerbalVR will use kerbal hands and gloves. You can install VR_human_hands.cfg from the Optional Mods folder to use human hands instead.
By default, KerbalVR will assume you are holding controllers and set the finger curls accordingly. If you want the hand to open fully (or maybe your controllers can't detect when the fingers are touching the buttons), you can install VR_fullmotion.cfg from the Optional Mods folder.
KerbalVR supports hand tracking (playing without controllers) through Virtual Desktop and ALVR. ALVR supports individual finger tracking while Virtual Desktop does not. Moving in EVA is not supported with hand tracking, but flying the ship in IVA should work pretty well. When using an input mode that supports full finger tracking (e.g. ALVR), the pinch action is activated whenever the index and thumb fingertips are close together. The pinch gesture also activates the PAW/laser system when in EVA or external view.
If you find something that doesn't work or have a feature request, please report it on Discord or the Issues Tab after making sure it hasn't already been reported. Include your full ksp.log file with ALL bug reports.