Questions and answers

PinReady is built to support the development and adoption of Visual Pinball X 10.8.1. It targets testers and early adopters of the new 10.8.1 architecture: integrated plugins, one folder per table, SDL3/bgfx engine. If your cabinet runs a stable VPX 10.7.x setup that you rely on, PinReady is probably not for you yet.

No. The wizard starts from one screen: pick 1 screen and the Desktop display mode for a normal computer, and play with the keyboard or a gamepad. Two to four screens, pinball controller boards, accelerometers and surround sound are all optional.

No. The automatic install downloads a recent build of the Visual Pinball X fork tested with PinReady, from Le-Syl21/vpinball, not the official VPX build. If you prefer your own install, choose I already have Visual Pinball on the first page and point PinReady to the VPinballX_BGFX program.

Pinscape KL25Z (KL Shield V5.1, Brain, Rig Master), Pinscape Pico, DudesCab and CSD PinOne. When one is detected, its factory button layout fills the joystick column, and VPX handles the plunger and the accelerometer by itself. Any other joystick or gamepad works too: map its buttons one by one. See the Inputs page of the wizard.

Some older tables use VBScript features that only work on Windows. On the Tables page, turn on the automatic VBS patches: PinReady then places a patched script next to the table when Le-Syl21/vpx-standalone-scripts has one. It is off by default, because a patch can occasionally make a specific table worse. You can also do it by hand: take the .vbs matching your table from jsm174/vpx-standalone-scripts and put it next to the .vpx, with the same base name.

Put a .ini file next to the .vpx, with the same base name, containing only the settings you want to change; everything else comes from the global VPinballX.ini. To keep those settings inside the table file itself, vpxtool can extract the table (vpxtool extract MyTable.vpx) and put it back together with the ini inside (vpxtool assemble MyTable/).

Tables often ship large lossless images. vpxtool can convert them to WebP: vpxtool images webp MyTable.vpx.

Visual Pinball ships with every plugin turned off, DOF included. Generate your DOF configuration with the VPUniverse ConfigTool, extract it into the directoutputconfig folder, then turn DOF on from the Accessories page.

Check the accelerometer range on the Tilt / Nudge page. It must match the range your board really uses: PinReady reads it from the board when the board publishes it, and warns you when the selected value does not match. A wrong range makes every shake look too strong or too weak, and no other setting can make up for it. The page also tells you when the chosen tilt angle is out of the sensor's reach.

Use the tests on the Audio page. If the rolling ball goes the wrong way from front to back, change the output mode; if it goes the wrong way from left to right, check your left/right wiring. Jack colours vary between sound cards.

Raw USB HID access on Linux usually needs a udev rule. The Accessories page shows the rules, can copy them, or install them for you after asking for your password.

No. A screen is named differently depending on whether Visual Pinball runs under Wayland or X11, so PinReady remembers each screen by its position, size and EDID identity (the ID the monitor reports). When the launcher starts, it picks the driver VPX will use and updates the screen names in VPinballX.ini to match.

Open the wizard from the Configuration button of the launcher, or run pinready --config. To start from scratch, use Reset the configuration in the wizard: it forgets every answer and keeps your old VPinballX.ini as VPinballX.ini.reset-backup. Your tables are left alone.

When VPX exits abnormally, PinReady shows a report with the command to reproduce the crash, system information, the logs and the location of the crash dump. Click Copy or Save… and share it on Discord or in the GitHub issues.

Put a picture at medias/launcher.png in the table folder (.webp, .jpg and .jpeg work too), or a .directb2s backglass file. If pictures look out of date after you reorganized your tables, click Rebuild in the launcher.

See file locations. pinready --print-paths prints the paths PinReady actually uses.