Visual Pinball Standalone (VPX) est le simulateur de flippers de Recalbox. Il est disponible sur Raspberry Pi 5 / 500 et sur PC (x86_64) — les autres machines n'ont pas la puissance graphique nécessaire.
En 10.1, Recalbox génère lui-même la configuration de VPX à chaque lancement : profil de qualité, taille et position du DMD, mode d'affichage, mapping de la manette. Vous n'avez donc plus à toucher aux fichiers .ini de VPX pour jouer — sauf si vous voulez prendre la main, et cette page vous explique alors où le faire.
Les tables se placent dans /recalbox/share/roms/vpinball, au format .vpx. Deux organisations sont possibles.
┣ 📁 recalbox
┃ ┣ 📁 share
┃ ┃ ┣ 📁 roms
┃ ┃ ┃ ┣ 📁 vpinball
┃ ┃ ┃ ┃ ┣ 📁 Ma Table
┃ ┃ ┃ ┃ ┃ ┣ 🗒 Ma Table.vpx
┃ ┃ ┃ ┃ ┃ ┣ 🗒 Ma Table.directb2s
┃ ┃ ┃ ┃ ┃ ┣ 📁 roms
┃ ┃ ┃ ┃ ┃ ┃ ┣ 🗒 rom_pinmame.zip
┃ ┃ ┃ ┃ ┃ ┣ 📁 override
┃ ┃ ┃ ┃ ┃ ┃ ┣ 🗒 desktop.ini
Chaque table est isolée avec ses dépendances : c'est de loin le plus simple à maintenir, à sauvegarder et à dépanner.
┣ 📁 recalbox
┃ ┣ 📁 share
┃ ┃ ┣ 📁 roms
┃ ┃ ┃ ┣ 📁 vpinball
┃ ┃ ┃ ┃ ┣ 🗒 Ma Table 1.vpx
┃ ┃ ┃ ┃ ┣ 🗒 Ma Table 2.vpx
┃ ┃ ┃ ┃ ┣ 📁 roms
┃ ┃ ┃ ┃ ┃ ┣ 🗒 rom_table_1.zip
┃ ┃ ┃ ┃ ┃ ┣ 🗒 rom_table_2.zip
Toutes les tables partagent alors le même dossier roms.
Seul le fichier .vpx est obligatoire : beaucoup de tables se jouent avec lui et rien d'autre. Tout le reste est optionnel et dépend de la table :
| Élément | Rôle |
|---|---|
<table>.vpx |
La table elle-même. Indispensable. |
<table>.vbs |
Le script de la table, quand il est fourni séparément. Certaines tables ne démarrent pas sans lui. |
<table>.directb2s |
Le backglass (le fronton illuminé). Nécessaire pour l'afficher sur un second écran. |
Dossier roms |
Les roms PinMAME (.zip), qui contiennent le programme d'origine du vrai flipper. Recalbox pointe PinMAME sur le dossier de la table : le sous-dossier roms doit donc être à côté du .vpx. |
Dossier altsound |
Bandes-son alternatives. |
Dossier altcolor |
Colorisation du DMD (l'afficheur des scores). |
Dossier pupvideos |
Contenus vidéo PinUP Player affichés sur le backglass. |
Dossier override |
Vos surcharges de configuration, voir plus bas. |
Toutes les tables n'ont pas besoin d'une rom PinMAME : les tables « originales » (créations modernes) n'en utilisent pas. Le nom exact de la rom attendue est indiqué par l'auteur de la table.
Recalbox choisit le mode automatiquement, en fonction de l'orientation de l'écran et de vos réglages :
| Mode | Quand ? | Ce que vous voyez |
|---|---|---|
| Desktop | écran à l'horizontale (le cas par défaut) | la table dans son décor, avec le backglass et le DMD dessinés par la table elle-même |
| FSS (Full Single Screen) | écran à la verticale — rotation TATE gauche ou droite |
la table redressée occupe tout l'écran, le DMD est incrusté en bas à gauche |
| Cabinet | PC uniquement, écran vertical + pinball.cabinet=1 + un second écran configuré |
la table sur l'écran principal, le backglass et le DMD sur le second écran |
La rotation d'écran se règle dans les options d'affichage de Recalbox (mode TATE). Sur un PC portable en mode cabinet, la table s'affiche sur l'écran externe redressé et les scores sur l'écran interne.
Sur Raspberry Pi 5, le mode cabinet n'est pas disponible : la carte ne pilote qu'une seule sortie pour VPX. Le mode FSS y donne le meilleur résultat sur un écran monté à la verticale.
recalbox.confTous les réglages de Visual Pinball se font dans recalbox.conf : en 10.1, il n'y a pas de menu dédié dans EmulationStation.
| Option | Valeurs | Défaut | Effet |
|---|---|---|---|
pinball.profile |
1 performance, 2 valeurs de la table, 3 qualité, 4 Raspberry Pi |
4 sur Pi 5, 1 ailleurs |
Profil de rendu : anticrénelage, réflexions, occlusion ambiante, filtrage anisotrope… |
pinball.ball_trail |
0 / 1 |
0 |
Traînée derrière la bille. |
pinball.score_size |
multiplicateur (1, 1.5, 2, 4…) |
2 |
Taille du DMD. Le DMD fait 128×32 points : 2 donne un panneau de 256 points de large, 8 de 1024 (soit 80 % d'un écran de 1280). |
pinball.cabinet |
0 / 1 |
0 |
Active le mode cabinet (PC avec deux écrans uniquement). |
pinball.screen1 |
nom de sortie (HDMI-1, DP-1…) |
— | Écran de la table. |
pinball.screen2 |
nom de sortie | — | Écran du backglass. Obligatoire en mode cabinet. |
pinball.screen1.resolution |
1920x1080 |
1920x1080 |
Résolution de l'écran de la table. |
pinball.screen2.resolution |
1920x1080 |
1920x1080 |
Résolution de l'écran du backglass. |
pinball.custominput |
0 / 1 / 2 |
0 |
0 : Recalbox configure la manette ; 1 : vous la configurez vous-même dans le LiveUI de VPX ; 2 : manette désactivée dans VPX, pour passer par un pad-to-keyboard. |
pinball.autoconf |
0 / 1 |
0 |
Génération automatique d'un fichier de réglages pour la table lancée. |
Deux autres réglages sont repris des options générales de Recalbox : l'affichage du compteur de FPS et la vibration de la manette.
Recalbox construit lui-même le mapping à partir de votre manette, en s'appuyant sur ses vrais index de boutons — inutile de le refaire dans VPX.
| Commande | Action |
|---|---|
L1 / R1 |
Flipper gauche / droit |
R2 |
Lanceur de bille |
B |
Bouton d'action (lockbar) |
Y / A |
Magnasave gauche / droit |
HAUT |
Secousse centrale (nudge) |
GAUCHE / DROITE |
Secousse gauche / droite |
SELECT |
Insérer un crédit |
START |
Démarrer la partie |
X |
Pause |
L2 |
Ouvrir la porte à monnaie (mode service) |
L3 |
Menu de service du flipper |
HOTKEY + B |
Ouvrir le LiveUI (options de la table) |
HOTKEY + START |
Quitter la table |
Dans le LiveUI, la navigation se fait avec la croix directionnelle, ou avec les magnasave (Y / A) pour monter et descendre et les flippers (L1 / R1) pour valider et modifier — le schéma d'origine de VPX.
Le LiveUI (HOTKEY + B) permet d'ajuster une table en cours de partie. Pour figer des réglages, créez à côté de la table un dossier override contenant un fichier .ini nommé d'après le mode d'affichage :
┣ 📁 Ma Table
┃ ┣ 🗒 Ma Table.vpx
┃ ┣ 📁 override
┃ ┃ ┣ 🗒 desktop.ini
┃ ┃ ┣ 🗒 FSS.ini
┃ ┃ ┣ 🗒 cabinet.ini
┃ ┃ ┣ 🗒 default.ini
Au lancement, Recalbox copie le fichier correspondant au mode courant (desktop.ini, FSS.ini ou cabinet.ini) à côté de la table, sous le nom <table>.ini — c'est le fichier de réglages par table de VPX. Si le fichier du mode n'existe pas, default.ini est utilisé ; si aucun des deux n'existe, l'éventuel <table>.ini résiduel est supprimé.
Ce fichier reprend la structure de VPinballX.ini : des sections entre crochets ([Player], [ScoreView], [Backglass], [Plugin.PinMAME]…) suivies de lignes Clé = Valeur. Le moyen le plus fiable d'obtenir les bonnes clés est de régler la table dans le LiveUI, puis de reprendre les valeurs affichées.
Recalbox écrit sa configuration dans :
/recalbox/share/system/configs/vpinball/VPinballX-configgen.ini
Ce fichier est régénéré à chaque lancement : le modifier ne sert à rien. Si vous voulez piloter VPX entièrement vous-même, créez à la place le fichier :
/recalbox/share/system/configs/vpinball/VPinballX-custom.ini
Dès qu'il existe, Recalbox l'utilise tel quel et cesse de configurer quoi que ce soit : profil de qualité, DMD, mode d'affichage et mapping de manette sont alors entièrement de votre ressort. Supprimez-le pour revenir au comportement automatique.
Réservé aux utilisateurs avertis : la plupart des problèmes de tables se règlent bien plus vite avec
pinball.profileet le LiveUI qu'avec un fichier de configuration écrit à la main.