Accueil » Technique » Retrogaming : borne d'arcade et système d'émulation multi-jeux »

Documentation du système Arcadebox

La documentation suivante permet de configurer un système adapté à l'utilisation pour le retrogaming sur une borne d'arcade multi-systèmes comme celles que nous construisons.

Bien que devant être étoffée pour une installation à partir de zéro, elle est fournie à titre d'exemple. Note : les chemins sont indiqués avec des / au lieu des antislashes.

Installation du système

Pour commencer, préparez le système hôte en installant Microsoft Windows 10.

Décompressez l'image de l'Arcadebox sur un disque vierge connecté au système, puis attribuez-lui la lettre F:

Le volume ainsi créé contient l'interface de lancement des jeux, les émulateurs, les médias et la documentation et peut accueillir les fichiers roms des jeux.

Configuration des contrôles

Vous devez commencer par configurer les contrôles (contrôleurs et boutons d'arcade) pour qu'ils correspondent aux touches de clavier utilisées par l'Arcadebox : si l'interface que vous utilisez pour les relier au PC est un IPAC d'Ultimark, le plus simple est d'utiliser le logiciel WinIPAC version 2 : https://www.ultimarc.com/download.html

Installation des binaires

Certains programmes doivent être installés sur le système hôte afin de créer les entrées de la base de registre requises pour que l'Arcadebox fonctionne correctement. En voici la liste :

—VNC

—TODO

Configuration de l'interface du système hôte

Le système hôte (Microsoft Windows 10) doit être configuré de manière à :

—permettre l'authentification automatique de l'utilisateur arcade au démarrage,

—désactiver les messages UAC (contrôle d'accès utilisateur)

—désactiver les éléments inutiles de son interface et les services non utilisés

—optionnellement, autoriser l'accès à distance/l'affichage distant via VNC

—lancer automatiquement l'interface au démarrage du système

Lancement automatique de l'interface

Un script .bat est fourni pour lancer automatiquement l'interface au démarrage du système. Alternativement, il est possible de lancer le programme F:HyperspinHyperspin.exe par vos propres moyens.

L'interface

Si tout s'est bien déroulé, lors du prochain redémarrage du système, l'interface de l'Arcadebox devrait apparaître à l'écran :

Navigation

La navigation dans l'interface s'effectue principalement à l'aide du contrôleur arcade gauche (Joueur 1) et de ses boutons précédemment associés à des touches ou combinaisons de touches du clavier.

Menus de l'interface

P1 : lance le jeu ou ouvre le menu sélectionné (1)

: accède aux favoris / ou aux listes par genre dans le menu Arcade

P2 : lance le jeu ou ouvre le menu sélectionné (2)

P1 + P2 : quitte le menu actif et remonte d'un niveau (Quitte l'interface et arrête le système au premier niveau) (Esc)

+ B1 : augmente le volume

+ B2 : diminue le volume

Arcade (MAME)

+ P1 : menu de configuration d'un jeu

+ P1 : émule la touche ENTREE pour valider

P1 : bouton de démarrage (start) du joueur 1

: bouton d'ajout de crédits d'un jeu

P2 : bouton de démarrage (start) du joueur 2

P1 + P2 : quitter le jeu

B1, B2, B3, B4, B5, B6 : fonctions définies pour le jeu

Ajout de contenus

Ajout d'un jeu à un sous-menu existant

Les noms des fichiers de rom, thème, image de menu et bezel d'un jeu doivent être identiques : c'est le nom du fichier ROM (sans son extension) qui est généralement utilisé comme base du nom des autres fichiers. Il est défini dans l'entrée du jeu dans le fichier XML de la liste des jeux F:/Hyperspin/Databases/MAME (ex. : game name="asurabus" définit le nom des fichiers du jeu Asura Buster). Dans les exemples utilisés, la base de données (MAME) correspond au menu Arcade Classics de l'interface.

Voici les différents fichiers nécessaires à chaque jeu :

ROM : les roms sont à prendre dans un fullset correspondant à la version installée de l'émulateur arcade MAME. Ces fichiers sont non redistribuables.

Bezel : les fichiers bezel (la décoration autour de l'écran) utilisés sont ceux disponibles pour l'émulateur MAME (au format .zip). Ils se trouvent dans F:/mame/artwork. Pour qu'un bezel soit visible, il doit être sélectionné/activé dans MAME (bouton P1 + →, Video Options).

Vidéo : Les fichiers vidéo des jeux sont au format mp4 : par exemple, vous pouvez chercher le jeu qui vous intéresse par titre dans http://www.progettoemma.net/ et copier la vidéo qui s'affiche dans le popup.

Thème : Les fichiers thèmes utilisés dans les menus, y compris pour les jeux (au format zip), sont ceux disponibles pour l'interface (frontend) Hyperspin : par exemple, vous pouvez créer un compte d'utilisateur, puis obtenir et enregistrer un thème pour le jeu qui vous intéresse sur http://www.hyperspin-fe.com/forum/downloads.php?do=cat&id=129 (thèmes pour MAME). Les thèmes au format 16:9 s'afficheront correctement, tandis que les thèmes au format 4:3 devront être modifiés.

Image de l'entrée (ou wheel i.e. roue) : chaque entrée dans un menu de l'interface correspond à une image au format png. Il est souvent possible de réutiliser l'image png du titre d'un jeu présente dans le fichier zip du thème (il suffit de l'extraire de l'archive et de l'enregistrer séparément).

Tous ces fichiers (à l'exception notable des fichiers de ROM, de bezel et de vidéo pour MAME) sont à enregistrer dans le dossier des médias d'HyperSpin (D:/Hyperspin/Media/) :
F:/Hyperspin/Media/<nom du menu>/Themes : fichier .zip du thème HyperSpin

F:/Hyperspin/Media/<nom du menu>/Video : fichier .mp4 de la vidéo du jeu
F:/Hyperspin/Media/<nom du menu>/images/Wheel : fichier .png du titre du jeu (pour la roue du menu des jeux)

Les fichiers de ROM, de vidéo et de bezel pour MAME sont à enregistrer dans le dossier de l'émulateur MAME (D:/mame) :

F:/mame/artwork : fichier zip du bezel

F:/mame/roms : fichier zip de la/des rom(s) du jeu (les dépendances sont visibles sur le site progettoemma.net/)

F:/mame/snap : fichier vidéo du jeu au format mp4 (ou image png)

Ajout de l'entrée du jeu dans la base de données du menu

Une fois les fichiers nécessaires placés dans les dossiers appropriés, Il ne reste plus qu'à ajouter le jeu à la liste des jeux disponibles (Database) d'HyperSpin : ces fichiers XML se trouvent dans F:/Hyperspin/Databases/ (le sous-dossier MAME contient la base de données correspondant au menu Arcade Classics de l'interface).

Chaque jeu possède sa propre entrée la base de données XML de son menu.

Voici un exemple d'entrée pour le jeu Bosconian de Namco :

<game name="bosco" index="" image=""> 

    <description>Bosconian (ボスコニアン Bosukonian)</description>

    <cloneof></cloneof>

    <crc></crc>

    <manufacturer>Namco</manufacturer>

    <year>1981</year>

    <genre>Shoot'em Up</genre>

</game>

- si le jeu est le premier à commencer par une lettre (selon l'ordre alphabétique), il faut renseigner index=<première lettre du jeu> pour que la navigation par ordre alphabétique pointe sur ce jeu pour la lettre définie.

- seul l'attribut name et la balise description sont obligatoires (le jeu apparaîtra dans l'ordre alphabétique sous sa description, tandis que le name définit le nom (sans extension) des fichiers à charger (thème, vidéo, rom, bezel...).

Il est aussi possible de générer une liste basique à partir des roms présentes dans un répertoire en utilisant le programme HyperRom (fourni).

Note : alternativement, les packs de jeux pour Hyperspin se décompressent généralement à la racine du dossier Hyperspin (D:/Hyperspin/) et comprennent l'ensemble des fichiers requis. Si vous ne souhaitez pas tout reconfigurer, il vous faudra ensuite aller dans C:/Hyperspin/Databases, ouvrir le fichier XML du menu adéquat et y copier/coller le fichier XML fourni avec le pack.

Ajout d'un nouveau menu

Les entrées de menu de l'Arcadebox (accessible à partir du menu principal ou Main menu de l'interface) donnent accès à des jeux ou à des médias généralement groupés par système ou par famille. Toutes les entrées d'un menu doivent en principe fonctionner avec le même programme/émulateur.

Par exemple, Arcade Classics contient une liste des meilleurs jeux d'arcade, tandis que Psikyo donne accès aux titres de cet éditeur. Ces menus distincts donnent tous deux accès à des jeux lancés avec l'émulateur MAME, tandis que le menu Films regroupe des fichiers vidéo lisibles avec VLC.

Les entrées d'un menu sont listées dans une base de données au format XML.

Pour qu'un menu apparaisse correctement avec ses entrées dans l'interface, il faut le définir en ajoutant/configurant les fichiers qu'il requiert à la fois pour l'interface utilisateur (le frontend Hyperspin) et pour l'interface de lancement des jeux (RocketLauncher). Ces opérations sont réalisables à travers l'interface des deux logiciels, ou —plus simplement— en copiant/collant les fichiers requis aux bons emplacements. C'est cette méthode qui est présentée. Si vous souhaitez utiliser l'interface d'Hyperspin et RocketLauncher, veuillez vous reporter à la documentation disponible sur Internet.

Ajout d'une entrée pour le sous-menu dans le Menu principal

La première étape est d'ajouter une image d'entrée pour le menu à Hyperspin.Un fichier thème est également nécessaire pour l'affichage de l'entrée du menu lui-même.

F:/Hyperspin/Media/images/Main menu/<nom du menu>.png (image de l'entrée du menu dans le menu principal)

F:/Hyperspin/Media/themes/Main menu/<nom du menu>.zip (fichier thème du menu dans le menu principal)

Ajout des fichiers du sous-menu à l'interface Hyperspin

Créer le dossier D:/Hyperspin/Media/<nom du menu>/

Puis le peupler avec les dossiers et fichiers suivants qui seront utilisés par le sous-menu :

F:/Hyperspin/Media/Images/

F:/Hyperspin/Media/Images/other/

F:/Hyperspin/Media/Images/other/Pointer.png

F:/Hyperspin/Media/Images/Wheel/

F:/Hyperspin/Media/Images/Wheel/*.png (images des entrées des jeux)

F:/Hyperspin/Media/Themes/

F:/Hyperspin/Media/Themes/Default.zip (thème par défaut pour les jeux)

F:/Hyperspin/Media/Themes/*.zip (fichiers thèmes des jeux)

F:/Hyperspin/Media/Video/

F:/Hyperspin/Media/Video/*.mp4 (fichiers vidéo des jeux)

Note : comme indiqué précédemment, pour l'émulateur MAME, les fichiers vidéo des jeux sont à placer dans D:mamesnap

Ajout des fichiers du sous-menu au lanceur RocketLauncher

Pour chaque (sous-)menu, RocketLauncher nécessite l'ajout de paramètres et d'une base de données des jeux

Créer le dossier F:/RocketLauncherRocketLauncherUIDatabases<nom du menu>

Copier/créer le fichier XML de la base de données des jeux (un sous-ensemble de F:/RocketLauncherRocketLauncherUIDatabasesMAMEMAME.xml pour les jeux d'arcade émulés avec MAME)

Copier F:/RocketLauncher/Settings/MAME vers F:/RocketLauncher/Settings/<nom du menu> (paramètres généraux du lanceur)

Fichiers optionnels

Pour chaque sous-menu/jeu, il est possible d'ajouter des médias optionnels dans F:/RocketLauncher/Media/

Ces médias comprennent notamment les écrans de chargement (Fade), manuels (Manuals) ou flyers (Artwork)...

Ajout de la base de données des jeux du sous-menu

Chaque menu possède sa propre base de données (un fichier au format XML) :

F:/Hyperspin/Databases/<nom du menu>/

F:/Hyperspin/Databases/<nom du menu>/<nom du menu>.xml (fichier xml de la base de données des jeux, un sous-ensemble de F:/HyperspinDatabasesMAMEMAME.xml pour les jeux d'arcade émulés avec MAME)

Activation du sous-menu dans le menu principal

Il faut enfin activer le nouveau menu dans la base de données du menu principal (F:/Hyperspin/Databases/Main menu/Main menu.xml) :

<game name="<nom du menu>" enabled="1"/>

Attention : les entrées sont listées dans l'ordre.

Accès distant

Vous pouvez accéder au système de l'Arcadebox ou visualiser l'écran à distance via VNC : utilisez l'adresse IP de l'Arcadebox pour vous connecter. Le mot de passe par défaut est arcadebox.

Pour quitter un jeu, pressez ESC. Pour fermer l'interface, appuyez sur ALT+F4.

Annexe : Configuration des touches par défaut de l'IPAC

INPUT	PRESET CODES
	NORMAL CODES	CODES WITH SHIFT (hold 1 player start)
COIN 1	5
COIN 2	6
START 1	1
START 2	2	ESC
1 RIGHT	R arrow	Tab
1 LEFT	L arrow	Enter
1 UP	U arrow	Key Below ESC (Volume, gamma, etc )
1 DOWN	D arrow	P (pause)
1 SW 1	L-ctrl	5 (Coin A)
1 SW 2	L-alt
1 SW 3	space
1 SW 4	L-shift
1 SW 5	Z
1 SW 6	X
1 SW 7	C
1 SW 8	V
1 A	P
1 B	ENTER
START 1	1
START 2	2	Esc
2 RIGHT	G
2 LEFT	D
2 UP	R
2 DOWN	F
2 SW 1	A
2 SW 2	S
2 SW 3	Q
2 SW 4	W
2 SW 5	I
2 SW 6	K
2 SW 7	J
2 SW 8	L
2 A	TAB
2 B	ESC
THE FOLLOWING CODES FOR THE I-PAC⁴ ONLY
COIN 3	7
COIN 4	8
START 3	3
START 4	4
3 RIGHT	L
3 LEFT	J
3 UP	I
3 DOWN	K
3 SW 1	R-CTRL
3 SW 2	R-SHIFT
3 SW 3	ENTER
3 SW 4	O
3 SW 5
3 SW 6
3 SW 7
3 SW 8
4 RIGHT	U
4 LEFT	V
4 UP	Y
4 DOWN	N
4 SW 1	B
4 SW 2	E
4 SW 3	H
4 SW 4	M
4 SW 5
4 SW 6
4 SW 7
4 SW 8

Ce document a été publié le 2019-07-20 00:00:00. (Dernière mise à jour : 2020-09-02 00:29:00.)