L'assistant de configuration

Au premier lancement de PinReady, un assistant vous guide sur huit pages. Chaque option a un petit repère d'information : survolez-le, ou cliquez dessus sur un flipper, pour lire une explication en mots simples.

Vos réponses sont écrites dans VPinballX.ini, le fichier de réglages de Visual Pinball, en conservant les commentaires de ce fichier. S'il n'existe pas encore, PinReady fait d'abord créer par Visual Pinball son fichier complet par défaut, puis y ajoute vos choix. Vous pouvez rouvrir l'assistant à tout moment avec le bouton Config du lanceur ou avec pinready --config : chaque champ affiche vos réglages actuels. La plupart des réglages se changent aussi en jeu, depuis le menu de Visual Pinball sur la touche F12.

Réinitialiser la configuration efface toutes les réponses, met de côté le VPinballX.ini global sous le nom VPinballX.ini.reset-backup et repart de la première page. Vos tables ne sont pas touchées.

1. Écrans

La première page affiche le système détecté (par exemple Ubuntu 24.04 LTS · X11 · GNOME) pour que les signalements de bugs portent leur contexte, permet de choisir la langue de l'interface, et installe Visual Pinball si besoin.

Nombre d'écrans : 1 pour un ordinateur de bureau, 3 ou 4 pour un pincab complet (plateau, fronton, DMD et un topper facultatif).
Rôles : chaque écran est présenté avec son nom, sa résolution, sa fréquence (Hz) et sa taille physique. PinReady propose un rôle d'après la taille des écrans : le plus grand devient le plateau, puis viennent le fronton, le DMD et le topper. Changez n'importe quel rôle dans sa liste, ou marquez un écran comme inutilisé.
Mode d'affichage : Bureau (en fenêtre, pour un ordinateur classique), Cabinet (le plateau dessiné pour un écran posé à plat, fronton et DMD sur leurs propres écrans) ou Plein écran unique (plateau et fronton réunis sur un seul écran vertical). Le mode passe à Cabinet dès 2 écrans, et vous pouvez toujours le changer.
DMD externe (ZeDMD, PinDMD…) : cochez si vous avez un afficheur de score physique ; Visual Pinball le détecte au lancement d'une table.
Désactiver l'écran tactile : coupe la surcouche tactile de VPX, utile quand le plateau n'est pas tactile ou quand vous pilotez le flipper à distance.
Dimensions du meuble : largeur et hauteur de la barre avant (lockbar), inclinaison du plateau, votre taille et votre position. Déplacez les poignées sur le schéma ou tapez les valeurs ; elles donnent à la vue 3D la bonne perspective.

2. Rendu

Réglages graphiques du plateau. Le conseil de la page : partez des valeurs par défaut, puis ajustez selon votre machine.

Synchronisation : Aucune synchro, Synchro verticale, Synchro adaptative ou Cadencement (Frame Pacing), le choix par défaut de Visual Pinball. Chaque choix explique son compromis entre fluidité et délai de réaction.
Limite d'images par seconde : calée sur la fréquence de l'écran du plateau, pour ne jamais dessiner plus d'images que l'écran ne peut en afficher.
Qualité d'image : suréchantillonnage, MSAA, anticrénelage en post-traitement (FXAA et autres), netteté, reflets et taille maximale des textures.
Afficher les FPS (activé par défaut) montre un compteur d'images par seconde en jeu, pratique pour vérifier vos réglages juste après la configuration.
Bille ronde (activé par défaut) évite que la bille paraisse légèrement ovale quand elle va vite. Purement esthétique.

3. Inputs (commandes)

Chaque action de Visual Pinball a deux colonnes, Clavier et Joystick, qui fonctionnent côte à côte. Cliquez sur Mapper et appuyez sur une touche ou un bouton : une touche remplit la colonne Clavier, un bouton de joystick la colonne Joystick. Auto-assigner toutes les entrées passe toutes les actions en revue d'un coup. Les actions essentielles (batteurs, MagnaSave, départ, crédit, lancement de bille…) viennent en premier ; les actions avancées sont à un clic. PinReady vous prévient quand une touche est déjà utilisée par une autre action.

Cartes de contrôleur de flipper. Quand une carte Pinscape KL25Z, Pinscape Pico, DudesCab ou PinOne est détectée, PinReady choisit le profil correspondant et remplit la colonne Joystick avec la disposition de boutons d'usine de la carte ; Visual Pinball gère alors lui-même le lanceur de bille (plunger) et les secousses lues par l'accéléromètre. Choisissez Aucune pour assigner chaque bouton vous-même. Une manette détectée peut aussi servir pour les batteurs, le lanceur et les secousses.

KL25Z (KL Shield V5.1 / Brain / Rig Master)

Bouton	Nom sur la carte	Action VPX
0	START	`Start`
1	EXTRA-B	`ExtraBall`
2	COIN1	`Credit1`
3	COIN2	`Credit2`
4	L BALL	`LaunchBall`
5	EXIT	`ExitGame`
7	L FLIPP	`LeftFlipper + LeftStagedFlipper`
8	R FLIPP	`RightFlipper + RightStagedFlipper`
9	L MAGNA	`LeftMagna`
10	R MAGNA	`RightMagna`
11	FIRE	`Lockbar`
13	DOOR	`CoinDoor`
14	SERVICE EXIT	`Service1`
15	SERVICE -	`Service2`
16	SERVICE +	`Service3`
17	ENTER	`Service4`
19	VOL-	`VolumeDown`
20	VOL+	`VolumeUp`

Pinscape Pico (OpenPinballDevice)

Bouton	Nom sur la carte	Action VPX
0	Start	`Start`
1	Exit	`ExitGame`
2	Extra Ball	`ExtraBall`
3	Coin 1	`Credit1`
4	Coin 2	`Credit2`
5	Coin 3	`Credit3`
6	Coin 4	`Credit4`
7	Launch Ball	`LaunchBall`
8	Fire	`Lockbar`
9	Left Flipper	`LeftFlipper`
10	Right Flipper	`RightFlipper`
11	Upper Left Flipper	`LeftStagedFlipper`
12	Upper Right Flipper	`RightStagedFlipper`
13	MagnaSave Left	`LeftMagna`
14	MagnaSave Right	`RightMagna`
16	Slam Tilt	`SlamTilt`
17	Coin Door	`CoinDoor`
18	Service Cancel	`Service1`
19	Service Down	`Service2`
20	Service Up	`Service3`
21	Service Enter	`Service4`
22	Left Nudge	`LeftNudge`
23	Forward Nudge	`CenterNudge`
24	Right Nudge	`RightNudge`
25	Volume Up	`VolumeUp`
26	Volume Down	`VolumeDown`

DudesCab (Arnoz)

Bouton	Nom sur la carte	Action VPX
0	Start	`Start`
1	ExtraBall	`ExtraBall`
2	Coin1	`Credit1`
3	Coin2	`Credit2`
4	LaunchBall	`LaunchBall`
5	Return	`ExitGame`
7	Flipper Left	`LeftFlipper + LeftStagedFlipper`
8	Flipper Right	`RightFlipper + RightStagedFlipper`
9	Magna Left	`LeftMagna`
10	Magna Right	`RightMagna`
12	Fire	`Lockbar`
13	Door	`CoinDoor`
14	ROM Exit	`Service1`
15	ROM -	`Service2`
16	ROM +	`Service3`
17	ROM Enter	`Service4`
18	VOL -	`VolumeDown`
19	VOL +	`VolumeUp`

CSD PinOne

Bouton	Nom sur la carte	Action VPX
0	VPX 1	`RightFlipper`
1	VPX 2	`RightMagna`
2	VPX 3	`LeftFlipper`
3	VPX 4	`LeftMagna`
4	VPX 5	`ExtraBall`
5	VPX 6	`Start`
6	VPX 7	`Credit1`
7	VPX 8	`ExitGame`
8	VPX 9	`Lockbar`
15	VPX 16	`VolumeUp`
16	VPX 17	`VolumeDown`
17	VPX 18	`CoinDoor`
18	VPX 19	`Service1`
19	VPX 20	`Service2`
20	VPX 21	`Service3`
21	VPX 22	`Service4`
23	VPX 24	`LaunchBall`

Les numéros de bouton sont ceux que rapporte SDL, comptés à partir de 0. Les boutons laissés libres par un profil ne sont pas listés.

4. Accessoires

Effets DOF (lumières et jouets)

VPX 10.8.1 standalone intègre DOF (Direct Output Framework), qui pilote les solénoïdes, lumières, moteur de vibration (shaker), knocker ou gyrophare d'un meuble. Il lui faut seulement une configuration qui décrit votre matériel. La page vous guide :

Créez un compte gratuit sur le ConfigTool de VPUniverse.
Créez une table correspondant à votre meuble, ajoutez son système de sorties (Pinscape, LedWiz, PinOne, DudesCab, PacLed, TeensyStripController…) et associez vos périphériques aux sorties.
Cliquez sur Generate, téléchargez le zip et décompressez-le dans le dossier cible : le bouton Ouvrir le dossier dans l'explorateur vous y emmène.
Activez DOF : Visual Pinball est livré avec tous ses plugins désactivés, rien ne se déclenche en jeu tant que vous ne l'avez pas fait.

PinReady peut aussi chercher votre carte de sorties en USB et vous dire quel type de contrôleur choisir dans le ConfigTool. Sous Linux, il affiche, copie ou installe les règles udev qui donnent accès à la carte. Un testeur de sorties, qui active chaque sortie à tour de rôle avec un arrêt de sécurité intégré, ne fonctionne pour l'instant qu'avec un simulateur.

Head tracking (suivi de la tête)

Pour les meubles équipés d'une Kinect ou d'une caméra sur le fronton ou le topper : la perspective de la table suit votre tête. Un clic télécharge le plugin head tracking et sa démo, active le plugin, passe Visual Pinball dans le mode d'affichage Window dont il a besoin, et ouvre la démo pour installer les pilotes de la caméra et vérifier que vous êtes bien suivi. Non disponible sur les Mac Intel.

5. Tilt / Nudge (secousses)

Réglages de l'accéléromètre qui détecte quand vous secouez le meuble (le « nudge »).

Type de capteur : Manette de jeu pour le stick d'une manette, Capteur d'intention pour les meubles équipés d'une carte à accéléromètre comme Pinscape ou DudesCab (il ignore les petites vibrations et transforme une vraie poussée en secousse), Capteur de cabinet pour un capteur rapide et propre dont les mesures sont appliquées telles quelles.
Intensité : la force avec laquelle une secousse pousse la bille. En pratique, le seul réglage qui mérite d'être ajusté.
Zone morte : les toutes petites mesures sous ce seuil sont ignorées, pour que les vibrations et le bruit du capteur ne fassent pas bouger la bille.
Plage de l'accéléromètre : une caractéristique de votre carte, pas une préférence. PinReady la lit sur la carte quand celle-ci la publie, et vous prévient si la valeur choisie ne correspond pas.
Seuil de TILT : jusqu'où vous pouvez secouer avant que le jeu ne déclare un tilt.

Secouez le meuble et regardez la vue en direct : un point montre chaque secousse face à des anneaux pour la zone morte, le seuil de secousse et le tilt ; franchir l'anneau rouge, c'est TILT. PinReady garde aussi le pic mesuré, vous signale quand l'angle de tilt est hors de portée du capteur, et vous demande de vérifier le sens de montage de la carte, car une carte tournée dans le mauvais sens inverse ou échange les directions des secousses.

6. Audio

Visual Pinball joue le son sur deux périphériques, et PinReady liste vos cartes son pour chacun :

Backglass (fronton) : musique, voix et sons généraux du jeu.
Playfield (plateau) : les bruits mécaniques (batteurs, bumpers, bille qui roule). Pour le surround ou le SSF, ce doit être la sortie multicanal.

Mode de sortie du plateau. PinReady présélectionne un mode selon le nombre de canaux détectés, et affiche un schéma de la disposition des enceintes avec le câblage nécessaire.

Mode	Pour
2 canaux — Stéréo avant	Stéréo simple, les deux enceintes à l'avant du meuble.
2 canaux — Stéréo arrière (barre avant)	Stéréo simple, les deux enceintes près de la barre avant, côté joueur.
5.1 — Arrière à la barre avant	Ajoute la position avant/arrière ; canaux arrière à la barre avant. Demande une carte son 6 canaux.
5.1 — Avant à la barre avant	Idem, avec les canaux avant à la barre avant. Prenez celui qui correspond à votre câblage.
SSF — Latéral & arrière (Historique)	Surround Sound Feedback avec l'ancien mixage.
SSF — Latéral & arrière (Nouveau)	Surround Sound Feedback avec le mixage récent, recommandé.

Câblage pour une carte son 7.1, la configuration SSF recommandée (les couleurs des prises peuvent varier selon la carte) :

Prise	Canaux	Branchement dans le meuble
Vert (Front)	FL / FR	Enceintes du fronton (musique) ou système 2.1
Noir (Rear)	BL / BR	Transducteurs du haut du plateau (côté fronton)
Gris (Side)	SL / SR	Transducteurs du bas du plateau (côté barre avant, joueur)
Orange (Center/Sub)	FC / LFE	Caisson de basses ou bass shaker (facultatif)

Volumes et tests. Réglez le volume de la musique et celui du plateau, puis vérifiez le câblage : le test 1 joue une musique en boucle sur le fronton avec une balance gauche/droite ; le test 2 joue un son sur chaque enceinte du plateau à tour de rôle, puis fait rouler une bille du haut vers le bas et de gauche à droite. Si la bille va dans le mauvais sens d'avant en arrière, changez le mode de sortie ; de gauche à droite, vérifiez le câblage. Une carte son à 3 prises seulement (verte, rose, bleue) peut souvent passer en 5.1 ou 7.1 : voir les guides pour Linux, Windows, macOS (en anglais et en français).

7. Tables

Choisissez le dossier qui contient vos tables, un sous-dossier par table : le format utilisé par Visual Pinball 10.8.1.

Tables/
└── Nom de la table/
    ├── Nom de la table.vpx          fichier de la table (obligatoire)
    ├── Nom de la table.directb2s    fronton (facultatif)
    ├── Nom de la table.ini          réglages propres à la table (facultatif)
    ├── Nom de la table.vbs          patch de script (facultatif)
    ├── medias/launcher.png          image pour le lanceur (facultatif)
    ├── pinmame/roms/<rom>.zip       ROM (obligatoire pour les tables à ROM)
    ├── altsound/<rom>/             pack alt-sound (facultatif)
    ├── pupvideos/<rom>/            vidéos PinUP Player (facultatif)
    ├── serum/<rom>/<rom>.crz       colorisation Serum (facultatif)
    └── vni/<rom>/<rom>.vni         colorisation VNI, avec .pal (facultatif)

La colorisation du DMD aux formats Serum (.crz) et VNI (.vni + .pal) est prise en charge ; les formats propriétaires comme .pac ne le sont pas.

Ranger votre collection au nouveau format. Indiquez à PinReady un seul dossier (une collection de tables, une ancienne installation VPX, voire un disque entier). Il indexe tout ce qu'il contient, puis donne à chaque table son propre dossier avec la ROM, le fronton, le PUP pack, l'alt-sound, la colorisation et la musique qui lui reviennent. Si vos tables ont déjà chacune leur dossier, elles restent en place et les fichiers manquants sont ajoutés. Lancez d'abord un aperçu, puis choisissez de copier (sans risque) ou de déplacer les fichiers.
Compatibilité Visual Pinball Standalone (désactivée par défaut) : PinReady reconnaît le script intégré à chaque table et, quand Le-Syl21/vpx-standalone-scripts propose un patch, place le .vbs corrigé à côté du .vpx. Un .vbs personnel est conservé sous le nom <table>.pre_standalone.vbs.
Enrichissement du catalogue (activé par défaut) : identifie chaque table dans le Virtual Pinball Spreadsheet et télécharge une image de fronton et un jingle audio depuis VPinMediaDB dans le dossier medias de la table. La première synchronisation télécharge environ 7 Mo de catalogue, plus quelques Mo par table identifiée. Désactivez-le sur un flipper hors ligne.

8. Système

Des options de confort facultatives, surtout utiles sur un flipper dédié :

Lancer PinReady automatiquement au démarrage.
Raccourcis dans le menu et association des fichiers .vpx : ajoute PinReady et Visual Pinball au menu des applications (GNOME, KDE ou XFCE sous Linux, Launchpad sous macOS, menu Démarrer sous Windows) et ouvre les fichiers .vpx avec Visual Pinball. Décochez et terminez à nouveau l'assistant pour tout retirer.
Raccourci sur le bureau et, sous GNOME, épinglage dans le dock.
Miroir auto-hébergé : récupérer les patches de script et la base de médias depuis votre propre serveur plutôt que depuis GitHub.