> 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/supported-controllers/lightguns.md).

# Pistolets

Bang bang

RetroBat détecte les pistolets et les configure automatiquement dans les émulateurs compatibles. Cette page explique comment brancher et régler votre pistolet.

Pour savoir quels systèmes et émulateurs gèrent les pistolets, et comment les boutons sont mappés, voir la page [Contrôle des pistolets](https://wiki.retrobat.org/francais/controleurs/pistolets_controles.md).

## Pistolets pris en charge

<table><thead><tr><th width="215.5">Pistolet</th><th width="139">Détection</th><th width="172.25">Plusieurs joueurs</th><th>Remarques</th></tr></thead><tbody><tr><td><strong>Sinden</strong></td><td>Automatique</td><td>Oui</td><td>Nécessite le logiciel Sinden et une bordure blanche autour de l'écran (les deux sont gérés par RetroBat, voir plus bas).</td></tr><tr><td><strong>Gun4IR</strong></td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>Blamcon</strong></td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>RetroShooter</strong></td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>AimTrak</strong> (Ultimarc)</td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>AE Lightgun</strong></td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>Xgunner</strong></td><td>Automatique</td><td>Oui</td><td></td></tr><tr><td><strong>OpenFIRE</strong> (et OpenFIRE-ESP32)</td><td>Automatique</td><td>Oui, jusqu'à 4</td><td>Donnez à chaque pistolet son propre identifiant USB (PID 1 à 4) dans l'application OpenFIRE : il définit le numéro du joueur. Ne modifiez pas le Vendor ID par défaut.</td></tr><tr><td><strong>Wiimote + DolphinBar</strong> (mode 1 ou 2)</td><td>Automatique</td><td>Oui, une DolphinBar par Wiimote</td><td>Voir <a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/lightguns/wiimotedolphinbar.md">Wiimote et DolphinBar</a>.</td></tr><tr><td><strong>Wiimote + WiimoteGun</strong> (DolphinBar mode 4)</td><td>Quand WiimoteGun est lancé</td><td>Non (1 Wiimote)</td><td>Voir <a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/lightguns/wiimotegun.md">WiimoteGun</a>.</td></tr><tr><td><strong>Wiimote + Wiimote4Guns</strong></td><td>Automatique</td><td>Oui, jusqu'à 4</td><td>Voir plus bas.</td></tr><tr><td><strong>Souris</strong></td><td>Toujours</td><td>–</td><td>Une souris peut servir de pistolet quand aucun pistolet n'est branché.</td></tr></tbody></table>

{% hint style="info" %}
La plupart des pistolets fonctionnent comme une **souris et un clavier**. Si votre pistolet a plusieurs modes, laissez-le en mode souris (voir son logiciel ou sa notice).
{% endhint %}

## Détection des pistolets

Quand un pistolet est branché, EmulationStation affiche une notification et une icône de pistolet ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F5bMn29TxPO5guABwhg4r%2Fimage.png?alt=media\&token=5789332d-3809-49cd-a79c-a3fa1e67fe30) en haut à gauche, à côté des icônes des manettes :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FwY0nVF3mtXe6nb44cUiK%2Fimage.png?alt=media&amp;token=07d133a6-a07c-48e7-8cd2-5c1c9e1e3f9e" alt=""><figcaption></figcaption></figure></div>

Une mire s'affiche aussi à l'écran, ce qui permet de naviguer dans les menus avec le pistolet.

Ces éléments se règlent dans **MENU PRINCIPAL > PARAMÈTRES DES MANETTES** :

* **MONTRER LES NOTIFICATIONS DU PISTOLET** : notifications de branchement et de débranchement.
* **TRACER LA MIRE DU PISTOLET** : mire dans EmulationStation.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FS7FqX9vecBilJVv3GF0K%2Fimage.png?alt=media&amp;token=12ca98f1-4435-42d5-af92-e0292b030bfd" alt=""><figcaption></figcaption></figure></div>

## Jeux au pistolet

RetroBat sait quels jeux se jouent au pistolet :

* Une icône de pistolet s'affiche à côté de leur nom dans la liste des jeux (**MENU PRINCIPAL > PARAMÈTRES D'AFFICHAGE > ICÔNES > AFFICHER L'ICÔNE PISTOLET**).

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FeyHsR19G91mVizm2KrqS%2Fimage.png?alt=media&amp;token=03527517-701e-4a36-b3a5-bb3e31dc7423" alt=""><figcaption></figcaption></figure></div>

* Le filtre **PISTOLET OPTIQUE** n'affiche que ces jeux dans une liste.
* La collection **jeux au pistolet** les regroupe tous. Activez-la dans **MENU PRINCIPAL > PARAMÈTRES DES COLLECTIONS > COLLECTIONS AUTOMATIQUES**.

La liste des jeux au pistolet est le fichier `emulationstation\resources\gamesdb.xml`. Un jeu est reconnu quand son nom de fichier correspond à (ou contient) l'`id` d'un jeu marqué `<gun/>` pour son système.

{% hint style="info" %}
Pour personnaliser la liste, copiez le fichier dans `emulationstation\.emulationstation\resources\gamesdb.xml` et modifiez la copie : elle est lue en priorité et n'est pas écrasée par les mises à jour de RetroBat. Votre copie ne recevra pas les jeux ajoutés par les mises à jour suivantes.
{% endhint %}

{% hint style="info" %}
Certains jeux sont dans la liste alors que le pistolet ne sert que dans certains niveaux ou mini-jeux.
{% endhint %}

## Activer les pistolets

Pour les jeux de la liste, **les pistolets sont activés automatiquement** au lancement du jeu (sauf sur Wii, où les Wiimotes sont utilisées comme de vraies Wiimotes).

Pour les autres jeux, ou pour changer ce comportement, utilisez l'option **ACTIVER LES PISTOLETS** :

* Pour un système : ouvrez les [Options d'affichage](https://wiki.retrobat.org/francais/navigation/view-options.md) du système, choisissez **CONFIGURATION AVANCÉE DU SYSTÈME**, puis **PISTOLETS**.
* Pour un jeu : ouvrez les [Options du jeu](https://wiki.retrobat.org/francais/navigation/game-options.md), choisissez **CONFIGURATION AVANCÉE DU JEU**, puis **PISTOLETS**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2F489d9MjuB9fevfOkT8pL%2Fimage.png?alt=media&amp;token=4f819037-c26e-4c15-9578-51c1c5a0db1c" alt=""><figcaption></figcaption></figure></div>

Réglez **ACTIVER LES PISTOLETS** sur **OFF** pour jouer à un jeu au pistolet avec une manette.

{% hint style="info" %}
Désactiver l'autoconfiguration des manettes ne désactive pas la configuration des pistolets : réglez aussi **ACTIVER LES PISTOLETS** sur **OFF**.
{% endhint %}

Autres options courantes du sous-menu **PISTOLETS** (selon l'émulateur) :

<table><thead><tr><th width="246.5">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>UN SEUL PISTOLET</strong></td><td>Ne configure qu'un seul pistolet quand plusieurs sont branchés.</td></tr><tr><td><strong>BOUTON POUR RECHARGER</strong></td><td>Recharge avec un bouton au lieu de tirer hors de l'écran, pour les pistolets qui ne savent pas tirer hors écran.</td></tr><tr><td><strong>INVERSER GÂCHETTE ET RECHARGE</strong></td><td>Inverse la gâchette et le bouton de recharge (par exemple avec un Wii Zapper).</td></tr></tbody></table>

## Plusieurs pistolets et ordre des joueurs

RetroBat attribue les pistolets aux joueurs dans cet ordre :

1. Les pistolets dédiés, selon leur propre numéro de joueur quand le pistolet en a un (Gun4IR, Blamcon, Sinden, RetroShooter, OpenFIRE...).
2. Les Wiimotes (Wiimote4Guns J1 à J4, puis DolphinBar).
3. Les autres souris. Les pavés tactiles des portables et les récepteurs 8BitDo vus comme une souris passent en dernier, pour ne pas prendre la place d'un pistolet.

Si l'ordre n'est pas le bon, vous pouvez le forcer avec **INDEX SOURIS/GUN JOUEUR 1** à **4** :

* RetroArch : **MENU PRINCIPAL > PARAMÈTRES DES JEUX > OPTIONS RETROARCH > PISTOLETS**.
* Autres émulateurs : configuration avancée du système > **PISTOLETS**, quand l'émulateur le propose.

{% hint style="info" %}
Les pistolets détectés, dans leur ordre, sont listés dans `emulationstation\emulatorLauncher.log` (lignes commençant par `[RawLightGun]`).
{% endhint %}

## Pistolet Sinden

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FbQiNdkp7xqezWrv5u3DT%2Fimage.png?alt=media&amp;token=594ab5e8-4417-479f-a501-63c5346b38bb" alt="" width="188"><figcaption></figcaption></figure></div>

Le pistolet Sinden nécessite le logiciel Sinden (`Lightgun.exe`), disponible sur le [site Sinden](https://sindenlightgun.com/drivers/).

### Premier réglage (hors RetroBat)

Avant d'utiliser les pistolets dans RetroBat, lancez une première fois le logiciel Sinden seul :

1. Configurez et calibrez votre ou vos pistolets dans le logiciel (un onglet par pistolet).
2. Activez **Start automatically**, pour que le pistolet démarre dès que le logiciel est lancé par RetroBat :

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FM6efLFCZ6nlrnUmzlvWo%2Fimage.png?alt=media&amp;token=e4ec8f58-ee60-442c-8189-065d9187edca" alt=""><figcaption></figcaption></figure></div>

3. Fermez le logiciel : vos réglages sont enregistrés dans le fichier `Lightgun.exe.Config`, à côté de `Lightgun.exe`.

### Logiciel Sinden dans RetroBat

RetroBat le lance automatiquement quand un pistolet Sinden est détecté. Au choix :

* placez le logiciel dans le dossier `system\tools\sinden` de RetroBat,

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FvQ0ZWg2OCuOtTmR8Kjzy%2Fimage.png?alt=media&amp;token=d861a5f8-280e-4013-bd45-2968c3a9409b" alt=""><figcaption></figcaption></figure></div>

* ou indiquez son emplacement dans **MENU PRINCIPAL > PARAMÈTRES DES JEUX > PISTOLETS > SINDEN > CHEMIN DU LOGICIEL SINDEN**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fl4CCZTS7P3oYxiJd7qaE%2Fimage.png?alt=media&amp;token=b50a5a1c-154e-4e64-b71e-396e56373c7d" alt=""><figcaption></figcaption></figure></div>

Autres options dans **PARAMÈTRES DES JEUX > PISTOLETS > SINDEN** :

<table><thead><tr><th width="214">Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>CONFIGURATION BOUTONS SINDEN</strong></td><td><strong>STANDARD</strong> (par défaut) : RetroBat règle les boutons du pistolet en boutons de souris et touches, comme l'attendent les émulateurs. <strong>MODE MANETTE</strong> : les boutons sont envoyés comme des boutons de manette. <strong>NE PAS MODIFIER</strong> : RetroBat conserve votre propre configuration Sinden.</td></tr><tr><td><strong>STOPPER LE LOGICIEL SINDEN</strong></td><td>Ferme le logiciel Sinden à la fin du jeu.</td></tr></tbody></table>

**Bordure blanche** : le Sinden a besoin d'une bordure blanche autour du jeu pour repérer l'écran. RetroBat l'ajoute automatiquement (sous forme de bezel) quand les pistolets sont activés.

Pour certains émulateurs standalone, la bordure est dessinée avec ReShade : choisissez le jeu de shaders **sindenborder** si la bordure n'apparaît pas.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fs2hWKOpVpmoXOtY2UcsQ%2Fimage.png?alt=media&amp;token=74e4fb8e-ab58-4eec-95af-51c96a687734" alt=""><figcaption></figcaption></figure></div>

Keisho, Model3-Vulkan, Odin et ArcadeDuck dessinent eux-mêmes la bordure quand un Sinden est détecté. Pour les trois premiers, réglez son épaisseur avec **TAILLE DE LA BORDURE SINDEN** dans les options **PISTOLETS** de l'émulateur.

## WiiMote

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FTLrRhgI1A9u5XT07KCIY%2Fimage.png?alt=media&amp;token=21235e96-907e-45d8-88b1-4a014dc423eb" alt=""><figcaption></figcaption></figure></div>

Une Wiimote peut servir de pistolet de trois façons :

<table><thead><tr><th width="146.5">Méthode</th><th width="183">Mode DolphinBar</th><th width="182.75">Joueurs</th><th>Logiciel</th></tr></thead><tbody><tr><td><strong>DolphinBar seule</strong></td><td>Mode 1 ou mode 2</td><td>Une DolphinBar par Wiimote</td><td>Aucun. Voir <a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/lightguns/wiimotedolphinbar.md">Wiimote et DolphinBar</a>.</td></tr><tr><td><strong>WiimoteGun</strong></td><td>Mode 4</td><td>1</td><td>Fourni avec RetroBat. Voir <a href="https://wiki.retrobat.org/francais/controleurs/supported-controllers/lightguns/wiimotegun.md">WiimoteGun</a>.</td></tr><tr><td><strong>Wiimote4Guns</strong></td><td>Mode 4, ou Bluetooth sans DolphinBar</td><td>Jusqu'à 4</td><td>À installer : <a href="https://github.com/Aynshe/WiimoteGun">Wiimote4Guns (Aynshe)</a>.</td></tr></tbody></table>

Indiquez à RetroBat le mode utilisé dans **MENU PRINCIPAL > PARAMÈTRES DES JEUX > PISTOLETS > WIIMOTE > MODE DE CONNEXION WIIMOTE**. Avec 2 Wiimotes, **WIIMOTE ASSOCIATION ALTERNATIVE** peut corriger une mauvaise association entre les Wiimotes et leur clavier dans certains émulateurs.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FHe2el5n7qvDTUXsd5f3x%2Fimage.png?alt=media&amp;token=7109680f-6074-4005-a34f-e8baa0636bc8" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Pour les jeux Wii dans Dolphin, les Wiimotes sont utilisées comme de **vraies Wiimotes** (DolphinBar en mode 4) : voir la page [Wii](https://wiki.retrobat.org/francais/systemes-and-emulateurs/supported-game-systems/consoles-de-jeu/nintendo-consoles-de-jeu/wii.md).
{% endhint %}

### Wiimote4Guns

Wiimote4Guns est une version de WiimoteGun par Aynshe qui gère **jusqu'à 4 Wiimotes**, avec une barre de capteur classique ou une disposition à 4 LED. Chaque Wiimote est vue par RetroBat comme un pistolet distinct (Wiimote4Guns P1 à P4) et configurée automatiquement pour les jeux multijoueurs.

1. Installez Wiimote4Guns comme indiqué sur la [page du projet](https://github.com/Aynshe/WiimoteGun) (Windows 10 ou 11, runtime .NET 10 x64 ; Wiimote4Guns installe son propre pilote virtuel).
2. Désactivez le WiimoteGun fourni avec RetroBat : dans le fichier `retrobat.ini` à la racine de RetroBat, réglez `WiimoteGun=0` (valeur par défaut).
3. Réglez la DolphinBar en **mode 4**.

{% hint style="info" %}
Pour plus de précision, placez la DolphinBar (ou la barre de capteur) **sous** l'écran, au plus près de l'image, et mettez l'interrupteur à l'arrière de la DolphinBar en position **basse**.
{% endhint %}

{% hint style="warning" %}
WiimoteGun et Wiimote4Guns ne doivent pas tourner en même temps.
{% endhint %}

## Autres pistolets

* [Gun4IR](https://www.gun4ir.com/)
* [RetroShooter](https://retroshooter.com/)
* [Blamcon](https://blamcon.com/)
* [AimTrak (Ultimarc)](https://www.ultimarc.com/)
* [OpenFIRE](https://openfirelightgun.org/) ([firmware](https://github.com/TeamOpenFIRE/OpenFIRE-Firmware))
* [OpenFIRE-ESP32](https://alessandro-satanassi.github.io/OpenFIRE-ESP32/) ([firmware](https://github.com/alessandro-satanassi/OpenFIRE-Firmware-ESP32))

Ces pistolets sont détectés automatiquement grâce à leur identifiant USB. S'ils ont plusieurs modes, réglez-les en mode souris (et clavier) avec leur propre logiciel.


---

# 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/supported-controllers/lightguns.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.
