> 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/navigation/configuration-of-systems-and-games.md).

# Configuration of systems and games

One of the main advantages of RetroBat is that emulators are configured **from the RetroBat menus**, for all games, for a system or for a single game. You do not need to open the emulators to configure them.

{% hint style="danger" %}
Do not change in an emulator a setting that is also available in RetroBat: RetroBat writes its own value in the emulator configuration each time a game is launched, so your change will be overwritten. See How does it work?
{% endhint %}

## The three configuration levels

The settings available in RetroBat are called **features**. They can be defined at three levels:

<table><thead><tr><th width="102">Level</th><th width="395.5">Where</th><th>Applies to</th></tr></thead><tbody><tr><td><strong>Global</strong></td><td><strong>MAIN MENU</strong> > <strong>GAME SETTINGS</strong></td><td>All systems and games</td></tr><tr><td><strong>System</strong></td><td>Game View > <strong>SELECT</strong> (<a href="/navigation/view-options.md">View options</a>) > <strong>ADVANCED SYSTEM OPTIONS</strong></td><td>All games of the system</td></tr><tr><td><strong>Game</strong></td><td>Game View > hold <strong>South</strong> on a game (<a href="/navigation/game-options.md">Game options</a>) > <strong>ADVANCED GAME OPTIONS</strong></td><td>This game only</td></tr></tbody></table>

**The most specific setting always wins:** a game setting overrides the system setting, which overrides the global setting.

{% hint style="info" %}
Only the most common settings (shader, decorations, aspect ratio, integer scaling, controller autoconfiguration…) exist at the global level. Emulator-specific settings are only available at the system and game levels.
{% endhint %}

## Opening the configuration

### For a system

In the Game View of the system, press **SELECT** and choose **ADVANCED SYSTEM OPTIONS**:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F6ALIvYQj1Er6QgXVbwp4%2Fimage.png?alt=media&amp;token=f2177571-cf3b-44fd-9617-1a924329c701" alt=""><figcaption></figcaption></figure></div>

The settings will apply to all games of this system.

### For a game

In the Game View, hold **South** on the game and choose **ADVANCED GAME OPTIONS** (or press **North** in the Game Options menu):

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F0Rb9XXs8q3svrVhrEiY0%2Fimage.png?alt=media&amp;token=74141407-a070-4cc9-afb7-1cc2a4a67f25" alt=""><figcaption></figcaption></figure></div>

The settings will only apply to this game.

## The configuration menu

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FU8o2ty6kHxQhEiXYc6aU%2Fimage.png?alt=media&amp;token=272bdc65-3b6a-42c3-94a6-ebf990b11084" alt=""><figcaption></figcaption></figure></div>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fz3j9FTQuz5Vme5W75hd2%2Fimage.png?alt=media&amp;token=36e267e2-4441-4ceb-91ce-1df271d03300" alt=""><figcaption></figcaption></figure></div>

The menu always starts with the **EMULATOR** line: choose the emulator and core to use. **Change the emulator first**: the menu is reloaded and shows the settings available for the selected emulator. Each emulator has its own settings, so the list changes from one emulator to another.

The settings are then grouped as follows:

<table><thead><tr><th width="250.25">Group</th><th>Content</th></tr></thead><tbody><tr><td><strong>GENERAL SETTINGS</strong></td><td>Settings available for most emulators: shader, decorations (bezels) and tattoo, aspect ratio, video mode, integer scaling, smoothing…</td></tr><tr><td><strong>ADVANCED SETTINGS</strong></td><td>Settings specific to the emulator or core, organized in submenus (see below)</td></tr><tr><td><strong>PORT SETTINGS</strong></td><td>For ports: settings of the selected game</td></tr></tbody></table>

The most common **ADVANCED SETTINGS** submenus are:

<table><thead><tr><th width="222.75">Submenu</th><th>Content</th></tr></thead><tbody><tr><td><strong>EMULATION</strong></td><td>Emulated machine, region, language, BIOS, performance…</td></tr><tr><td><strong>VIDEO</strong></td><td>Fullscreen, monitor index, screen orientation…</td></tr><tr><td><strong>VISUAL RENDERING</strong></td><td>Upscaling, texture filtering, anti-aliasing, screen effects…</td></tr><tr><td><strong>SCREEN SYNC</strong></td><td>V-Sync and other synchronization settings</td></tr><tr><td><strong>AUDIO</strong></td><td>Audio settings (sample rate, filters…)</td></tr><tr><td><strong>LATENCY REDUCTION</strong></td><td>Settings to reduce input lag</td></tr><tr><td><strong>USER INTERFACE</strong></td><td>FPS display, emulator notifications…</td></tr><tr><td><strong>DRIVERS</strong></td><td>Video, audio and controller drivers</td></tr><tr><td><strong>CONTROLS</strong></td><td>Controller type, analog sticks, mappings…</td></tr><tr><td><strong>GUNS</strong> / <strong>WHEELS</strong></td><td>Lightgun and steering wheel settings</td></tr><tr><td><strong>TURBO</strong></td><td>Turbo buttons</td></tr><tr><td><strong>GAME PATCHES</strong> / <strong>GAME FIXES</strong> / <strong>MANUAL HACKS</strong></td><td>Patches and fixes for specific games</td></tr></tbody></table>

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2F9b899l1wDcmKtHuhyHY0%2Fimage.png?alt=media&amp;token=57630a00-c698-40bf-87e0-896a0ac36239" alt=""><figcaption><p>Example of EMULATION features submenu for FCEUMM core</p></figcaption></figure></div>

Some emulators have their own submenus, for example **MANUAL HACKS** and **GAME FIXES** for PCSX2:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fktnx7WsAdGKhEy9ozQQ7%2Fimage.png?alt=media&amp;token=faf317c5-9e95-473e-86d9-faace8e34e1f" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Select a setting to display its description at the bottom of the screen.
{% endhint %}

## What does "AUTO" mean?

<table><thead><tr><th width="164">Level</th><th>AUTO means…</th></tr></thead><tbody><tr><td>Global</td><td>The default value chosen by the RetroBat team, usually the most compatible one</td></tr><tr><td>System</td><td>The global value if there is one, otherwise the RetroBat default value</td></tr><tr><td>Game</td><td>The value set for the system</td></tr></tbody></table>

To cancel a setting, set it back to **AUTO**.

## How does it work?

When you change a setting, RetroBat saves it in the `emulationstation\.emulationstation\es_settings.cfg` file.

When you launch a game, RetroBat:

1. reads the global settings, then the system settings, then the game settings (the most specific one wins);
2. writes the matching values in the emulator configuration files;
3. starts the emulator.

**Example:** use the Vulkan renderer for PlayStation games with DuckStation.

1. In the PlayStation Game View, press **SELECT** > **ADVANCED SYSTEM OPTIONS**.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2Fu7BukZ5ZqtYJGkwnZCfg%2Fimage.png?alt=media&amp;token=15d5d643-d74b-4239-936c-9e3e226478ce" alt=""><figcaption></figcaption></figure></div>

2. Open the **DRIVERS** submenu in the **ADVANCED SETTINGS** group.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FAS2eFyYqWRjU9vek7byd%2Fimage.png?alt=media&amp;token=4d374866-b298-42df-82b9-1ef6ce48fe95" alt=""><figcaption></figcaption></figure></div>

3. Set **VIDEO** to **VULKAN**.

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FKNcmlRZcKmxbcLf3BkRi%2Fimage.png?alt=media&amp;token=67739720-1513-4827-a8b8-b206d18e2f44" alt=""><figcaption></figcaption></figure></div>

When a game is launched, RetroBat writes `Renderer = Vulkan` in the `[GPU]` section of `emulators\duckstation\settings.ini`:

<div align="left"><figure><img src="https://990680527-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FexdzL60ZuqPLldz2AYta%2Fuploads%2FdaWuBfCmR4GWGCh6GI8z%2Fimage.png?alt=media&amp;token=d1223f2d-f5eb-4526-8212-d5f8f3db9ac6" alt=""><figcaption></figcaption></figure></div>

If the setting is left on **AUTO**, RetroBat writes `Renderer = Automatic`: this is why a change made directly in DuckStation would be lost.

{% hint style="warning" %}

* Settings available in RetroBat are written at each launch, with your value or the RetroBat default value: always change them in RetroBat.
* Settings that are not available in RetroBat are usually kept: you can change them in the emulator.
* To configure the controls yourself in an emulator, set **AUTOCONFIGURE CONTROLLERS** to **OFF** for this system or game.
  {% endhint %}

{% hint style="info" %}
Game settings are linked to the **file name** of the game. If you rename the file, its settings are lost. Two files with the same name in the same system share the same settings.
{% endhint %}

## Troubleshooting

* **A setting has no effect:** check that it is not overridden at the game level, and that the right emulator is selected.
* **Check what RetroBat did:** the log files show the values applied at launch:
  * `emulationstation\emulatorLauncher.log` (game launch and emulator configuration)
  * `emulationstation\.emulationstation\es_log.txt` (RetroBat interface)
* **Go back to the default configuration:** set the settings back to **AUTO**.

## I cannot find the setting I need

If an emulator has a setting you would like to change from RetroBat, contact the RetroBat team on [Discord](https://discord.gg/GVcPNxwzuT) or the [forum](https://retrobat.forumgaming.fr/): it can be added in a future version.

In the meantime, you can change it directly in the emulator: settings that are not available in RetroBat are usually not overwritten.


---

# 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/navigation/configuration-of-systems-and-games.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.
