Port Royale
Visual Pinball X VR

Home / Emulators

Visual Pinball X VR

Real pinball tables in VR and mixed reality on Meta Quest 3 and PICO.

About

Visual Pinball X standalone for Meta Quest 3 (OpenXR, Vulkan), based on vpinball 10.8.1. Stand in front of real and original tables, with the cabinet and backglass around you, or play them in your own room with passthrough.

One APK for Meta Quest and PICO: it uses the Khronos OpenXR loader, so the headset's own runtime takes over. On PICO it supports the PICO 4, Neo 3 and G3 controllers and installs on Android 10 (PICO 4, Neo 3). PICO support is not tested on PICO hardware yet: reports are very welcome.

Features

  • ๐Ÿ†• Brand new: Table Downloader: pick tables from the Visual Pinball Collection on archive.org right in the headset (+ โ†’ Download from Archive.org). ROM, backglass and NVRAM are installed with the table, ready to play
  • Main menu in VR (Meta Quest and PICO): the table library opens on a curved screen, point with a controller and pull the trigger. Left stick click switches between your room (mixed reality) and a black VR space
  • Mixed Reality (passthrough): see your real room around the table, switchable instantly while playing. The VR room of the table is hidden, so only the machine stands in your room
  • Standard cabinet for tables not built for VR: body, legs and backbox around the playfield, so the table stands in your room instead of floating
  • Backglass for tables not built for VR: rebuilt from the desktop backdrop, including working EM score reels
  • VR room switch: show or hide the VR room of any table from the menu, and cycle the rooms of the tables which offer some (also by holding the menu button)
  • Adjustable table position, angle, size and distance
  • Accidental Start presses are ignored while a ball is in play
  • The menu pauses the game

Manual

Visual Pinball X VR controller mapping

Installation

  1. Sideload the APK for your headset with SideQuest or adb install -r VPinball-VR-Beta-0.40.apk. The same APK works on Meta Quest and PICO.
  2. Start VPinball (Library โ†’ Unknown Sources) and get tables with + โ†’ Download from Archive.org: the table, its ROM and backglass are installed for you.
  3. Or use your own tables: put each in its own folder, with its ROMs next to it (VPinball/tables/<Table name>/<table>.vpx and VPinball/tables/<Table name>/pinmame/roms/<rom>.zip), and select the VPinball/tables folder in the settings.

Good to know

  • Williams / Bally / Data East tables show "Factory settings restored" on their very first start: quit once through the menu and start again.
  • Some VR tables ship with Const VRRoom = 0, which hides their cabinet. Put a copy of the table script next to the table as <table name>.vbs with VRRoom set to a room ("Ultra Minimal" is the lightest).
  • Updating from an earlier beta: install over it, settings and tables are kept.
  • Mixed reality (passthrough) is available on Meta Quest only; on PICO the menu and tables show in a black VR space. Some tables are several hundred MB: use a fast Wi-Fi connection.
  • PICO support is untested: if the app does not start, or the buttons are mapped differently, please open an issue on GitHub (headset model and PICO OS version).

Controller mapping

ButtonDuring playIn the menu
TriggersFlippers
GripsMagna save
โ˜ฐ (left menu)Open menu (hold: next VR room)Back / close
AStart game (hold 1 s while a ball is moving)Select
BInsert coinBack
X (hold)Move away from the table
YView mode: left stick = left/right & up/down, right stick = angle (press again to save). Hold: reset view
Left stick clickSize & distance mode: left stick = distance, right stick = size
Right stick clickLaunch ballReset page to defaults
Right stick up/downPlunger
Left stickNudgeNavigate

Button names are those of the Meta Quest controllers, PICO controllers use the same layout.

Download

Install from your browser

Over USB, for Meta Quest and PICO: installs the app and copies your own game files to the right place. No SideQuest, no adb. USB install works in Chrome or Edge on a PC, Mac or Android phone. No PC? Open this page in the Meta Quest Browser on your headset and install it right there.

The installer needs JavaScript. Use the manual download below.

First time? Before you start
  1. Turn on developer mode. Quest: Meta Horizon app on your phone โ†’ Devices โ†’ your headset โ†’ Headset settings โ†’ Developer mode. PICO: Settings โ†’ General โ†’ About โ†’ tap Software version 7 times, then Settings โ†’ Developer โ†’ turn on USB debugging.
  2. Connect the headset to this computer with a USB cable that carries data (not a charge-only cable).
  3. Close SideQuest and Meta Quest Developer Hub. If you use adb, run adb kill-server first: only one program can talk to the headset at a time.
  4. Windows: if the headset doesn't show up in the list, install the Meta Quest ADB driver.
  5. After pressing Connect, put on the headset and allow USB debugging for this computer.

All releases: github.com/SgtBilko76/VPinball-VR/releases

Need help or found a bug? Ask in #support on our Discord, and get new releases in #new-releases.

Join the Discord

Pictures & video

Credits: Based on Visual Pinball by the Visual Pinball development team.