MrSco/goldeneye-vr v0.5.16

GoldenEye VR v0.5.16

on GitHub

Speedrunning comes to GoldenEye VR: a mission timer to the hundredth, a
ghost of your best run to race, online leaderboards where you can download
anyone's run and race it, LiveSplit on your PC driven from the headset, and
a debrief that says what each run was played on. Ported from Dab's Mod's
timer and Ghost Time Trials, and shaped by what speedrunners and their boards
ask for. It plays online with v0.5.15.

Speedrun timer

• Play > Speedrun timer (or Rules > Game rules in the in-game panel):
  the mission time in the lower left, to the hundredth, in GoldenEye's own
  figures. It is the debrief's clock, unchanged: it stops in cutscenes, on
  the watch and while the controls are locked.
• Solo and co-op (your own mission's clock). In VR it sits on the HUD panel.

Ghost race

• Play > Ghost race: race your best run of a mission as a see-through
  Bond, walking, crouching, aiming and firing as you did. Beside the timer,
  the split: how far ahead (green) or behind (red) of your ghost you are.
• Your best run of each mission and difficulty is kept automatically when a
  mission is completed and counts for a best time, if it beats the last one.
• The ghost can't be shot, doesn't block you and never changes the guards'
  luck. Each campaign (GoldenEye, Goldfinger 64, Tomorrow Never Dies, Mirror
  Mode) keeps its own ghosts.

Ghost boards (online leaderboards)

• A new launcher tab, Ghosts: each mission and difficulty has a top-100
  board of GoldenEye's runs, all, VR or flat. Race on a row downloads that
  player's run and makes it the mission's ghost; Race my best goes back.
• Upload your best run of a mission, or Upload all my best runs. Runs
  go up under your Friends name: no new account.
• Boards rank the original rules: a run set with force pull, the AI ally or
  a changed movement speed stays yours to race but isn't ranked. Each run is
  checked for being a real recording of the mission; times themselves are
  taken as recorded.

LiveSplit

• Play > LiveSplit: the mission clock to LiveSplit on your PC, from the
  headset over Wi-Fi or from the PC itself. In LiveSplit, choose Control >
  Start TCP Server (or set it to start with LiveSplit), and enter your PC's
  address in the launcher (empty on a PC means this computer). The line
  beside it turns green when connected.
• LiveSplit starts when Bond gets control and splits at each completed
  mission, with the debrief's time as Game Time (compare by Game Time).
  Losing the first mission of a run resets it, so a level's retries start
  clean.

Debrief stamp

With the timer, the ghost race or LiveSplit on, the debrief's statistics page
lists what the run was played on, for anyone checking a run's video: the
version and build, the platform, VR or flat, the rules (any addition, or
"original rules"), the frame steps (the longest, and how many hit the
game's catch-up limit), auto-aim, the turning, the display rate and
SpaceWarp, and the art. With everything off the debrief is the original's.

Speedrun notes

• Strafe running works everywhere, as on the N64: forward and sideways
  together is about 1.4 times as fast as forward, with the Quest's stick, a
  pad, touch or the keyboard.
• The timer, ghosts and boards are new: please report anything odd, with a
  debug log from the launcher.

Help wanted

• LiveSplit against a real LiveSplit, from a Quest over Wi-Fi.
• The debrief stamp on a headset: the turning, display rate and
  SpaceWarp it shows.
• The ghost of a long walked run: do the walk and strafe animations look
  right?
• Everything still listed under v0.5.15's help wanted.

Known issues

Those of v0.5.15, and:

• The boards check that a run is a whole recording of the mission, not that
  it was played fairly: a replay can't be verified without replaying it
  against the level.
• Only GoldenEye has boards; a ROM hack's missions race your own best run.

Update and compatibility

Quest: use Update in the headset launcher, or sideload
GoldenEye-VR-v0.5.16.apk. PC: the PC launcher's updater. On
iPhone/iPad, install the new IPA with SideStore.

Android version: 0.5.16; versionCode: 129; network protocol: 26.
v0.5.15 and v0.5.16 play online together.

Dedicated servers: re-run your setup line to update (nothing changed for
servers but the version).

• Windows PC (in PowerShell; sets up WSL for you if needed):
  irm https://raw.githubusercontent.com/MrSco/goldeneye-vr/main/tools/gevr-server-setup.ps1 | iex
• Linux or a cloud server (Ubuntu 24.04 or Debian 13, or newer):
  curl -fsSL https://raw.githubusercontent.com/MrSco/goldeneye-vr/main/tools/gevr-server-setup.sh | sudo bash

No download contains game data: bring your own GoldenEye 007 (USA) ROM, and
for Bean, your own copy of the XBLA release.

Downloads

Build 976aa58. Every download is built from the same commit.