ROLLER VR - Windows build (SteamVR / OpenXR)

A VR mode for ROLLER, the open reimplementation of the 1995 game Whiplash /
Fatal Racing. Source and licence (GPLv3): https://github.com/BoulderM/ROLLER-vr
Built from commit ba4da8301eae6bebd0dde7f42c33cd7d0abd8bc4. Based on https://github.com/FatalDecomp/ROLLER

This zip contains NO game data. You need your own copy of the game.

Developed and played on: Windows 11, SteamVR 2.18, Steam Frame with its
controllers. Other headsets, Touch controllers and other OpenXR runtimes should
work in principle.

New in 1.0.0: the changes merged from upstream ROLLER since 0.2.0 (fixes for two
crashes, switching the audio output device while playing and loading a saved
championship; track angles rounded like the original game; Space no longer
switches the car set on the car select screen). The VR OPTIONS page (comfort
vignette, HUD layouts) from 0.2.0 is described below. Tell me how it goes
(issues link below).


SETUP

1. Make SteamVR the active OpenXR runtime (SteamVR > Settings > Developer >
   "Set SteamVR as OpenXR runtime").

2. Put the contents of the FATDATA folder from your own retail disc into a new
   folder called "fatdata" next to roller-vr.exe. (Copy this whole folder to a
   normal drive first, for example C:\Games\Fatal; it writes its log and
   settings next to the exe.)

3. Start SteamVR, then double-click RUN-VR.bat. The main menu floats in front of
   you (about 2 m ahead) and is mirrored in a small desktop window. Click that
   window to use the keyboard in menus.

   RUN-VR-DEMO.bat starts the attract-mode demo on TRACK1 instead of the menu.


CONTROLS (Frame controllers; gamepads and wheels use the same layout)

  Left stick           steer
  Right trigger        accelerate. Hold it fully down: after GO the engine
                       needs about a second before the car moves.
  Left trigger         brake
  Shoulders / grips    the gearbox is automatic; to shift by hand use the left
                       shoulder or grip (down) and the right one (up)
  Menu (Start)         pause menu (D-pad up/down and A in menus; Menu resumes).
                       QUIT RACE returns to the menus.
  View + Menu, 2 s     quit from anywhere (Menu alone on controllers without View)
  Both stick clicks    save a screenshot (both eye images, plus the HUD or menu)
                       to a "screenshots" folder next to roller-vr.exe

A keyboard, gamepad or wheel also works if it is plugged in before you start.


VR OPTIONS (pause menu)

Pause (Menu) and pick VR OPTIONS (between SOUND and DEFINE CONTROLS). D-pad up/down pick an
option, left/right or A change it, B goes back. Changes apply at once and are saved in
roller-vr.ini next to roller-vr.exe (vignette=off|mild|strong, hud=original|spread|wide).

  VIGNETTE      Off by default. If fast racing makes you feel unwell: the edges of your view
                darken while the car's view is turning hard (corners, ramps, loops) and fade
                back out afterwards. Turning your own head never triggers it. While the page
                is open the ring is shown at its darkest so you can see the setting.
  HUD LAYOUT    ORIGINAL shows the game's HUD as one sheet in front of you. SPREAD and WIDE
                keep every element as it is, in the same corner, but move the five clusters
                (position, timer, lap, minimap, speedometer) 1.5 / 2 times further from the
                centre so the middle of your view stays clear.


SOUND

The retail FATAL.INI ships with sound effects and music switched off. If you
hear nothing, pause (Menu) and use the SOUND item to switch them on.


IF SOMETHING GOES WRONG

roller-vr.log is written next to roller-vr.exe (or in %APPDATA%\ROLLER\roller-vr
if that folder is not writable). It lists the OpenXR runtime, the controller
profile SteamVR chose, audio settings and, while racing, the car state. If the
game closes at once, check that SteamVR is running and that "fatdata" holds the
game files. Please attach the log to any bug report:
https://github.com/BoulderM/ROLLER-vr/issues

Not included: the CD-audio rips some ROLLER builds read from an "audio" folder
(optional; without them music comes from the game's own music files).
