Raspberry Pi 5 / 500 and PC (x86_64) only. Other boards do not have the required graphics power, and the vpinball system does not appear on them.
Delete the graphics driver's shader cache, which is sometimes corrupted after an update:
/recalbox/share/system/.cache/mesa_shader_cache_db
It will be rebuilt on the next launch — the first game will take slightly longer to start, which is normal.
If the problem persists, check that the table really is a valid .vpx file, and try a table known to work before blaming Recalbox.
There is no official list: the .vpx catalogue is huge, entirely community-driven, and compatibility depends on the table itself (which VPX version it targets, which plugins it uses, how complex its 3D scene is) as much as on your machine.
A few pointers:
pinball.profile=1 (performance) or 4 (Raspberry Pi profile) in recalbox.conf.To share your findings or ask whether a table runs on your machine, the Recalbox Discord is the liveliest place.
The table needs a PinMAME rom you have not provided. Create a roms folder next to the .vpx file and drop the expected .zip archive in it (its exact name is stated by the table's author).
┣ 📁 My Table
┃ ┣ 🗒 My Table.vpx
┃ ┣ 📁 roms
┃ ┃ ┣ 🗒 pinmame_rom.zip
Recalbox points PinMAME at the table's folder: if all your tables sit at the root of vpinball, the roms folder must be at the root too.
Its size is set with pinball.score_size in recalbox.conf. The value is a multiplier of the DMD's native size (128 × 32 dots): 2 by default, i.e. a 256-dot-wide panel. Go up to 3 or 4 on a large screen, down to 1.5 if the panel eats into the table.
In FSS mode (portrait screen), the DMD is embedded at the bottom left of the playfield: this is intentional, VPX's upright view has no backdrop to put it on.
Check the pinball.custominput value in recalbox.conf:
0 (default): Recalbox builds the mapping from your pad. This is what you want in almost every case;1: Recalbox leaves the controls alone, you define them yourself in VPX's LiveUI (HOTKEY + B);2: the pad is deliberately disabled inside VPX, to be routed through a pad-to-keyboard.If you are on 1 or 2 without knowing it, set it back to 0.
HOTKEY + START. The HOTKEY + B combination opens the LiveUI, the in-game settings menu.
Yes, but on PC only, in cabinet mode: you need a .directb2s file next to the table, a second screen plugged in, the main screen in TATE rotation, and in recalbox.conf: pinball.cabinet=1, pinball.screen1, pinball.screen2 and their resolutions. Everything is detailed in Usage and settings.
In /recalbox/share/system/configs/vpinball/. Since VPinballX-configgen.ini is regenerated on every launch, do not edit it: use a per-table override/*.ini, or a VPinballX-custom.ini if you want to drive everything yourself.