L'émulation amiga est disponible pour deux machines : Amiga 600 and Amiga 1200. Certains jeux peuvent être exigeants concernant la machine sur laquelle ils fonctionnent, essayez les deux si un jeu ne fonctionne pas.

Les jeux peuvent être utilisés soit en format disquette ADF, soit en format WHDLoad, dans ce deuxième cas à travers un fichier supplémentaire UAE.

Clavier et souris sont plus ou moins obligatoire, car de nombreux jeux amiga ont besoin des touches du clavier pour lancer le jeu.

Commandes spéciales
-----------------
- Afficher le GUI : Start ou F12
- Quitter l'émulateur : Hotkey oruF12 puis Q

Jeux au format ADF
------------------
Copier les dans votre répertoire amiga.
Les jeux sur plusieurs disquettes sont automatiquement chargés jusqu'à quatre disques lorsque les fichiers utilisent des noms standards comme "(Disk 1 of X)".

Jeux au format WHD
------------------------

Les jeux au format WHD sont un peu plus complexes à utiliser mais ce n'est pas trop compliqué.

### Installation :

Dézippez votre jeu WHDLoad, effacez le fichier `.info` au même niveau que le répertoire du jeu et ne copiez que le répertoire sur votre Recalbox dans votre répertoire de roms amiga (vous pouvez utiliser des sous-répertoires comme `/recalbox/share/roms/amiga1200/ShootEmUp)`

### Utilisation :
Vous devez crée un fichier `.uae` au même niveau que le répertoire du jeu avec le même nom que celui-ci, deux solutions :
- Créez un fichier vide
- Utilisez un fichier custom qui vous permettra de paramétrer le configuration de l'émulateur (cf paragraphe suivant)

**Il est recommandé de d'abord essayer un jeu WHDL sur l'amiga1200, si certains d'entre eux sont trop rapides, vous pouvez ensuite les essayer avec l'amiga600**

### Paramétrage des jeux WHDL

#### Paramétrer le fichier .UAE
Dans le fichier uae, vous pouvez définir des blocks `;hardware`, `;controls` et `;graphics` pour replacer la configuration standard de l'émulateur

**Chaque block de configuration custom de votre fichier .uae ne sera utilisé que s'il commence par le bon nom : `;hardware`, `;controls` or `;graphics`**

Vous pouvez ainsi jouer avec deux joysticks par exemple, utiliser une configuration hardware très spécifique pour certains jeux seulement ou définir une résolution custom.

Vous pouvez également tout effacer  dans le fichier uae et la configuration par défaut sera alors utilisée

Exemples de fichiers uae customs pour l'amiga600 and amiga1200 :
[Custom UAEs](http://www100.zippyshare.com/v/1ttgYgks/file.html)

Copier le fichier correspondant au modèle d'amiga que vous voulez utiliser au même niveau que le dossier de votre jeu WHDL and renommez le exactement comme celui-ci (gardez l'extension `.uae`)
exemple: si votre jeu est un répertoire nommé `Rick Dangerous`, votre fichier uae doit être nommé `Rick Dangerous.uae`
et être au même niveau que votre répertoire

#### Customiser le lancement du Startup-sequence (seulement pour les experts)
Le lancement standard des jeux WHDL se fait par la commande `WHDload game.slave Preload` (dans `WHDL/S/Startup-Sequence`)

Mais certains rares jeux WHDL (comme History Line : 1914-1918 ) peuvent avoir besoin de certains paramètres supplémentaires pour se lancer faute de quoi ils crashent au lancement

Vous pouvez ajouter un second fichier (entièrement optionnel) contenant ces paramètres.
Par exemple pour History Line, vous aurez :
- HistoryLine (répertoir du jeu WHDL)
- HistoryLine.uae (qui peut-être vide ou customisé)
- HistoryLine.whdl (optionnel, contenant des paramètres supplémentaires ici juste `CUSTOM1=1`)

Le jeu va alors se lancer.

Voici une petite liste de jeux nécessitant des paramètres supplémentaires :

| Jeu   | Paramètre(s) / Contenu du fichier   |
| ---   | ---   |
| HistoryLine 1914-1918    | `CUSTOM1=1` pour l'intro, `CUSTOM1=2` pour le jeu    |
| The Settlers / Die Siedlers    | `CUSTOM1=1` supprime l'intro    |


BUGS CONNUS
------------
- Pour certains jeux WHDL utilisant plusieurs fichiers slaves, l'intro peut apparaitre après le jeu lui-même
- Pour certains jeux, votre clavier devra être configuré comme US dans `recalbox.conf` pour pouvoir se lancer. Si vous utilisez un clavier azerty, quitter l'émulateur se fera alors avec F12 puis A
- Cette solution utilise l'émulateur amiberry, dont vous pouvez trouver les issues ici : https://github.com/midwan/amiberry/issues