> 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/premiers-pas/adding-a-game.md).

# Ajouter des jeux

Construire votre ludothèque

L'ajout de jeux est très simple.

{% hint style="warning" %}
RetroBat ne fournit aucun jeu. Vous devez utiliser vos propres sauvegardes de jeux (ROMs).
{% endhint %}

## Ajouter un jeu

Placez vos fichiers de jeux (ROMs) dans le dossier du système correspondant, à l'intérieur du dossier `roms` de RetroBat :

`<dossier RetroBat>\roms\<système>\`

Par exemple, un jeu Super Nintendo se place dans `C:\RetroBat\roms\snes\`.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Fpicysj6dNV1Goc3HD5O5%2Fimage.png?alt=media&amp;token=948f2853-9e92-4d28-9774-8a8d6354af85" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Le nom du dossier doit correspondre exactement au système (par exemple `snes`, et non `Super Nintendo`). Le nom du dossier et les formats de fichiers acceptés pour chaque système sont indiqués dans la section [Systèmes compatibles](https://wiki.retrobat.org/francais/systemes-and-emulateurs/supported-game-systems.md).

Certains systèmes nécessitent aussi des fichiers BIOS pour fonctionner : voir [Ajouter les BIOS](https://wiki.retrobat.org/francais/premiers-pas/ajouter-les-bios.md).

Pour stocker vos jeux ailleurs (autre disque, NAS…), voir [Liens symboliques](https://wiki.retrobat.org/francais/tutoriels/liens-symboliques.md).
{% endhint %}

{% hint style="info" %}
**Jeux multi-disques :** créez un fichier texte `.m3u` qui liste les disques, un par ligne (par exemple `Jeu (Disc 1).chd`). RetroBat masque automatiquement les disques listés dans un fichier `.m3u`, `.cue` ou `.gdi` : une seule entrée apparaît dans la liste des jeux.
{% endhint %}

{% hint style="info" %}
**Jeux compressés :**

* Pour les systèmes sur CD et DVD, le format **.chd** est conseillé : le jeu est compressé et lu directement par la plupart des émulateurs.
* Les fichiers **.zip / .7z** sont lus directement par la plupart des cores RetroArch. Avec certains émulateurs autonomes (Dolphin, PCSX2, DuckStation, PPSSPP…), RetroBat monte ou décompresse l'archive avant chaque lancement, ce qui ralentit le chargement.
* Les réglages de décompression se trouvent dans **MENU PRINCIPAL > PARAMÈTRES DES JEUX**, groupe **COMPRESSION** : **DÉCOMPRESSION** (conserver ou supprimer les fichiers décompressés), **EMPLACEMENT DES FICHIERS DÉCOMPRESSÉS** (par défaut `roms\.uncompressed`) et **NE PAS MONTER DE LECTEUR**.
  {% endhint %}

Les nouveaux jeux sont détectés au prochain démarrage de RetroBat, ou lors de la mise à jour des listes de jeux (**MENU PRINCIPAL** > **PARAMÈTRES DES JEUX** > **METTRE À JOUR LES LISTES DE JEUX**).

Le système apparaît alors dans la **Vue Système**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FRmF7R3p3CmsfHmvY28pf%2Fimage.png?alt=media&amp;token=3390174c-71d3-4bea-8c8c-16171a75e7c6" alt=""><figcaption></figcaption></figure></div>

Appuyez sur ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FROBaPh1Fj8eTIqVWWsjO%2Fimage.png?alt=media\&token=a4ae3ad3-3a80-4c28-8b15-92a1b5a80da7) pour afficher la liste des jeux dans la [Vue Jeux](https://wiki.retrobat.org/francais/navigation/system-view-and-game-view.md#vue-jeux).

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FpL5ZJDvNCP6IwtpcTXzA%2Fimage.png?alt=media&amp;token=e32bdd07-6a76-4d52-98f0-60e8318124e5" alt=""><figcaption></figcaption></figure></div>

## Scraper les informations des jeux

L'étape suivante consiste à scraper les informations des jeux : votre ludothèque sera bien plus agréable avec des images, des vidéos et des descriptions.

Le scrape peut être effectué pour tous les systèmes (global), par système ou par jeu.

### Scrape global

Appuyez sur **START** (**ENTRÉE** au clavier) pour afficher le **MENU PRINCIPAL**, puis sélectionnez **SCRAPEUR**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FSdaqTzUNCz92LxurcMYb%2Fimage.png?alt=media&amp;token=369bfb5d-b196-4e5f-9dd3-846229df8706" alt=""><figcaption></figcaption></figure></div>

Dans l'onglet **SCRAPER**, choisissez la source, les jeux et les systèmes à scraper, puis choisissez **SCRAPER MAINTENANT**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FnIzLt6aMK8Zrv0M29LR8%2Fimage.png?alt=media&amp;token=25400b4a-c48e-40ce-9a42-4732651309a1" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Pour utiliser ScreenScraper, nous recommandons de créer un compte gratuit sur le [site ScreenScraper](https://www.screenscraper.fr/), puis de saisir vos identifiants (utilisateur / mot de passe) dans l'onglet **COMPTES**.

Plus d'informations dans la section [Scrape & Métadonnées](https://wiki.retrobat.org/francais/navigation/scraping-and-metadata.md).
{% endhint %}

Pendant le scrape, le message ci-dessous s'affiche en haut à droite de l'écran.

<div align="left"><figure><img src="https://i.imgur.com/V7ng0Nd.png" alt=""><figcaption><p>Scrape en cours</p></figcaption></figure></div>

Une fois le scrape terminé, mettez à jour les listes de jeux : appuyez sur **START** (**ENTRÉE** au clavier) pour afficher le Menu Principal, choisissez **PARAMÈTRES DES JEUX**…

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FyWNl6MjkVRTu9LYT8ze6%2Fimage.png?alt=media&amp;token=a23eed6c-f91b-4f6e-bff1-17c4604a0a2f" alt=""><figcaption></figcaption></figure></div>

… puis **METTRE À JOUR LES LISTES DE JEUX**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FyNphuTXZS49bwuCw3Jn3%2Fimage.png?alt=media&amp;token=3a96c86e-3d66-4ea2-be47-733c26830ab4" alt=""><figcaption></figcaption></figure></div>

Les informations des jeux sont désormais affichées dans la Vue Jeux.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FFSSsaf7FsS5U2GbDoqJQ%2Fimage.png?alt=media&amp;token=79b81ec1-b057-41bc-a7d4-6adbecfd3300" alt=""><figcaption></figcaption></figure></div>

### Scrape individuel (par jeu)

Pour scraper un seul jeu, sélectionnez-le dans la Vue Jeux et maintenez ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FROBaPh1Fj8eTIqVWWsjO%2Fimage.png?alt=media\&token=a4ae3ad3-3a80-4c28-8b15-92a1b5a80da7) appuyé pour afficher les Options du jeu, puis choisissez **SCRAPER**.

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2Flv9lQ2H1FenNZZVMB0e7%2Fimage.png?alt=media&amp;token=84fe36b1-7beb-4d7e-9d90-23b031b61668" alt=""><figcaption></figcaption></figure></div>

Une liste de jeux pouvant correspondre s'affiche. Sélectionnez le bon jeu et confirmez avec ![](https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FROBaPh1Fj8eTIqVWWsjO%2Fimage.png?alt=media\&token=a4ae3ad3-3a80-4c28-8b15-92a1b5a80da7).

{% hint style="info" %}
Par défaut, la recherche utilise le nom du fichier du jeu. Pour chercher avec un autre nom, utilisez l'option **ÉDITER** en bas de l'écran.
{% endhint %}

<div align="left"><figure><img src="https://466894649-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCgoewyw8Sagl6SNUMrCG%2Fuploads%2FxFhFNUc397IyNqBHcrmC%2Fimage.png?alt=media&amp;token=8e55252e-2dac-4b0d-84e2-9cd2eb6a1396" alt=""><figcaption></figcaption></figure></div>

**Félicitations !** Vous avez ajouté vos premiers jeux à RetroBat. Étape suivante : Démarrer un jeu.


---

# 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/premiers-pas/adding-a-game.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.
