mGalaxy documentation

Ajout/Edition d’une definition d’un système

Vous pourriez vouloir éditer un système, ou encore ajouter un système à la liste des systèmes reconnus pas mGalaxy.
Le plus simple est alors d’en faire la requête sur le forum mais si vous voulez le faire par vous même nous allons voir dans les lignes qui suivent comment procéder.
Ces tutoriels vont concerner la création d’un système mais si le principe est acquis il devrait vous permettre également d’éditer un système en toute connaissance.

Création d’un système #

Choix du nom et de l’illustration de ce système #

Pour commencer par la chose la plus simple, il va nous falloir créer un dossier pour ce système et y déposer l’illustration qui le représentera.

  • Dans le dossier « mGalaxy\Data\Definition\ » créez un dossier et nommer le du nom du système.
    Attention, le nom que vous allez choisir sera ensuite celui utilisé à toutes les étapes de la création!
  • Glissez-y ensuite l’illustration. Ce doit être une illustration au format .png, d’une taille de 200×150 pixels, nommée « icon.png ».

Création d’un système #

La liste des systèmes se trouve dans le fichier « mGalaxy\Data\Definition\Systems.xml »
Ce fichier est à ouvrir avec un éditeur de texte.
Voici comment est défini un système:

<System name="Amstrad CPC" type="Computer">
	<DBID pc="amstradcpc" ss="65" em="Amstrad_CPC" tgdb="Amstrad CPC" gb="11|CPC"/>
</System>

Dans la première ligne, nous allons définir le nom du système (tel que choisi au début) et la catégorie dans laquelle placer ce système. Cette catégorie doit être l’un de ces 3 choix: Arcade/Computer/Console.

La deuxième ligne contient les identifiants de ce système dans plusieurs bases de données en ligne. Les 2 seuls qui nous intéressent sont « ss » (pour ScreenScraper) et « em » (pour EmuMovies) qui sont utilisés lors du rapatriement des media. Les autres peuvent être ignorés.
Pour trouver cette information sur ScreenScraper (en prenant comme exemple l’Atari 2600), chercher dans la liste des systèmes et une fois celui-ci affiché, voici où récupérer son identifiant:

(Cet identifiant n’est pas trouvable sur EmuMovies. Il faudra donc en faire la demande sur notre forum pour que nous puissions vous la donner)
Vous devriez donc avoir, au final, une définition du système comparable à celle ci:

<System name="Atari 2600" type="Console">
	<DBID pc="" ss="26" em="" tgdb="" gb=""/>
</System>

Copier là au même niveau que les autres définitions.

<?xml version="1.0" encoding="utf-8"?>
<Systems>
	<System name="Atari 2600" type="Console">
		<DBID pc="" ss="26" em="" tgdb="" gb=""/>
	</System>
	<System name="Amstrad CPC" type="Computer">
		<DBID pc="amstradcpc" ss="65" em="Amstrad_CPC" tgdb="Amstrad CPC" gb="11|CPC"/>
	</System>
	<System name="Amstrad GX4000" type="Console">
		<DBID pc="amstrad_gx4000" ss="87" em="Amstrad_GX4000" tgdb="Amstrad CPC" gb="11|CPC"/>
	</System>
	<System name="Apple II" type="Computer">
		<DBID pc="apple2" ss="86" em="Apple_II" tgdb="Apple II" gb="12|APL2"/>
	</System>
	<System name="Arcade" type="Arcade">
		<DBID pc="mame" ss="75" em="MAME" tgdb="Arcade" gb="84|ARC"/>
	</System>