> For the complete documentation index, see [llms.txt](https://wiki.retrobat.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.retrobat.org/francais/controleurs/controller-configuration.md).

# Configuration des manettes

RetroBat configure vos manettes en deux étapes :

1. **Dans RetroBat (EmulationStation)** : votre manette est reconnue et ses boutons sont connus. Cette étape n'est faite qu'une fois par modèle de manette.
2. **À chaque lancement de jeu (autoconfiguration)** : RetroBat écrit la configuration de vos manettes dans l'émulateur, pour que vous puissiez jouer sans configurer chaque émulateur.

Pour la plupart des manettes de marque (Xbox, PlayStation, Switch Pro, 8BitDo…), il n'y a rien à faire : les deux étapes sont automatiques.

## Configurer une manette dans RetroBat

Les manettes connues sont configurées automatiquement. Pour configurer une manette non reconnue, ou modifier sa configuration, allez dans **MENU PRINCIPAL > PARAMÈTRES DES MANETTES > CONFIGURER UNE MANETTE**, puis **maintenez un bouton** de la manette à configurer :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FXYsc07V7WLgAd0IAzM2F%2Fimage.png?alt=media&amp;token=38188765-b687-4a2b-8425-7a329b3b8bcc" alt=""><figcaption></figcaption></figure></div>

L'écran de configuration demande chaque entrée l'une après l'autre :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FApkKoYdPAb5V1SkwE8OS%2Fimage.png?alt=media&amp;token=99a090a4-75a2-49bb-9b37-cfe345ea2813" alt=""><figcaption></figcaption></figure></div>

* **Configurez les boutons selon leur position**, pas selon leur inscription : SUD est le bouton du bas, EST celui de droite, etc. (voir le tableau ci-dessous).
* **Passez** une entrée que votre manette n'a pas en **maintenant un bouton** pendant une seconde.
* Entrées obligatoires : **SUD**, **EST**, la **croix directionnelle** (si votre manette en a une) et **RACCOURCI** (HOTKEY). Si votre manette n'a pas de bouton dédié pour RACCOURCI, utilisez **SÉLECTIONNER** (SELECT).
* À la fin, appuyez sur **SUD** pour valider.

| Entrée RetroBat                                                                                                                                                                                                          | Xbox                                                                                                                                                                                                                                | PlayStation                        | Nintendo               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ---------------------- |
| SUD ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fi7zB7JHAFDipdwkYDxEQ%2Fimage.png?alt=media\&token=b2e69851-764d-4720-bfd1-7470500898dd)   | A                                                                                                                                                                                                                                   | ✕ (Croix)                          | B                      |
| EST ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FRY9AH2VXLTechMFYaqTJ%2Fimage.png?alt=media\&token=9df6a4cc-6ae7-4769-a7ca-9eba1aab4547)   | B                                                                                                                                                                                                                                   | ○ (Rond)                           | A                      |
| NORD ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FIsNPjhan0nlNQP9bcObg%2Fimage.png?alt=media\&token=239f32c7-aaf3-46ff-a039-2e2fffefb035)  | Y                                                                                                                                                                                                                                   | △ (Triangle)                       | X                      |
| OUEST ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FeFuEYldeASPfoyrtcsew%2Fimage.png?alt=media\&token=6f90e658-4145-4f31-8e51-b1e4cedbd66f) | X                                                                                                                                                                                                                                   | □ (Carré)                          | Y                      |
| DÉMARRER (START)                                                                                                                                                                                                         | Menu ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FVlPc2q2foqx0PNHYQUh8%2Fimage.png?alt=media\&token=4942c69c-cc71-41eb-8886-5ab890f2a0b2) / Start     | Options                            | +                      |
| SÉLECTIONNER (SELECT)                                                                                                                                                                                                    | Affichage ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FOzRsyJNhavwoZD84sE5Y%2Fimage.png?alt=media\&token=0e42f319-b265-4535-9c01-9a75f4ce2346) / Back | Share / Create                     | −                      |
| PAD DIRECTIONNEL                                                                                                                                                                                                         | Croix                                                                                                                                                                                                                               | Croix                              | Croix                  |
| L1 / R1                                                                                                                                                                                                                  | LB / RB                                                                                                                                                                                                                             | L1 / R1                            | L / R                  |
| L2 / R2                                                                                                                                                                                                                  | LT / RT                                                                                                                                                                                                                             | L2 / R2                            | ZL / ZR                |
| STICK GAUCHE / STICK DROIT                                                                                                                                                                                               | Sticks gauche / droit                                                                                                                                                                                                               | Sticks gauche / droit              | Sticks gauche / droit  |
| CLIC STICK GAUCHE / CLIC STICK DROIT                                                                                                                                                                                     | Clic des sticks (L3 / R3)                                                                                                                                                                                                           | L3 / R3                            | Clic des sticks        |
| RACCOURCI (HOTKEY)                                                                                                                                                                                                       | SELECT (Affichage), ou un bouton dédié                                                                                                                                                                                              | SELECT (Share), ou un bouton dédié | − , ou un bouton dédié |

La configuration est enregistrée pour ce modèle de manette dans `emulationstation\.emulationstation\es_input.cfg`.

### Ordre des joueurs

L'ordre des manettes (joueur 1, joueur 2…) se règle dans **MENU PRINCIPAL > PARAMÈTRES DES MANETTES > ORDRE DES MANETTES**, avec **MANETTE J1**, **MANETTE J2**…

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F4vCpvxnKkMbhKuMpIrqu%2Fimage.png?alt=media&amp;token=4497c9b4-b337-40b9-aa74-41aea8865a98" alt=""><figcaption></figcaption></figure></div>

## Autoconfiguration dans les émulateurs

À chaque lancement de jeu, RetroBat écrit la configuration des manettes branchées dans l'émulateur (RetroArch et la plupart des émulateurs standalone) : boutons, raccourcis, ordre des joueurs.

{% hint style="warning" %}
Tant que l'autoconfiguration est active, la configuration des manettes de l'émulateur est **réécrite à chaque lancement** : un mappage fait à la main dans l'émulateur est perdu au lancement suivant. Pour garder votre propre configuration, désactivez l'autoconfiguration (voir ci-dessous).
{% endhint %}

### Désactiver l'autoconfiguration

L'autoconfiguration peut être désactivée globalement, pour un système ou pour un jeu, avec l'option **AUTOCONFIGURER LES MANETTES** :

* **Globalement** : **MENU PRINCIPAL > PARAMÈTRES DES JEUX > AUTOCONFIGURER LES MANETTES** : **NON**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FMArXdJMsYHWTkVfj8p0W%2Fimage.png?alt=media&amp;token=c30f71b0-0306-4aa2-93ef-f2fac3e46095" alt=""><figcaption></figcaption></figure></div>

* **Pour un système** : ouvrez les [Options d'affichage](https://wiki.retrobat.org/francais/navigation/view-options.md) du système, **CONFIGURATION AVANCÉE DU SYSTÈME > AUTOCONFIGURER LES MANETTES** : **NON**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F7DhLtZ3Qv1Ktp5lkRo4T%2Fimage.png?alt=media&amp;token=d24d3035-265d-4818-b40b-fd3d2f2fd6d1" alt=""><figcaption></figcaption></figure></div>

* **Pour un jeu** : ouvrez les [Options du jeu](https://wiki.retrobat.org/francais/navigation/game-options.md), **CONFIGURATION AVANCÉE DU JEU > AUTOCONFIGURER LES MANETTES** : **NON**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FkXesHoj390lv0j8oEix3%2Fimage.png?alt=media&amp;token=360c9cef-e3ec-427a-acaa-414668bdd9c0" alt=""><figcaption></figcaption></figure></div>

Puis régler l'option **AUTOCONFIGURER LES MANETTES**  sur **NON.**

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FEwd0SI2JVHNnw2Z0pbDY%2Fimage.png?alt=media&amp;token=15484131-0838-4a82-bb72-aad70f0903fd" alt=""><figcaption></figcaption></figure></div>

Configurez ensuite vos manettes **directement dans l'émulateur** :

* les émulateurs standalone peuvent être ouverts depuis le système **RETROBAT** de la Vue Systèmes ;
* dans RetroArch, ouvrez le menu pendant le jeu (**RACCOURCI + SUD** ou **F1**) puis **Commandes**.

{% hint style="warning" %}
**Pistolets** : désactiver **AUTOCONFIGURER LES MANETTES** n'empêche pas RetroBat de configurer les pistolets. Pour garder votre propre configuration des pistolets, réglez aussi **ACTIVER LES PISTOLETS** (configuration avancée > **PISTOLETS**) sur **NON** pour le même système ou jeu.
{% endhint %}

## Adapter les contrôles sans désactiver l'autoconfiguration

RetroBat propose plusieurs façons d'adapter les contrôles tout en gardant l'autoconfiguration :

<table><thead><tr><th width="235.75">Besoin</th><th width="279.25">Solution</th><th>Page</th></tr></thead><tbody><tr><td>Changer un raccourci</td><td>Fichiers de raccourcis <code>kb_hotkeys.yml</code> / <code>controller_hotkeys.yml</code></td><td><a href="https://wiki.retrobat.org/francais/navigation/hotkeys.md">Raccourcis</a></td></tr><tr><td>Jouer aux jeux d'arcade avec un stick arcade</td><td>Option <strong>DISPOSITION DES BOUTONS</strong></td><td><a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/arcade-sticks.md">Sticks Arcade</a></td></tr><tr><td>Choisir une autre disposition de boutons pour une console</td><td>Options de disposition du système (ex. Saturn <strong>BUTTON LAYOUT</strong>)</td><td>Page du système dans <a href="https://wiki.retrobat.org/francais/systemes-and-emulateurs/supported-game-systems.md">Systèmes compatibles</a></td></tr><tr><td>Changer le mappage d'un jeu ou d'un core</td><td>Fichiers de mappage dans <code>user\inputmapping</code></td><td><a href="https://wiki.retrobat.org/francais/controleurs/configuration-des-touches-specifique-par-emulateur.md">Configuration des touches par émulateur</a>, <a href="https://wiki.retrobat.org/francais/systemes-and-emulateurs/arcade-guide.md">Guide Arcade</a></td></tr><tr><td>Utiliser une manette ou un adaptateur N64, Megadrive, Saturn, GameCube</td><td>Contrôleurs spéciaux</td><td><a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/gamepads/controleurs-speciaux.md">Contrôleurs spéciaux</a></td></tr><tr><td>Jouer aux jeux d'ordinateur avec une manette</td><td>PadToKey</td><td><a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/keyboard.md">Clavier</a></td></tr></tbody></table>

### Comment fonctionne un fichier de mappage : deux exemples

#### Flycast (standalone)

Le fichier `flycast_Arcade.yml` contient le mappage de nombreux jeux Naomi, Naomi 2 et Atomiswave. Chaque bloc correspond à un jeu (les jeux d'arcade ont toujours le même nom de rom, le mappage est donc toujours appliqué) :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FoyTSyYbjE2eIwNFwaNEA%2Fimage.png?alt=media&amp;token=69750c3e-8682-4cbe-9752-343cc21b3dcf" alt=""><figcaption></figcaption></figure></div>

Par exemple, `l2: btn_trigger_left` signifie que la gâchette gauche de votre manette est affectée à l'entrée `btn_trigger_left` de Flycast. RetroBat convertit L2 en ce que votre manette utilise réellement (axe ou bouton) :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FHcDU6ahlHCrCAJau3DSR%2Fimage.png?alt=media&amp;token=016c2e55-a74f-4316-aa0e-d6e9119551f0" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FOjPWorpI8D6hD0iwPwmr%2Fimage.png?alt=media&amp;token=f8999fed-a0a0-40fe-b99c-065e6935752c" alt=""><figcaption></figcaption></figure></div>

#### RetroArch (core Flycast)

Le fichier `libretro_flycast_naomi.yml` contient, pour chaque jeu Naomi, le remappage des boutons du RetroPad de RetroArch vers les entrées du core :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FBnm9ZKHMAtW0rCMja7hB%2Fimage.png?alt=media&amp;token=8e8f11d1-c0d3-4d0b-a724-64003c72b526" alt=""><figcaption></figcaption></figure></div>

Par exemple, `btn_b: 4` signifie que le bouton SUD du RetroPad envoie l'entrée n° 4 du core (ici, DRIVE GEAR) :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FsHi4AxKPGimd3NpaFvvD%2Fimage.png?alt=media&amp;token=0e94545f-c351-4be1-8c62-2a77505ab140" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FhIceyLmZVvnXwfXIYQGb%2Fimage.png?alt=media&amp;token=a6e3b932-52b5-4990-ad1b-d62b05f397f2" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Pour RetroArch, ces fichiers ne modifient pas le mappage entre votre manette et le RetroPad : RetroBat crée un **fichier de remap du core** dans `emulators\retroarch\config\remaps\<nom du core>`.
{% endhint %}

## Résoudre un problème de manette

1. **Reconfigurez votre manette** dans **PARAMÈTRES DES MANETTES > CONFIGURER UNE MANETTE**, selon la position des boutons.
2. **Vérifiez l'ordre des joueurs** dans **ORDRE DES MANETTES**.
3. **Vérifiez qu'AUTOCONFIGURER LES MANETTES n'est pas sur NON** (globalement, pour le système ou pour le jeu).
4. Lancez le jeu et ouvrez `emulationstation\emulatorLauncher.log` : il indique les manettes détectées et la configuration écrite.
5. Si le problème persiste, désactivez l'autoconfiguration, configurez la manette directement dans l'émulateur et gardez le fichier de configuration qu'il crée.
6. Contactez l'équipe RetroBat (Discord ou GitHub) avec `es_input.cfg`, `emulatorLauncher.log` et les fichiers de configuration de l'émulateur des étapes 4 et 5.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://wiki.retrobat.org/francais/controleurs/controller-configuration.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
