GoldenEye VR

GoldenEye 007, running natively on your Meta Quest.
No PC, no streaming, no emulator: a from-source port built on the GoldenEye decompilation.

Install · GE-X · Controls · Troubleshooting · Build · Credits

Two ways to play. Pick one at launch, and switch any time in game.

Also:

• An in-VR launcher with Play, Controls, Comfort, and Screen tabs: ROM check, display mode, screen shape and size, turning, comfort, display rate (Auto and the headset's supported rates), aim steadying, a left-handed mode, swap sticks, gun fit (set where the gun sits in your hand), an in-game stats readout for troubleshooting, and a Cheats page (the classic cheats, tiny or big guns, and unlock all missions and cheats).

• HD textures: the launcher's Mods page downloads a fan-made texture pack on request and installs it in the headset:

  • GoldenEye 007 HD by intermissionfb and GhostlyDark (evilgames.eu, 129 MB).
  • GoldenEye 007 HD + AI (251 MB), our fork. It adds AI upscales of the game's own textures for the ones the pack doesn't cover yet: guards, weapons, parts of levels.

  Nothing of theirs ships with the app. New pack releases show up on the Mods page as updates.

  In game, hold Menu until the return-to-launcher prompt shows, then press X to switch the HD textures off and back on to compare.

• Multiplayer (experimental): deathmatch for up to eight players, with bots to fill the empty slots or to play against on your own, or the campaign in co-op for up to four, each in their own headset, over the internet or your Wi-Fi: browse public games or share a private code. See Multiplayer.

• 3D sound: gunfire, explosions, doors and the game's other sounds come from where they happen, through the same Steam Audio 3D audio as voice chat. A fight in the next room sounds like it's round the corner, not through the wall.

• GoldenEye X (optional, WIP): models and animations for every GoldenEye weapon and item, with magazines, single rounds and speedloaders reloaded by hand in VR, one-handed remote mines, and its arms wearing the watch, loaded from your own patched Perfect Dark ROM. See GE-X setup.

• Project Bean visuals (optional, experimental): characters, weapons, props, rooms and skies downloaded from the launcher's Mods page or loaded from your own extracted Bean files. Select Bean alongside HD / AI; switch during play through the watch VR options or one grip + right-stick click. GE-X keeps its first-person gear. See Project Bean setup and checks.

• Updates in the headset: the launcher offers each new release, no computer needed.

• Laser-pointer menus: point a controller at the file and mission folders and pull the trigger.

• Menus, briefings and cutscenes play on the virtual screen in both modes.

No Developer Mode, and no computer needed. You'll need:

• your Quest, on Wi-Fi
• your GoldenEye 007 (USA) ROM file: .z64, .v64 or .n64, 12 MB

Already set up with Developer Mode and SideQuest on your computer? See Install from a computer instead.

SideQuest is the most popular free store for apps outside the Meta Store, and it now installs straight from the headset.

1. In the headset, open the Browser and go to sdq.st/go. The SideQuest app downloads.
2. Open the browser's downloads, press the three dots next to the file, choose Export, and follow the prompts to install SideQuest.

SideQuest's own video walkthrough shows each step.

1. Open SideQuest in the headset. The first time, it's in Library under Unknown Sources.
2. Search for GoldenEye VR (its SideQuest page) and install it.
3. Optional: let SideQuest add GoldenEye VR to your main Library, so you don't have to look under Unknown Sources.

Put the ROM in the headset's Download folder:

• From a computer: plug the headset in with a USB-C cable (the charging cable works), put it on, and accept "Allow access to data". On Windows, open File Explorer and go to This PC → Quest → Internal shared storage → Download, then drop the ROM in. On a Mac, use an Android file transfer (MTP) app.
• Without a computer: in the headset's browser, download the ROM from your own cloud storage. Browser downloads land in Download.

In the headset, open Library, change the filter to Unknown Sources (or use the shortcut SideQuest added), and start GoldenEye VR. The launcher opens and shows "No GoldenEye ROM yet". That's expected.

1. Press Choose ROM file..., open Download, and pick your ROM. The app copies it into its own folder, and the ROM line turns green: GoldenEye 007 (USA) - OK.
2. Pick your options and press START. Enjoy, 007. 🍸

The older way, with SideQuest's desktop app over a USB cable. It needs Developer Mode, a USB-C cable (the charging cable works) and a Windows PC or Mac.

1. Turn on Developer Mode (one time only). Meta only lets a computer install apps once it's on.
   1. Go to developers.meta.com/horizon and sign in with the same Meta account your headset uses.
   2. Create an organization. It's free: any name works, then accept the agreement. If Meta asks you to verify your account, do that as well.
   3. On your phone, open the Meta Horizon app.
   4. Go to Devices, pick your headset, then Headset settings → Developer mode, and turn it on.
   5. Restart the headset.
2. Install SideQuest on your computer. Download the desktop app from sidequestvr.com/setup-howto and install it like any other program.
3. Connect your Quest. Plug the headset into your computer and put it on. A window asks "Allow USB debugging?". Tick "Always allow from this computer" and press Allow. In SideQuest, the dot at the top-left turns green and shows your headset's name. If it stays red or orange, unplug and replug the cable, and look inside the headset for the prompt again.
4. Install GoldenEye VR. Download GoldenEye-VR-vX.Y.Z.apk from the latest release. In SideQuest, click the "Install APK file from folder on computer" icon (a box with an arrow, top right), choose the APK, and wait for "All tasks completed". Dragging the APK onto the SideQuest window works too.
5. Copy your ROM into the headset's Download folder, as in step 3. On any computer, SideQuest's folder icon (Manage files on the headset) works too: open Download and upload the ROM. Then carry on from step 4.

adb install GoldenEye-VR-vX.Y.Z.apk

adb push "GoldenEye 007 (USA).z64" /sdcard/Android/data/com.gevr.port/files/data/ge.z64

From v0.1.13 on, the launcher checks GitHub for a newer version each time it opens. When one is out, an Update button appears beside Cheats.... Press it and confirm in the window that opens. The first time, a settings window asks first: turn on Allow from this source and the game comes back by itself. Your ROM and settings stay.

Coming from v0.1.12 or older, or if you'd rather not update in the headset: install the new APK the same way as the first time. Your ROM and settings stay where they are. Don't uninstall first: uninstalling deletes the app's folder, ROM included.

GoldenEye X is a ROM hack of Perfect Dark. This port can read its models and animations for every GoldenEye weapon and item, and its hands, arms and watch, as optional replacements while you play GoldenEye:

• every gun, from the PP7 to the Golden Gun;
• the Cougar Magnum and grenade launcher;
• the knives, grenades, mines and taser.

GE-X's campaign and maps are not imported.

Keep your usual GoldenEye 007 (USA) ROM installed. For GE-X, you also need your own legally obtained Perfect Dark USA v1.1 / Rev 1 ROM, in big-endian .z64 format (33,554,432 bytes; MD5 e03b088b6ac9e0080440efed07c1e40f), and the GE-X 6a patch from Wreck's N64 Vault page.

1. On your computer, apply GE-X_6a_01-19-25.xdelta to a clean Perfect Dark v1.1 ROM and save the result as gex.z64. Preserve the original. The full preparation guide covers byte-order conversion, patching with a GUI or Python, and checking the result.
2. Copy gex.z64 into the Quest's Download folder using USB or SideQuest.
3. Open the launcher's Play → Mods... page. Under GOLDENEYE X, press Choose ROM... and select the patched file. Look for GoldenEye X ROM chosen. The app stores it as Android/data/com.gevr.port/files/data/gex.z64.
4. Tick Its guns, items, hands and watch arm. It's off by default. During a mission you can switch it under the watch's VR settings → Mods and fun → GoldenEye X.

On the virtual screen, GE-X's own fire and reload animations play. To reload by hand in stereo VR, also turn on Hand reload (WIP) in Controls → Gestures.... It needs GoldenEye X; until GE-X is on, it reads Hand reload (needs GoldenEye X).

• Magazine guns. Pull the magazine with your off hand, grip a replacement at your belt, and seat it in the gun.
  • B/Y drops the magazine. A removed magazine keeps its rounds until you put it back or drop it.
  • The RC-P90's magazine lifts off the top.
  • On the PP7, cupping the pistol counts as support. Release, then grip clearly below it to remove its magazine.
• Shotguns, rocket launcher, Golden Gun and grenade launcher. Grip one round at your belt and insert it at the gun's port. Release the grip before taking another.
• Cougar Magnum. A belt grab takes a speedloader with up to six rounds. The cylinder swings open while you hold it, and inserting seats them all.
• Empty guns. Bring an empty gun to your belt to reload it directly.

See reload and fit controls.

Remote mines. With GoldenEye X on, remote mines and their detonator are one weapon:

• Your gun hand's trigger throws or places a mine.
• With your off hand empty, pull its trigger to set off every remote mine you've placed, in the headset or on the screen.
• The Detonator leaves the weapon cycle, the wheel and the watch's list.
• Your gun hand stays on the mines while any are out.
• GE-X's left hand wears the detonator watch, which shows your health, armor and radar.

Some mission-specific items may still need their fit adjusted in the headset (Gun fit..., below).

No Perfect Dark ROM, patched ROM or GE-X assets ship with the app. The app imports the file you prepare; it does not apply the patch for you. Use the Mods picker for GE-X and the Play page's Choose ROM file... for your GoldenEye ROM.

Real-world movement works too: lean around corners, duck, and step. Ducking behind cover hides you from guards. Aiming with the grip stops you walking, unless Aim: no lean is on.

Gestures... on the launcher's Controls tab turns each grip gesture on or off, and holds Watch gesture to pause. Anywhere else the grip aims as before. It also holds two options that are off by default:

• Hand reload (WIP): needs GoldenEye X. Guns stop reloading themselves, and B/Y stop reloading. You reload by hand as described under GoldenEye X, including when dual-wielding.
• Per-gun recoil: each gun kicks with Perfect Dark VR's recoil.

Game rules... on the Play tab offers three options, off by default: mines stick to guards (solo), bodies stay (the newest 12, 24 or 48, solo), and Fast reinforcements. Fast reinforcements increases difficulty by letting alerted guards call more reinforcements while earlier ones are still alive. It works with any body count, including Off. In co-op, the host controls Fast reinforcements for the mission. Turn it off for normal spawning. Keeping bodies alone preserves the original reinforcement behavior across all levels; 48 bodies no longer causes the reported enemy surge. See body retention and reinforcements.

VR settings, at the bottom of the watch's Game Options page, changes settings mid-mission in seven sections: Comfort, Controls, Gestures, Weapons, Display, Game rules, and Mods and fun. These include left-handed mode, stick swapping, gun fit, watch and grip gestures, reloads, recoil, motion throwing, screen size/distance/curve/passthrough, stats, the GoldenEye X toggle and gun size. Display → Refresh requests the supported rate immediately. Texture-pack selection and play mode stay outside these sections; switch play mode by holding the right stick click.

The watch's Control page shows your Touch controllers (Quest 1, Quest 2, Touch Plus or Touch Pro, picked from the headset; VR settings → Controls → Controllers picks them by hand), each above a list of what its controls do in your play mode and handedness. A control you press lights up on the model and in the list. See docs/touch-controllers.md.

Left-handed? Tick Left-handed in the launcher. The gun goes in your left hand and the watch on your right wrist, and the sticks and face buttons swap sides. The ☰ Menu button stays on the left controller: the right one is Meta's system button. To walk with the left stick anyway, tick Swap sticks as well.

Watch face status is on the launcher's Controls tab: Off keeps the standard displays, On (the default) shows both wrist and standard status, and Only shows wrist status during stereo gameplay. Holster the offhand to see the watch; its clock hands still show mission time. Pause-menu status stays visible in every setting, and virtual-screen mode keeps its standard displays. Disable Watch gesture to pause (under Gestures...) to read your wrist without opening the pause menu; the Menu button still pauses.

Host a deathmatch alone or play with up to eight players, each in their own headset, on the game's multiplayer stages. Or play the campaign together: up to four players in co-op, the host picking the missions. It's still experimental: expect rough edges, and please report what you find.

Everyone needs the same version of GoldenEye VR, and each player their own ROM.

Host a game. In the launcher press Multiplayer..., stay on the Host tab, and pick (across its Lobby, Match, Fun and Player tabs):

• the Mode: Deathmatch, or Co-op mission for the campaign (each player picks their own save folder, then the host picks missions, difficulty and briefings for everyone).
• Public game to appear in the internet browser, or Private game to share a join code.
• a stage and how many players it takes, from 2 to 8 on any stage.
• your character (on the Player tab).
• the weapons: the game's own sets, from Slappers only to the Golden Gun, proximity mines included.
• bots, to fill empty slots (see below).
• the Fun tab's rules, among them No radar and Hit immunity:, which sets how long a deathmatch hit is ignored after the last one: Short (the default, a quarter second, so a fast gun lands about four hits a second), None (every hit counts, as in Perfect Dark) or GoldenEye (the original half second to a second). Solo and co-op keep GoldenEye's rule.

Then press Start Hosting, and Launch once everyone connected shows Ready. You can launch alone. The host can explore in warmup without running the round clock or score. When a guest has loaded the map, the stage and equipment reset and the timed round begins together. If the last guest leaves, the host returns to warmup.

Join a game. Press Multiplayer... and choose the Join tab. Pick a public internet game (Public), enter a code (Private), or select a game discovered on your Wi-Fi (LAN). Direct IP remains available as a fallback. Then choose your character on the Player tab and tick Ready. Open spots can be joined during warmup or an active round. Joining a deathmatch round in progress, you watch until the next round starts, unless you take a bot's place; co-op joiners drop straight in. Reconnecting doesn't restore a previous score.

Bots. In deathmatch, the host's Match tab has a Bots: setting: Off, Fill empty slots, or Fixed count with 1 to 7 bots, plus a Bot difficulty: from Perfect Dark's six levels (Meat, Easy, Normal, Hard, Perfect, Dark). The same settings are on the pause menu's Rules tab as BOTS, BOT COUNT and BOT DIFFICULTY. They can be changed in the lobby and in warmup, and apply from the next round.

• Full players. Bots score, can win, and play as GoldenEye's characters ("Natalya (Bot)"). They use Perfect Dark's simulant brain, so they hunt by line of sight, react after a moment, and aim worse when they've just spotted you.
• Behaviour. Bots find their way round the level, open doors as GoldenEye's guards do, pick up guns and ammo, and go for the flag in Flag Tag and the gun in The Man with the Golden Gun.
• Hosting alone. A host on their own can start a match with only bots.
• Joining and kicking. A player who joins a full match takes the lowest-scoring bot's place straight away. The host can Kick a bot from the pause menu's roster.
• Host migration. If the host leaves, the next host takes over the bots and the match goes on.

In a match. ☰ Menu (or the watch gesture) opens the pause menu, with Match, Rules, Player and Audio tabs. The match goes on while it's open.

• Navigating. Point and pull a trigger, or use either stick. A or X selects; B or Y goes back, and B resumes.
• Buttons: Ready up / Unready, Request votes, Return to lobby and Leave match....
• Host only: Start match, Kick, and in co-op End mission....

Online, players don't block each other: overlapping players are pushed gently apart and slowed, so nobody can pin you in a corner. Walls and guards still stop you.

While you spectate, the gun hand's A follows the next player and B the previous one. In co-op, stand beside a downed teammate for 3 seconds to revive them.

Voice chat. Allow microphone access to talk. Everyone can hear each other in the lobby; in a match, voices get quieter with distance and come from the speaker's direction, like the game's own sounds. Mute with Mute microphone in the launcher, MIC on the pause menu's Audio tab, or Menu + B. Your mute choice is saved. If you deny microphone access, you can still hear other players.

Over the internet. No IP addresses and no router setup: headsets connect directly when they can, and through a Cloudflare relay when they can't. The game list and private codes come from our lobby service at lobbies.goldeneyevr.com, which shows public activity and keeps a game's listing and connection details (including IP addresses) only while the game is open. Games on your Wi-Fi still work without it (UDP 27008).

Not there yet: You don't see other players' hands move.

In co-op, every headset sees the tank move on Runway and Streets. Its engine sound still plays only for the driver. The reported invisible Bunker ending cutscene remains under investigation.

Launcher settings are saved for next time. Finer settings live in Android/data/com.gevr.port/files/data/goldeneye-vr.ini, which explains each line: gun position in your hand, HUD distance, player height and more. Edit it on your computer while the headset is plugged in.

The ROM section collapses after validation succeeds and opens when a ROM is missing or selection fails. Expand it to change files.

Display rate. Auto leaves the refresh rate to the headset and external profiles. New Quest settings default to Auto; existing saved choices remain selected. The launcher offers the rates supported by your headset, including 80 Hz where available. Explicit choices request a rate; Show stats reports the rate actually in use.

Render resolution. Quest uses the render dimensions recommended by its OpenXR runtime when the app starts. These can differ from the panel's physical resolution. The Video.VRRenderScale line in goldeneye.ini multiplies those dimensions, so an external resolution profile and a saved scale compound: a 2400×2600 recommendation at scale 2 requests 4800×5200 per eye. Use scale 1 when checking an external profile. Device limits can reduce the actual size without changing your saved scale; Show stats reports the actual eye-buffer size. Restart the app after changing an external resolution profile.

Actual QGO profile behavior is awaiting the device comparison.

Gun fit... (in Controls) sets where the gun sits in your hand, in the headset. Turn it on, start a mission in stereo with a gun, and move the gun with the sticks until its grip is in your hand. Hold the gun with both hands to fit the holding hand as well. A saves, B undoes back to the last save; the fit stays on for the next gun or gadget. In single player, Menu + A starts and ends it during play, so you can leave it, switch weapons and come back.

X steps through the fit modes the gun has. Left-handed, that's the A button. The modes are:

• gun and scope
• reload: with hand reload on, the left trigger marks the magazine grab point, and Y marks your belt with the off hand
• GE-X modes:
  • off hand: moves the palm. Hold the left grip to turn it, and the right grip to move and size the watch.
  • held magazine
  • magazine well: the left trigger marks the well
  • installed magazine
  • gun hand
• barrel tip

GE-X fits are saved separately from GoldenEye's. Holding a GE-X gun with both hands fits its supporting hand and grab point. See the fit guide for the full controls.

With a gadget in hand instead (a mine, keycard, key analyzer, document and so on), the same fit moves that gadget: the move stick forward and sideways, the turn stick up and down and (sideways) its size. Hold the right grip and the sticks turn it. A saves every gadget's fit to files/gevr_itempose.txt on the headset. Send debug log includes it and goldeneye-vr.ini (the gun fit), so fits can be made the defaults.

The launcher's first line shows the build, for example Build 4526b62 built 2026-09-23 15:10. Mention it when you report a bug.

The whole game boots, and the Dam has been played end to end in both modes. Other levels are playable but less tested. Expect rough edges: this is an early release. Found a bug? Open an Issue with:

• the build line from the launcher
• your headset model
• the level
• what happened

For the engineering side, see STATUS.md (short, kept current) and the archived session log in docs/archive/HANDOFF.md.

sdk.dir=C\:\\Users\\<you>\\AppData\\Local\\Android\\Sdk

cd android && ./gradlew.bat assembleDebug

Built on the shoulders of:

• n64decomp/007: the GoldenEye decompilation, our src/.
• Perfect Dark PC port: our host layer.
• Perfect Dark VR by Alex-LeTux: our VR layer.
• GoldenEye PC port: 64-bit porting findings.
• GEVR: the PC VR project that inspired this one.
• GoldenEye X by Wreck and collaborators, including Carnivorous's weapon animations and SubDrag's tools: the optional models and animations you supply through your own patched ROM.

CREDITS.md says exactly what each project contributed.

This project's own code is MIT licensed (LICENSE). Vendored components keep their own notices:

The app icon and banner art were made for this project.

Texture packs on the Mods page belong to their authors and are downloaded when you ask: GoldenEye 007 HD by intermissionfb and GhostlyDark (evilgames.eu). Our fork, GoldenEye 007 HD + AI (MrSco/GoldenEye-007-HD), is their pack plus AI upscales, made with tools/texai, for the textures it doesn't have yet.

_{GoldenEye VR is a non-commercial fan project. It is not affiliated with, endorsed by or sponsored by Nintendo, Rare, Microsoft, MGM, Danjaq or Eon Productions. GoldenEye 007, James Bond and 007 are trademarks of their respective owners. No copyrighted game content is distributed with this project; you must supply a ROM of a cartridge you own.}