An experimental VR port of Need for Speed: Underground 2, based on the original Xbox USA / NTSC-U version. It uses static recompilation with xboxrecomp, Vulkan rendering and OpenXR tracking and presentation.
This VR mod is based on the work of antoxa2584x in nfsu2-sw. The PCVR and Meta Quest 3 adaptations build on that project's Xbox recompilation and runtime work.
Warning
DEV BUILD — NOT 100% TESTED. This project is under active development. Bugs, crashes, freezes, visual glitches, audio issues, stuttering and performance problems may occur. Features and compatibility are incomplete, and stable VR frame rates are not guaranteed. This is not a stable release.
Important
No original game content is included. You must supply your own supported Xbox USA / NTSC-U disc image or extracted game files. The development builds contain the port and its runtime, but no disc images, original Xbox executable, retail game assets, music, movies or saves. Building from source additionally requires generating the private game code locally.
Watch the VR cockpit and driving demonstration: https://youtu.be/MHHi2G6Lixk
| Target | Runtime | Development status |
|---|---|---|
| PCVR — Windows x64 | Vulkan + OpenXR; tested with Quest 3 using Steam Link / SteamVR and Virtual Desktop / VDXR | Stereo races and Touch controls have been exercised. Bugs, audio glitches and frame-time spikes remain; stable 72 FPS across gameplay has not been established. |
| Meta Quest 3 — standalone | Native Android ARM64, Vulkan + OpenXR | Boots and races directly on the headset with tracked stereo and Touch controls. Rendering issues, stutters and performance limitations remain. |
Other PC OpenXR runtimes and other Quest models have not been established as supported configurations. Inherited Linux and Nintendo Switch code remains in the tree; the focus of this development publication is PCVR and Meta Quest 3.
Fixes the 60 FPS gameplay cap introduced by 0.7.1-dev. Selecting the runtime's refresh rate had accidentally disabled XR game pacing. Race pacing now stays active independently of display-rate selection, allowing 120 FPS when Virtual Desktop / OpenXR uses 120 Hz and the hardware can keep up. Frontend and intro timing retain their existing behavior.
The 0.7.1 release has been withdrawn. This replacement includes all its control, lowercase keyboard, shifter, camera, menu scrollbar and screen fixes. Hold the screen: right-stick left/right changes opacity, up/down changes size. Screen grabbing defaults to On; existing saved preferences are retained.
Both packages use the same source revision. Quest version code 12 keeps the previous signing certificate. Regression tests reproduce the old cap and pass with the fix; sustained 120 FPS has not been measured on the final build. Full changes and validation.
Sequential or H-pattern shifting, optional no-grip gestures, shifter haptics and LED cues, a tracked-wheel deadzone, and a movable/resizable dash screen with opacity control. Press PAGE > below the stereo to switch between video/visualizer and live telemetry inside the cockpit. The release also fixes the rear-view mask's black bar, center-mirror camera coupling and the screen's depth ordering against the wheel. Mirrors exclude the player's own cabin/body.
Experimental online profiles, Free Roam and race integration are included; final browser-player and headset acceptance remains pending. CopChase is unsupported and its assets are excluded. See the release notes and online integration status for details.
Latest downloads: PCVR 0.7.2-dev and standalone Quest 0.7.2-dev.
- Meta Quest 3 APK (0.7.2-dev): sideload the development APK, then use its setup panel to import your own supported Xbox USA ZIP, 7z or ISO/XISO. Follow the Quest installation guide below.
- Windows PCVR package (0.7.2-dev): extract the whole ZIP to a writable folder and run Start-PCVR.cmd. If game data is missing, Game data setup opens automatically. Select your Xbox USA ISO/XISO; progress and cancellation are available. All 12 required files are verified before VR starts. Saved games are preserved.
- PCVR update for an existing installation: extract it and run Update-PCVR.cmd. The updater backs up replaced files and preserves game data, saves, music and settings.
- Matching source archive, build information and SHA-256 checksums.
The PCVR ZIP includes the EXE, SDL/OpenXR loader DLLs, Visual C++ runtime DLLs,
launcher, preset and notices. Install your GPU's Vulkan driver and a compatible
OpenXR runtime separately. For Steam Link, connect to SteamVR and run Start-PCVR.cmd -SteamVR.
No Python, Java or external ISO extractor is required to run the PCVR importer.
See the included README for system requirements. These downloads remain
development builds, not fully tested, with possible bugs and performance issues.
Ride up to the starting line in the driver's seat with automatic or manual transmission. The cockpit view stays with your car through the countdown. At GO, your saved racing camera takes over. Release notes.
Put your own music and videos in the Music folder to shuffle them during driving and replays. The larger screen above the radio plays videos or displays a spectrum. Choose the color of the interior LED strips and set them to pulse with the track or glow steadily. Grab the minimap to move and tilt it. During replays, click the right stick to change cameras and use Grip in the driver's seat to adjust your mirrors. Formats, controls and update instructions.
Feel the engine RPM through your controllers. In 0.5.0-dev, switch on VR Settings → Advanced Haptics / Rumble → Engine REV Rumble for a gentle idle vibration that builds toward your car’s redline. Applying more throttle strengthens it. With Grip Feedback enabled, letting go of the wheel stops engine vibration in that hand.
Version 0.5.0-dev introduced six replay cameras, including the driver's seat. You can also move the minimap by hand, change songs with a fingertip, adjust the seat from the door armrest, and adjust mirror resolution and master volume. Full changes and controls.
Version 0.4.0-dev adds a physical H-pattern shifter, including first-gear selection during the countdown, a wheel you can catch as it returns to center, adjustable mirrors, animated pedals and a dashboard radio. Quest 3 and PCVR also use a faster decoder for the intro and story videos. Controls, measurements and update instructions.
The October 20 update shipped 0.3.2-dev (Quest version code 5). OpenXR presentation preserves the game's display-encoded colors, fixing the washed-out, gray appearance in menus and stereo gameplay. VR Settings colors also use the correct channel order.
All three cockpit mirrors now recover after Restart Race. The rear camera is checked against the current race's camera manager and recreated when needed, without following old camera pointers or removing cameras owned by the game.
Native Quest testing confirmed the colors, visible detail in dark areas and all three moving mirror images after restarting a race. GPU color regression tests passed on Quest, Intel and NVIDIA hardware; camera lifetime tests passed on Quest ARM64 and Windows. Both platform builds include the fixes. A fresh PCVR headset test remains outstanding.
Download URLs remain unchanged. Install the APK over the previous version to retain imported data, saves and settings; the signing certificate is unchanged.
The October 18 update introduced 0.3.1-dev (Quest version code 4). Small hand-driven wheel movements compensate for the original game's 24% stick deadzone: there is no longer roughly 43 degrees of dead travel per direction at the default 360-degree rotation. Stick/gamepad deadzones remain unchanged. Wheel animation, stable grip contacts and switching back to the left stick are preserved. Steering sensitivity and rotation remain adjustable in VR Settings.
The fix passed Windows and Quest ARM64 regression tests and was confirmed in native Quest driving. The PCVR build includes the same fix; a new PCVR headset test is still outstanding. Download URLs remain the same; reinstall the APK over the previous version to keep game data, settings and saves.
- VR Settings in the pause menu: adjust steering sensitivity, wheel rotation, seat height/distance and per-eye render resolution. Pause, then press X; use a stick/D-pad to adjust and B to save. Resolution changes need a restart.
- Individual base cockpit fitting for all 29 stock vehicles, including the Miata's shorter cabin and rear-bench removal for Miata/350Z.
- Fixes for missing player bodies, black driver-proxy obstructions and mirrors disappearing after seat adjustments. Interior and side mirrors use the original glass with three sectors of the game's rear camera.
- Clear cockpit windows: the player's tint/glass is hidden only from inside; exterior tint, the original body, window frames and mirrors are retained.
- Speed display seated on the instruments, map on the center console, and race notifications no longer returning the gauge to its old screen position.
- Right stick click changes cameras; left click looks back outside the cockpit. Both clicks recenter. Right stick left reads SMS; right enters a race/shop. Up/down shifts with Manual transmission. A is nitro; B handbrake.
- SDL gamepad input, persistent settings, cockpit geometry/mirror caching and improved PCVR startup retry/error handling.
Recent cockpit fitting, mirrors, seat settings, instruments, map and window-tint behavior were confirmed on native Quest. Windows tests cover the shared code, including simulated gamepad input. Fresh PCVR headset/reconnection and physical gamepad acceptance are still outstanding. Stable 72 FPS across gameplay is not established. The shared cabin remains a prototype, not a faithful recreation of each car's interior or a guarantee for every tuning combination. See release notes and cockpit asset details.
If you enjoy this project and would like to support its continued development, visit OpenSourceDevDirk on Patreon.
The Quest build runs standalone on the headset. Install the APK, copy your game data to the Quest, then import it in the app. This is an experimental development build; rendering and performance issues remain. Quest 3 is the verified target.
- Download the
NFSU2VR-Quest3-<version>.apkasset from the project releases. If building it yourself, follow the Quest build instructions; the output isandroid/app/build/outputs/apk/debug/app-debug.apk. - Have a computer, a USB-C data cable and your own unmodified original Xbox USA / NTSC-U copy of Need for Speed: Underground 2 ready.
- Prepare one of the following supported inputs:
| Input | Contents |
|---|---|
.iso or .xiso |
An original Xbox disc image of the supported USA release. Supported full-disc images are read directly. |
.zip or .7z with game files |
default.xbe and the complete NFSUNDER/ folder, including ZDIR.BIN and ZZDATA0.BIN through ZZDATA9.BIN. A common enclosing folder is accepted. |
.zip or .7z with a disc image |
Exactly one Xbox .iso or .xiso inside the archive. The Quest unpacks it automatically. |
Use complete, unencrypted files. PC and European editions, modified game files, RAR archives and split archive parts are unsupported. For a RAR or split archive, extract it on your computer first, then transfer the resulting ISO or repack the complete extracted game files as ZIP/7z. Renaming an extension does not convert it.
Allow space for the source file and temporary extraction. After the source has been copied to the Quest, these are useful free-space estimates:
| Source already on the Quest | Additional free space for import |
|---|---|
| ZIP/7z of extracted game files | About 5 GB |
| Full Xbox ISO of about 7.8 GB | About 11 GB |
| 7z of about 5.9 GB containing a full 7.8 GB ISO | About 17 GB |
Actual requirements depend on the archive size and existing saves. The importer temporarily copies the source, unpacks any contained ISO and installs about 2.4 GB of verified game files. Keep some extra space available when reimporting.
- Follow Meta's device setup guide to create or join a developer team and verify the Meta account used on your headset.
- In the Meta Horizon phone app, select your paired headset, open Headset Settings > Developer Mode, and enable it. Menu locations can vary by app version.
- On Windows, install the Oculus ADB Drivers linked in Meta's guide.
- Connect the powered-on Quest to your computer with the USB data cable. Put on the headset and accept Allow USB debugging. On your own computer, you can select Always allow from this computer.
Using SideQuest:
- Install the desktop Advanced Installer from the SideQuest setup page.
- Open SideQuest and wait until it shows the Quest as connected and authorized.
- Use Install APK file from folder / Install APK, select the downloaded
NFSU2VR-Quest3-<version>.apk, and wait for the installation task to finish.
Using ADB instead:
Download and extract Google's Android SDK Platform Tools.
Open PowerShell in the extracted platform-tools folder and run:
.\adb.exe devices
.\adb.exe -s YOUR_QUEST_SERIAL install -r "C:\path\to\NFSU2VR-Quest3-<version>.apk"Replace YOUR_QUEST_SERIAL with the serial shown by devices, and replace the
APK path, including <version>, with your actual filename. The device state
must be device; if it says unauthorized, accept the debugging prompt inside
the headset. Wait for Success. On macOS/Linux, use ./adb instead of
.\adb.exe and adjust the local paths. See the
ADB command reference for details.
Choose one of the following transfer methods. Put the file in the Quest's
shared Download folder (/sdcard/Download/), which the Android file picker
may display as Downloads. Wait for the entire transfer to finish before
starting the import.
Windows File Explorer (USB):
- With the Quest connected, accept the headset's USB file/data access prompt or open its USB notification to enable file transfer. This permission is separate from USB debugging. If the prompt is missing, enable MTP Notification in the headset's Developer settings and reconnect the cable.
- In File Explorer, open This PC > Quest 3 > Internal shared storage > Download.
- Copy your
.iso,.xiso,.zipor.7zfile into that folder.
SideQuest file manager:
Open SideQuest's file manager, browse to sdcard/Download, and use its upload or
file-transfer control to copy your ISO or archive from the computer. For this
step, use the file manager; the APK installation button is for installing the app.
ADB (Windows PowerShell):
From the same platform-tools folder, run the command matching your file:
# Direct ISO import:
.\adb.exe -s YOUR_QUEST_SERIAL push "C:\Games\NFSU2-USA.iso" /sdcard/Download/NFSU2-USA.iso
# Or transfer a ZIP/7z archive (this example uses 7z):
.\adb.exe -s YOUR_QUEST_SERIAL push "C:\Games\NFSU2-USA.7z" /sdcard/Download/NFSU2-USA.7zReplace the serial and source filename with your own. Keep the matching file
extension in the destination path. No manual copying into Android/data is
needed: the app installs the game files into its own private storage during import.
- In the Quest's app library, select Unknown Sources and open NFSU2 Quest Development. The first launch opens the game data setup panel. You can also open NFSU2 · Game data to access setup directly.
- Press Select archive, browse to Downloads (or the internal storage's
Downloadfolder), and select your ISO, XISO, ZIP or 7z. - Wait for Import complete. The app extracts and verifies the supported game files. A large 7z containing an ISO can take several minutes. Leave the setup panel open; closing it can cancel the import. Progress and Cancel import are available while it runs.
- Press Start game. Later launches through NFSU2 Quest Development start VR directly. The computer and USB connection are no longer needed to play.
- After a successful import, you may delete the source ISO/archive from the
Quest's
Downloadfolder to recover space. The app keeps its installed copy and never deletes your source file automatically.
To import different data later, close the running game, open NFSU2 · Game data
and select Reimport game data. Existing saved games and settings are kept.
Update the APK by installing over the existing app with SideQuest or adb install -r
using a build signed with the same key. Uninstalling the app or clearing its
storage deletes the installed game data and saves.
| Problem | What to check |
|---|---|
| SideQuest/ADB cannot see the headset | Check Developer Mode, the USB debugging prompt and the Windows ADB driver. Try another data cable or USB port. |
| File Explorer does not show Quest storage | Accept the separate USB file access prompt; enable MTP Notification if needed. You can also transfer with SideQuest or ADB. |
| The APK was copied but no app appears | Install it using SideQuest's APK installer or adb install -r, then check the library's Unknown Sources filter. |
| ISO/archive is missing from the picker | Confirm the transfer finished and browse to internal storage > Download rather than only the Recent view. |
| Not enough storage | Free space for both the source and the temporary files listed above. An archive of extracted game files uses less temporary space than an archive containing a full ISO. |
Incompatible default.xbe or failed verification |
Use the complete, unmodified Xbox USA / NTSC-U release and recopy the file if the transfer was incomplete. |
| 7z needs too much memory | Repack with a dictionary of 64 MiB or less, use ZIP, or extract the ISO on your computer and transfer that instead. |
| Game still running | Close the game before reimporting and press Check again in setup. |
| APK update reports a signature mismatch | Use an APK signed with the same key as the installed build. Preserve your saves before considering an uninstall. |
For build details, importer limits and developer installation tools, see the Quest development notes.
The examples below use Windows PowerShell. Install Git and Python 3.13 first.
git clone https://github.com/DR-89/nfsu2-vr.git
cd nfsu2-vr
py -3.13 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r tools/quest-requirements.txtPlace your extracted, unmodified Xbox USA / NTSC-U disc in game/, containing
default.xbe and the complete NFSUNDER/ directory. The PC retail release and
European Xbox release are not supported by these title-specific addresses.
The repository does not supply or download the game.
.\.venv\Scripts\python.exe tools/inspect_game.py .\game
.\.venv\Scripts\python.exe tools/regen.py .\game --gen-dir .\genThe generator requires an empty output directory. Keep game/, gen/, build
outputs and data archives private; they are excluded from Git.
Requires Windows x64, Visual Studio 2022 C++ tools, CMake, Ninja, Vulkan headers and a working Vulkan graphics driver. The VP6 build also requires Git for Windows with Bash.
Fetch and verify the pinned source dependencies once:
$dependencies = Get-Content android/dependencies.json -Raw | ConvertFrom-Json
foreach ($item in $dependencies.PSObject.Properties) {
$destination = "build/deps/$($item.Name)"
$dependency = $item.Value
if (-not (Test-Path -LiteralPath $destination)) {
git clone --config core.autocrlf=false --depth 1 --branch $dependency.tag $dependency.url $destination
if ($LASTEXITCODE) { throw "Dependency clone failed: $($item.Name)" }
}
$revision = git -C $destination rev-parse HEAD
if ($LASTEXITCODE -or $revision -ne $dependency.revision) {
throw "Dependency revision mismatch: $($item.Name)"
}
}
.\tools\build-pcvr.ps1 -VulkanHeaders 'C:/VulkanSDK/<version>/Include'
.\tools\start-pcvr.ps1Connect the headset before launching. For Steam Link, use tools/start-pcvr.ps1 -SteamVR. The default developer launcher uses Virtual Desktop when available. The local output
is build/pcvr/game/nfsu2-pcvr.exe; keep its required SDL and OpenXR DLLs beside
it. See PCVR build, configuration and testing notes.
Requires CMake, Android SDK platform/build-tools 35, NDK 29, JDK 17+ and Gradle 8.11.1, in addition to the common setup above. The build scripts fetch the pinned native dependencies automatically.
.\tools\build-quest.ps1 -Sdk 'C:\path\to\android-sdk' `
-Ndk 'C:\path\to\android-sdk\ndk\29.0.14206865' `
-JavaHome 'C:\path\to\jdk' -Gradle 'C:\path\to\gradle.bat'This produces a local development APK at
android/app/build/outputs/apk/debug/app-debug.apk. It requires your separate
game data. The setup panel can import your supported local ZIP, 7z or Xbox
ISO/XISO. See Quest build, import, installation and testing notes.
- Left menu: pause/Start. Right stick: menu navigation.
- Left stick click: cycle cameras, including Cockpit View.
- Right stick click: hold rear view outside the cockpit; no rear-view button inside it.
- Both stick clicks: recenter the seated view and release grips.
- While driving, A = nitro, B = handbrake; right stick up/down shifts gears with Manual transmission. Return the stick to center between shifts. Menu confirmation/back retain their normal mapping.
- Grip near any point on the wheel: steer with one or both hands. The wheel has 360 degrees total travel (180 each way). Held hands stay at their original contact points; release and regrip to move them, including hand-over-hand turns.
- Release both grips to retain the steering angle. Deflect the left stick at least 25% sideways to return to ordinary stick steering and centering.
- Triggers retain acceleration/braking. Enable Vibration in-game for rumble.
| Path | Contents |
|---|---|
android/ |
Quest application, importer and shared Vulkan/OpenXR integration |
pcvr/ |
Windows host, compatibility code and development preset |
src/ |
Port startup and handwritten runtime adaptations |
xboxrecomp/ |
Vendored recompilation toolkit and host runtime |
tools/ |
Build, code-generation, import and performance-analysis tools |
tests/ |
Focused regression tests |
assets/cockpits/ |
Generated cabin/glove sources, fitted runtime assets and preparation metadata |
The platform documentation contains historical measurements and references to private logs and captures. Those files are not part of this publication, and individual successful tests do not imply complete gameplay coverage.
See publication scope, inherited Switch/Linux documentation, performance notes and Vulkan notes. When reporting a bug, include the platform, source revision, runtime, settings and steps to reproduce it. Do not attach retail game files or generated game code.
Based on antoxa2584x/nfsu2-sw and sp00nznet/xboxrecomp, with the current PCVR and Quest 3 development work maintained by DR-89. See THIRD_PARTY.md for upstream revisions, credits and license notices. Existing source and dependency licenses are retained.
This is an unofficial fan project, not affiliated with or endorsed by Electronic Arts, Meta or Microsoft. Need for Speed and Underground are trademarks of Electronic Arts. No original game content is distributed.