Tutoriel original : tutor59 du 11/10/2015

Vous voulez installer UltraStar, Stepmania ou tout autre jeu PC sans wheel ?

Vous désirez installer plusieurs jeux PC avec une wheel ?

La configuration n'est pas la même suivant que l'on veuille lancer un ou plusieurs jeux :

Rendez-vous à [Tuto Partie 1] Installer UN SEUL jeu sans RocketLauncher pour lancer un jeu sans RocketLauncher. Ce dernier n'est pas nécessaire puisqu'on peut lancer l'exécutable directement depuis Hyperspin. Cependant, on ne profite pas des atouts offerts par RocketLauncher (Hyperpause, fenêtres de transitions, modules ahk à jour,etc.).

Rendez-vous à [Tuto Partie 2] Installer UN SEUL jeu avec RocketLauncher pour lancer un jeu avec RocketLauncher. Dans ce cas, on profite des fonctionnalités de RocketLauncher précitées.

Pour cette partie, j'ai encore des soucis, j'espère pouvoir la finir bientôt.

Rendez-vous à [Tuto Partie 3] Installer plusieurs jeux avec RocketLauncher afin d'accèder, à partir de la fenêtre principale, à une liste de jeux PC dans une wheel secondaire.

Enfin, Rendez-vous à [Tuto Partie 4] ANNEXES pour les remarques supplémentaires.

Installation du jeu

Le mieux est de l'installer dans le dossier D:\HFSBox\Emulators\.

Pour l'exemple d'UltraStar Deluxe, il est à récupérer ici : http://ultrastardx.sourceforge.net/usdx-downloads/usdx/.

On l'installe donc dans le dossier kivabien, ici : \HFSBox\Emulators\UltraStar Deluxe.

Ensuite on repasse classiquement par HyperHQ qui va rajouter le nouveau système dans la wheel.

Exécuter HyperHQ qui se trouve dans le dossier \HFSBox.

Choisissez l'onglet “Main Menu Wizard” (1) puis cliquez sur “Add New Item to the Main Menu” (2)

Renseignez le champs “Give your menu item a name” en respectant bien la casse, ici, ce sera “UltraStar Deluxe” (1).

Puis cliquez sur “Next” (2) ce qui fait apparaître le menu suivant.

Il faut lancer un programme, donc on clique sur le bouton “Yes” de la question “Is this menu idem an executable program ?” (1).

Puis cliquez sur “Next” (2) ce qui fait passer à l'étape suivante.

Sélectionnez la ligne à côté de laquelle vous voulez que vôtre nouveau système apparaisse (1).

Choisissez la postion souhaitée pour le nouveau système (avant ou après la ligne sélectionnée) (2).

Une fenêtre de confirmation apparaît où il faut répondre “OK”… et on passe à l'écran suivant.

Il est possible de configurer l'exécutable en cliquant sur “Continue with wizard”(1).

Cliquez sur l'icône (1) afin de pouvoir sélectionner l'emplacement de l'exécutable.

Dans le cas présent, double-cliquez sur “ultrastardx.exe” ce qui affichera une nouvelle fenêtre.

Cliquez sur Continue (2) pour passer à l'étape suivante.

Dans le cas présent, il n'y a pas de paramètres à rajouter, on clique donc sur “Continue” (1).

Il suffit de confirmer qu'Hyperlaunch ne doit pas être lancé en cliquant sur “No” (1).

C'est fini pour cette partie…

… et concrètement ???

Concrètement, le fichier \HFSBox\Databases\Main Menu\Main Menu.xml qui définit les systèmes présents dans la wheel a été mis à jour pour intégrer le système “UltraStar Deluxe”.

La position dans le fichier définit la position dans la wheel système.

Ensuite, un fichier “VotreSystem.ini” (ici “UlstraStar Deluxe.ini') a été crée dans le répertoire
\HFSBox\Settings.

Le voici :

ATTENTION, ERREUR SUR L'IMAGE! hyperlaunch=true

On retrouve le résultat des manipulations effectuées précédemment. Si vous ouvrez ce fichier, profitez-en pour passer le statut de “winstate” à “HIDDEN” (1). En effet, HyperLaunch lance une invite de commande assez disgracieuse pour lancer l'exécutable. Le statut HIDDEN permet de la cacher.

Remarque : il est possible de faire cette opération avec hyperHQ. Pour cela, allez dans l'onglet “Wheel Settings”, Sélectionner le système (ici “UlstraStar Deluxe”) dans le menu pop-up du haut, puis, dans “Winstate” en bas à droite, sélectionnez l'état “HIDDEN” dans le pop-up.

Installation du thème pour le menu principal

Il va falloir ajouter le media pour voir votre jeu sur la wheel principale.

Pour l'exemple, on va installer le jeu “UltraStar Deluxe”.

Il faut installer une video. Pour UltraStrar Deluxe, par exemple ici.

Il faut la placer la vidéo dans /HFSBox/Media/Main Menu/Video (Attention à bien respecter la casse).

Ensuite il faut installer un thème, par exemple ici.

Il est à placer, toujours zippé, dans le répertoire /HFSBox/Media/Main Menu/Themes.

La wheel, faite par faeze, est disponible par ici.

Il faut l'installer dans le répertoire /HFSBox/Media/Main Menu/Images/Wheel.

L'avantage de passer par RocketLauncher est de pouvoir accéder à ses contenus comme :

- La fenêtre de chargement ;

- Les transitions ;

- Hyperpause ;

- … (ce que vous voulez).

Dans ce cas, il faut que le nouveau système lance PCLauncher, un module de RocketLauncher qui permet d'exécuter les jeux PC.

Installation de PCLauncher

Première chose à faire pour lancer un programme extérieur sans wheel : il faut installer PCLauncher.

Lancer RocketLauncherUI (qui se trouve dans /HFSBox/RocketLauncher/RocketLauncherUI/).

Sélectionnez “GLOBAL” (1).

Dans la zone “Curent Emulator List For The Selected System” Cliquez sur ”+“ (2), la fenêtre “Add Emulator” apparaît.

Renseignez le nom, “PCLauncher”.

Pour associer un module, cliquez sur la loupe (3).

Recherchez la ligne “PCLauncher” puis double-cliquez, vous êtes alors de retour dans la fenêtre “Add Emulator”.

Activez la case à cocher “Virtual Emulator” (1) et cliquez sur la disquette pour sauvegarder (2).

Ici, on va créer un système “Jeux PC” qui lance une wheel avec 2 jeux (par exemple “UltraStrar Deluxe ” et “Ultra Street fighter IV ”). Ces deux jeux sont des exécutables et nous passons par RocketLaucher pour profiter de ses avantages (décrits au début du Tuto partie 2).

Installation de PCLauncher

Si ce n'est déjà fait, reprendre le tuto correspondant dans la partie 2.

Paramétrage de PCLauncher

Seuls certains système permettent par défaut d'utiliser le module PCLauncher.

Les systèmes de base sont “Arcade PC”, “Doujin Soft”, “Examu eX-BOARD”, “Fan Remakes”, “Games for Windows”, “Konami e-Amusement”, “Konami Bemani”, “Microsoft Windows”, “PCLauncher”, “PC Games”, “Steam”, “Steam Big Picture”, “Taito Type X”, “Taito Type X2”, “Touhou”, “Touhou Project”.

On va rajouter, dans le module “PCLauncher”, le nouveau système “Jeux PC” (on aurait pu aussi utiliser “PC Games” qui existe déjà).

Pour y remédier, ouvrir le fichier “PCLauncher.ahk” qui se trouve dans le répertoire \HFSBox\RocketLauncher\Modules\PCLauncher.

Comme on peut le voir sur la vue ci-dessus, il faut ajoutez “Jeux PC” à la variable “MSystem”.

Fermez le fichier, le système “PC Jeux” peut maintenant appeler le module PCLauncher.

Installation du nouveau système

Il va falloir ajouter votre système à la wheel principale.

Pour l'exemple, on va installer le système “PC Jeux”. Bien qu'il soit possible de faire cette partie via RocketLauncher, je trouve qu'il est plus compréhensible d'installer un système avec HyperHQ.

Exécutez “HyperHQ” qui se trouve dans le dossier \HFSBox.

Choisissez l'onglet “Main Menu Wizard” (1) puis cliquez sur “Add New Item to the Main Menu” (2).

Renseignez la cellule permettant de donner un nom à votre système, ici “PC Jeux” (1).
Cliquez sur “Next” (2).

Cliquez sur le premier “Yes” (1) pour informer que le système aura une wheel.

Sélectionnez la ligne à côté de laquelle vous voulez que vôtre nouveau système apparaisse (1).

Puis Sélectionnez la position souhaitée pour le nouveau système (avant ou après la ligne sélectionnée) (2).

Confirmez l'emplacement en cliquant sur “OK”.

Les fichiers de votre système sont maintenant créés, cliquez sur Next (1).

Cette étape est terminée.

Remarque : il est possible de faire cette opération directement dans RocketLauncher. Voir dans ce cas le tuto delankou910tutos-pour-hyperlaunch-f26/sega-saturn-rocketlauncher-t7952.html ou celui desnuf69tutos-pour-hyperlaunch-f26/iso-psx-dreamcast-pour-hl3-rocketlauncher-t7928.html

La Database

Comme expliqué au début de la partie 3, deux jeux pourront être lancés, à savoir “UltraStrar Deluxe ” et “Ultra Street fighter IV ”.
On va ajouter la base correspondant à ces jeux bien que, habituellement, on utilise plutôt un logiciel comme “Rom2xml” pour faire le boulot.

La base de donnée est dans le fichier xml “Systeme.xml” du dossier \HFSBox\Databases\Systeme.
Dans le cas présent, cela donne le fichier “Jeux PC.xml” présent dans le dossier “\HFSBox\Databases\Jeux PC\.

On voit bien apparaître les deux jeux définis dans les balises “game”.

Rocket launcher

Récapitulons :

- on a défini un nouveau système “PC Jeux” qui apparaît dans la wheel principale ;

- ce système contient deux jeux qui figureront dans une wheel secondaire ;

Maintenant, il faut pouvoir les lancer à l'aide de PCLAuncher, qui est lui-même exécuté par RocketLauncher (Ouf !).

On va donc réaliser la première étape en ouvrant le fichier “Systeme.ini” du dossier \HFSBox\Settings, c'est à dire en l'occurence le fichier “jeux PC.ini” du dossier “\HFSBox\Settings\Jeux PC” (Cette opération peut être menée avec HyperHQ sauf que ce dernier n'est pas capable de mettre des chemins absolus sans la lettre du disque dur ; on fait donc ça à la mano).

ATTENTION, ERREUR SUR L'IMAGE! hyperlaunch=true

Dans le début de fichier, le path doit pointer sur le répertoire où se situe rocketLauncher, ici : path=\HFSBox\RocketLauncher\.
L'exe de RocketLauncher est “RocketLauncher.exe”.

Mettre les paramètres à la bonne valeur :” parameters”=“Jeux PC” -f “\HFSBox\HyperSpin.exe” -p “HyperSpin”.

Vérifier que “pcgame”=“false” (c'est RocketLauncher qui prend le relai).

Assurez vous également qu“hyperlaunch”=“false” (RocketLauncher prend la main), puis sauvegardez.

Maintenant, lorsque l'on clique sur un jeu, Rocket Launcher est lancé avec le paramètres “Jeux PC” qui doit indiquer que l'on lance le module PCLauncher.

Pour ce faire, éditez/créez le fichier “Emulators.ini” du dossier \HFSBox\RocketLauncher\Settings\Systeme\, soit ici le dossier “\HFSBox\RocketLauncher\Settings\Jeux PC\” :

Indiquez PCLauncher comme émulateur par défaut, sauvegarder puis quitter.

PC launcher

Récapitulons à nouveau :

- on a défini un nouveau système “PC Jeux” qui apparaît dans la wheel principale ;

- ce système contient deux jeux qui apparaîtront dans une wheel secondaire ;

- lorsque l'on clique sur un jeu, Rocket Launcher est exécuté et ce dernier lance le module PCLauncher ;

Il ne reste donc plus qu'à configurer PCLauncher.

Ça se passe dans le dossier \HFSBox\RocketLauncher\Modules\PCLauncher. Copiez ou créez le fichier “System.ini”, ici “Jeux PC.ini”
et configurez-le d'une manière similaire à celle-ci :

On retrouve les 2 jeux définis dans la base de données xml qui point vers un executable (dans la cas présent je pointe deux fois sur “ultrastar”, mais il faudrait pointer sur deux jeux différents).

Enfin le test !

Allez, zou ! On lance Hyperspin !

On clique sur “Jeux PC”

On clique sur UltraStar Deluxe, la fenêtre de chargement se lance.

Puis le jeu “UltraStar Deluxe” se lance.

IcônedevotresystèmedansRocketLauncher

Pas nécessaire, mais ça permet de finaliser son projet ;)

Il faut une image au format png de 32×32 pixels.
Pour utrastar Deluxe, récupérer l' icône à placer dans /HFSBox/RocketLauncher/RocketLauncherUI/Media/Icons

Dysfonctionnements

Et c'est là que l'on s'arrache les cheveux, mais vu l'âge de certains et leur densité capillaire, on va éviter ;) .

Deux fichiers de log sont importants :

● Le premier est le fichier de log d'Hyperspin qui se trouve dans le dossier \HFSBox et se nomme log.txt.
Il permet de savoir par exemple si Hyeprspin s'est bien lancé ou encore de voir les commandes qui sont envoyées pour lancer RocketLauncher. Si une erreur apparaît, elle sera a priori listée dans ce fichier de log.

● Le second est le fichier de log de RocketLauncher $, se nomme RocketLauncher.log dans le dossier \HFSBox\RocketLauncher.
Si lorsque vous avez lancé une requête RocketLauncher, ce fichier n'a pas été modifié, c'est que la commande a été mal formulée. Ce fichier permet de voir par exemple les fenêtres de transition ou les exécutables qui ont été lancés.