Skip to content

Remaps

A remap changes what the buttons do, or which controller is plugged into a port (a multitap, a light gun...), for one game or for every game of a core.

Which remap a game gets

flowchart LR
    A(("a game<br/>starts")) --> B{"its own remap?<br/>config\remaps\&lt;core&gt;\&lt;ROM name&gt;.rmp"}
    B -- yes --> C["the game remap"]
    B -- no --> D{"a core remap?<br/>config\remaps\&lt;core&gt;\&lt;core&gt;.rmp"}
    D -- yes --> E["the core remap"]
    D -- no --> F["no remap:<br/>the controller as it is"]
Remap File (in config\remaps\<core>\) Used for
Game remap <ROM name>.rmp That game only
Core remap <core>.rmp Every game of the core without its own remap

A game remap replaces the core remap

RetroArch never loads both. A setting wanted in every game, such as the turbo, is in the core remap and in each game remap.

Always save the turbo and the stick

RetroArch keeps the turbo and the Analog to Digital Type of the previous game for the session. So every remap sets them, even when they keep their default value: otherwise a game gets the previous game's (R2 once stopped firing in GoldenEye this way).

The remaps of the collection

Core Core remap Game remaps For
bsnes, Snes9x (Super Nintendo) turbo, stick 21 4 players and more (see Multiplayer)
Genesis Plus GX (Master System, Mega Drive) turbo, stick 11 4 players and more (see Multiplayer)
SameBoy, TGB Dual (Game Boy) turbo -
PrBoom (DOOM) DOOM's controls - see Game notes
FinalBurn Neo (arcade) - 4 Metal Slug 1 to 4 (see Game notes)
Mupen64Plus-Next (Nintendo 64) - 1 GoldenEye with twin sticks (see Game notes)

bsnes (PC) and Snes9x (phone, tablet) hold the same remaps. A core used by several consoles has one folder for all of them: Genesis Plus GX for the Master System and the Mega Drive.

Turbo: R2

How to use it while playing, console by console: see In game. How it is set:

Console (core) Where the turbo comes from
Super Nintendo, Master System, Mega Drive, Game Boy (SameBoy, TGB Dual) The core remap and every game remap: R2
NES (Mesen, Nestopia UE), Game Boy (Gambatte), Game Boy Advance (mGBA) Built into the core (Y and X are turbo B and turbo A): no remap
Arcade None: some games use R2. Metal Slug has its own, in its game remaps (see Game notes)

The turbo settings of a remap, in Quick Menu → Controls → Turbo Fire:

Setting Value
Turbo Mode Classic
Turbo Bind R2

The global turbo stays off (Settings → Input → Turbo Fire → Turbo Bind: None, see Settings): each remap sets its own.

The stick moves like the D-pad

Quick Menu → Controls → Port 1 Controls → Analog to Digital Type: Left Analog, for players 1 to 4 (to 5 on the Super Nintendo, for the multitap). The left stick then moves in the games that only know the D-pad.

Make or change a remap

Step
1 Start the game. For a core remap: a game without its own remap
2 Quick Menu → Controls: the ports (Port 1 Controls...: Device Type, the buttons, Analog to Digital Type) and Turbo Fire
3 Quick Menu → Controls → Manage Remap Files → Save Game Remap File (or Save Core Remap File)
4 Copy the file into the repository's retroarch\remaps\<core>\ (a Super Nintendo remap into both bsnes\ and Snes9x\), then to the other devices

The remap files use RetroArch's button values: input_player1_btn_b = "8" means the bottom button sends A (see Controllers).

Phone and tablet

The remaps are in Android/media/com.retroarch.aarch64/RetroArch/config/remaps/<core>/, on the internal storage (see Install).