# Raccourcis

Les "hotkeys" sont des raccourcis à la manette ou au clavier, qui sont utilisés pour réaliser certaines actions en jeu, comme par exemple la sauvegarde de progression d'un jeu (savestate), la mise en pause ou bien le rembobinage. L'utilisation la plus fréquente consiste à quitter une partie en cours en appuyant simultanément sur les boutons **HOTKEY** + **START.**

L'équipe RetroBat a défini des hotkeys par défaut à la manette et au clavier pour de nombreux émulateurs, ces hotkeys sont les suivantes : 

{% hint style="info" %}
Pour réaliser une action liée à une hotkey, il est nécessaire de presser la touche d'activation hotkey, puis de presser le second bouton simultanément.
{% endhint %}

<table><thead><tr><th width="234.699951171875">Hotkeys (manette)</th><th>touche clavier</th><th>Action</th></tr></thead><tbody><tr><td>Hotkey + <img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FDEK8lUfEAQiNkBmOouD7%2Fimage.png?alt=media&#x26;token=e1940a32-2494-4e92-a8b1-df9a722ed4f8" alt=""></td><td>CTRL+F12</td><td><a href="game-control-center">Game control center</a></td></tr><tr><td>Hotkey + <img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FROBaPh1Fj8eTIqVWWsjO%2Fimage.png?alt=media&#x26;token=a4ae3ad3-3a80-4c28-8b15-92a1b5a80da7" alt=""></td><td>F1</td><td>Menu de l'émulateur (ou Pause si l'émulateur n'a pas de menu)</td></tr><tr><td>Hotkey + <img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fxn5pRSiYlrSDYXkbkHwg%2Fimage.png?alt=media&#x26;token=d6027ace-7176-4b82-b702-e3b2b65d7cd4" alt=""></td><td>F4</td><td>Charger Save State</td></tr><tr><td>Hotkey + <img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F6PNG0f54lriaOQpqkTAK%2Fimage.png?alt=media&#x26;token=e43f5c0f-2c53-49cc-9271-2385216d89df" alt=""></td><td>F2</td><td>Enregistrer Save State</td></tr><tr><td>Hotkey + START</td><td>ECHAP</td><td>Quitter l'émulateur / le jeu</td></tr><tr><td>Hotkey + L1</td><td>F11</td><td>Éjecter Disque</td></tr><tr><td>Hotkey + R1</td><td></td><td>Service de traduction IA</td></tr><tr><td>Hotkey + L2</td><td>F9</td><td>Disque Index -</td></tr><tr><td>Hotkey + R2</td><td>F10</td><td>Disque Index +</td></tr><tr><td>Hotkey + D-PAD HAUT</td><td>F7</td><td>Choisir Slot de sauvegarde Index +</td></tr><tr><td>Hotkey + D-PAD BAS</td><td>F6</td><td>Choisir Slot de sauvegarde Index -</td></tr><tr><td>Hotkey + D-PAD GAUCHE</td><td>Retour arrière</td><td>Rembobiner</td></tr><tr><td>Hotkey + D-PAD DROITE</td><td>Constant : F<br>Bref : Espace</td><td>Avance rapide (Choix possible entre maintenir et basculer)</td></tr><tr><td>Hotkey + R3 (stick droit)</td><td>F8</td><td>Capture d'écran</td></tr><tr><td></td><td>F</td><td>Basculer plein écran</td></tr><tr><td></td><td>K</td><td>Avance de frame</td></tr><tr><td>Hotkey + L3</td><td>P</td><td>Pause (si un émulateur à un menu et que la Hotkey + <img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FkKJTVx2w2TdZXtmwsDLY%2Fimage.png?alt=media&#x26;token=77fe1496-10c1-4e9a-b127-98e1eba2b8e8" alt=""> est utilisée)</td></tr></tbody></table>

Pour la liste des émulateurs ci-dessous, les hotkeys ont été alignés, avec quelques variations liés aux possibilités des émulateurs :

<details>

<summary>Émulateurs avec des hotkeys alignés</summary>

* RetroArch
* Ares (utilise PadToKey)
* BigPEmu
* Bizhawk (utilise PadToKey)
* Cgenius (Seulement sauvegarde / chargement savestate) (utilise PadToKey)
* Citron
* Demul
* DesMume (utilise PadToKey)
* Dhewm3
* Dolphin
* Duckstation
* Eden
* Flycast
* Hatari
* Jgenesis (utilise PadToKey)
* MAME
* Mednafen
* MelonDS (utilise PadToKey)
* Mesen
* Mupen64(RMG)
* OpenMSX
* PCSX2
* PPSSPP
* Project64 (utilise PadToKey)
* Raine (utilise PadToKey)
* Snes9X (utilise PadToKey)
* Sudachi
* Suyu
* Yuzu

</details>

## Personnalisation des hotkeys

RetroBat permet de modifier l'assignation des hotkeys par défaut pour de nombreux émulateurs, aussi bien pour le clavier que pour la manette.

Les modifications doivent être faites dans un fichier situé dans le dossier `\system\resources\inputmapping` de votre installation RetroBat :

* **kb\_hotkeys.yml** : permet de modifier l'assignation standard pour clavier
* **controller\_hotkeys.yml** : permet de modifier l'assignation standard pour manette

{% hint style="info" %}
Il est également possible de modifier les hotkeys seulement pour un seul émulateur. Pour cela, il faudra ajouter, au début du nom du fichier, le nom de l'émulateur, par exemple "`pcsx2_controller_hotkeys.yml`".
{% endhint %}

Ci-après la liste des émulateurs permettant la modification des hotkeys :

<details>

<summary>Émulateurs avec hotkeys personnalisables :</summary>

* RetroArch
* Ares
* BigPEmu
* Bizhawk
* DesMUME
* Dolphin
* Duckstation
* Flycast
* JGenesis
* Mednafen
* MelonDS
* Mesen
* PCSX2
* PPSSPP
* Project64
* Raine
* Snes9X

</details>

{% hint style="warning" %}
Les fichiers utilisent le nommage RetroArch pour les hotkeys, même pour les autres émulateurs.
{% endhint %}

### Remappage des hotkeys pour manette <a href="#remap-controller-hotkeys" id="remap-controller-hotkeys"></a>

Copier le fichier **controller\_hotkeys.yml** dans le dossier `\user\inputmapping\` de votre installation RetroBat.

Ouvrir le fichier avec votre éditeur de texte préféré :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FWEiy4s5Ggoa4jVpdORs9%2Fimage.png?alt=media&#x26;token=0462d603-6f97-45e0-8280-32c3748aec4f" alt=""><figcaption></figcaption></figure></div>

Le fichier est formaté en yml, **par défaut toutes les valeurs sont commentées**.

La première chose à faire est de dé-commenter la section actuelle ou les boutons sont définis, ainsi que la section container. Pour cela, il faut supprimer le caractère # de toutes les lignes situées a partir de la ligne `#default:` incluant cette dernière :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FTD7RwktkrZHQQbPuOSyQ%2Fimage.png?alt=media&#x26;token=eb1f6492-1533-464c-a874-d52734c5fc54" alt=""><figcaption></figcaption></figure></div>

Dans cet exemple, nous allons replacer les hotkeys d'**avance rapide** et de **rembobinage** sur les boutons R1 et L1, et déplacer les actions d'**éjection de disque** et de **service AI** vers le d-pad :

Pour cela, il faut assigner la fonction de **rembobinage** sur pageup (L1) et la fonction d'**avance rapide maintenu** sur pagedown (R1), puis assigner la fonction d’**éjection de disque** et de **service AI** sur les boutons d-pad correspondant (gauche et droite) :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FTi5FGBddWDIuar6zESmv%2Fimage.png?alt=media&#x26;token=df9ebda7-ae39-4f9c-a1dc-7ad92c91bf6d" alt=""><figcaption></figcaption></figure></div>

Puis, sauvegarder le fichier dans le dossier `\user\inputmapping` de votre installation RetroBat :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FQUFUjmaUB6t2MYfu0kMN%2Fimage.png?alt=media&#x26;token=0310b9aa-b481-417d-a229-e5caa0afac6b" alt=""><figcaption></figcaption></figure></div>

Vous pouvez également spécifier des mappages spécifiques pour un cœur en particulier (dans le cas ou l’émulateur utilise des cœurs différents : Ares, Bizhawk, RetroArch...). Dans l'exemple ci-dessous, le mappage est différent avec le cœur flycast, pour lequel l'avance rapide s'active par pression unique du bouton, au lieu d'une activation en restant appuyé sur le bouton par défaut :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FREvAx7uYvxnea3grILhX%2Fimage.png?alt=media&#x26;token=b5a4930f-f0a3-4758-b443-4970770e6ebc" alt=""><figcaption></figcaption></figure></div>

### Remappage des hotkeys pour clavier <a href="#remap-controller-hotkeys" id="remap-controller-hotkeys"></a>

Copier le fichier **kb\_hotkeys.yml** dans le dossier `\user\inputmapping\` de votre installation RetroBat.

Ouvrir le fichier avec votre éditeur de texte préféré :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FR1wRWwfFKHeAcbUjz6k3%2Fimage.png?alt=media&#x26;token=f82b95e5-979b-400a-a626-3a1911afca93" alt=""><figcaption></figcaption></figure></div>

Le fichier est formaté en yml, **par défaut toutes les valeurs sont commentées**.

La première chose à faire est de dé-commenter la section actuelle ou les boutons sont définis, ainsi que la section container. Pour cela, il faut supprimer le caractère # de toutes les lignes situées a partir de la ligne `#default:` incluant celle-ci :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FRIvtl6tiKrWCqVZRQDsv%2Fimage.png?alt=media&#x26;token=60242cf2-e604-4a3b-b852-60570ff5cd61" alt=""><figcaption></figcaption></figure></div>

Puis sauvegarder le fichier :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FBqSdEsnQQEyKTVUCkRj3%2Fimage.png?alt=media&#x26;token=ce2a8643-f493-4153-b0ae-dcbc7c4f26d6" alt=""><figcaption></figcaption></figure></div>

Vous pouvez également spécifier des mappages spécifiques pour un cœur en particulier (dans le cas ou l’émulateur utilise des cœurs différents : Ares, Bizhawk, RetroArch...). Dans l'exemple ci-dessous, le mappage est différent avec le cœur flycast, pour lequel l'avance rapide s'active par pression unique du bouton, au lieu d'une activation en restant appuyé sur le bouton par défaut :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F8LZTFl2kbCwzDvRDcBcV%2Fimage.png?alt=media&#x26;token=58ca9fc5-7213-4ded-bf7a-de9fc29ca0d5" alt=""><figcaption></figcaption></figure></div>