VRWaypoint
All experiences

BB-tierPortal 2 VR by Gistix

Aim the portal gun with your hand and step through your own portals in a real-scale Aperture.

The catch: The pause menu and UI are broken, and the last tagged release is from 2023.

Get it running Official page

Will it run on your rig?

Check my rig

Set your rig to check fit.

Launch Kit

Get Portal 2 running

0 of 9

Steps are general until you ; then the runtime step matches your headset.

  1. Set your VR runtime

    This mod runs through SteamVR. Start your headset's PC link first (Quest Link, Air Link or Virtual Desktop), then start SteamVR.

    General step from us
  2. Install Portal 2 (Steam)

    Install it and launch it once in flat mode to finish first-time setup, then quit.

    General step from us
  3. Have these ready

    Portal 2 owned on Steam · SteamVR with a connected headset · Launch options from the README

    From the creator's guide
  4. Creator step 1

    Download Portal2VR.zip from GitHub releases

    From the creator's guide
  5. Creator step 2

    Extract it into your Portal 2 folder (steamapps\common\Portal 2)

    From the creator's guide
  6. Creator step 3

    Connect the headset and launch Portal 2 with the launch options from the README

    From the creator's guide
  7. Creator step 4

    Set the README's suggested video settings at the menu

    From the creator's guide
  8. Creator step 5

    Load a chapter; press down on the left stick to recenter height

    From the creator's guide
  9. First launch in VR

    Put the headset on, then start Portal 2 the way the creator's guide says. Calibrate your height in the first area.

    General step from us

Stuck?

In-game UI and pause menu are broken (README)

Reported on the creator's page or the linked sources. Known issue

6DoF and roomscale needs reimplementing (README)

Reported on the creator's page or the linked sources. Known issue

Newest release v0.2.0-preview.1 (2023-09-25, pre-release) adds tentative co-op

Reported on the creator's page or the linked sources. Known issue

If no audio, run UpdateSoundCache.cmd in portal2_dlc3; if not loading, open SteamVR first and disable SteamVR theater

Reported on the creator's page or the linked sources. Known issue

Black screen in the headset

This mod runs through SteamVR. Start your link (Quest Link, Air Link or Virtual Desktop) first, then SteamVR, and only then the game. If SteamVR shows the headset but the game is flat, close the game and launch it again the way the creator's steps say. General tip from us

Controllers don't show up

Start Link, Virtual Desktop or SteamVR before the game, and make sure the controllers are awake before launch. General tip from us

Stutter or low frame rate

Lower the in-game resolution or render scale first, then shadows and volumetrics. Close overlays you don't need. General tip from us

The mod didn't load at all

Recheck the game version against the creator's page; a game update is the most common cause. Then reinstall the mod files. General tip from us

Prefer a guide that talks back?

Copy a prompt for Claude Code on your PC. It asks before every download or change, and only uses the official page.