Skip to content

Yuzu - General Guide (Archive)

Yuzu was a Switch emulator.

Note: Archived Emulator

It was removed as part of the 0.8.0b update.

The last version that shipped with Yuzu was 0.7.6b.

Where to put the games?

Switch games should be put into the retrodeck/roms/switch/ directory.

What file formats are supported?

File Format Description
.xci Nintendo Switch Cartridge Image
.nsp Nintendo Submission Package (Recommended)
.nca Nintendo Content Archive
.nso Nintendo Switch Executable
.nro Nintendo Switch Homebrew

Does Yuzu require BIOS or Firmware?

Yes, prod.keys title.keys and .nca files.

Where to put the firmware files?

Needs the key files prod.keys, title.keys and the firmware files in the following directories:

Keys: ~/retrodeck/bios/switch/keys

Firmware: ~/retrodeck/bios/switch/registered

The directory tree should look like this example:

~/retrodeck/bios/switch
├── keys
│   ├── prod.keys
│   └── title.keys
└── registered
    └── XXX amount of .nca files goes here

How do I install DLC and Updates?

Requirements: Patch or DLC files

NOTE: On the Steam Deck this could be easier to do in Desktop Mode.

  1. Extract any patch or dlc files from compressed .zip or any other format to the true files.
  2. Open Yuzu from inside RetroDECK Configurator by pressing Open Emulator - Yuzu.
  3. Press File - Install Files to NAND
  4. Find a DLC or Patch file from the file browser and press Open
  5. This will install the DLC or Patch file into the games NAND folder inside of Yuzu.
  6. Repeat step 2 to 3 for every file you need to install.
  7. Quit Yuzu
  8. Start RetroDECK and select the game you want to play.

How do I add shader caches?

Requirements: Shader cache files

NOTE: On the Steam Deck this could be easier to do in Desktop Mode.

  1. Extract any shader cache files from compressed .zip or any other format to folders.
  2. Open Yuzu from inside RetroDECK Configurator by pressing Open Emulator - Yuzu.
  3. Right click on the game you want to add mods into.
  4. Click on Open Transferable Pipeline Cache.
  5. Paste the files inside that directory.
  6. Start RetroDECK and select the game.

How do I add mods?

NOTE:

  • TITLEID is different for every game.
  • On the Steam Deck this could be easier to do in Desktop Mode.

There are two ways of adding mods into Yuzu

From Yuzu directly

  1. Extract any mod files from compressed .zip or any other format to folders.
  2. Open up Yuzu inside RetroDECK Configurator by pressing Open Emulator - Yuzu.
  3. Right click on the game you want to add mods into.
  4. Click on Open Mod Data Destination.
  5. Paste the mod folders inside that directory.
  6. Right clicking on the game and selecting Properties.
  7. Enable the mods you want to enable by pressing the checkboxes in the Add-Ons tab and press OK.
  8. Quit Yuzu

From the mods/yuzu folder

  1. Extract any mod files from compressed .zip or any other format into folders.
  2. Go into ~/retrodeck/mods/yuzu/ and file the right folder for the game you want to add mods to. The folders are all named by TITLEID.
  3. Move those folders into ~/retrodeck/mods/yuzu/<TITLEID>
  4. Open up Yuzu inside RetroDECK Configurator by pressing Open Emulator - Yuzu.
  5. Right clicking on the game and selecting Properties.
  6. Enable the mods you want to enable by pressing the checkboxes in the Add-Ons tab and press OK.
  7. Quit Yuzu

How-to: Enable Gyro in Yuzu on the Steam Deck

This is a step-by-step guide on how to get to a working Gyro with Yuzu utilizing the Steam Deck's built in gyro. We are looking into building this feature into RetroDECK in the future.

Prerequisites: RetroDECK Steam Deck Controller Layout

Make you have RetroDECK: Steam Deck Controller Layout installed and enabled.

If you don't have it read up on Step 3 from the getting started guide.

Steam Deck - RetroDECK Installation.

Step 1: Install SteamDeckGyroDSU

SteamDeckGyroDSU

Go to Desktop Mode and open the built in terminal Konsole from the KDE Menu (Start Menu).

Copy the following command into the terminal and hit enter:

bash <(curl -sL https://raw.githubusercontent.com/kmicki/SteamDeckGyroDSU/master/pkg/update.sh)

This will Install SteamDeckGyroDSU and create a new folder under HOME $HOME/sdgyrodsu/ aka home/deck/sdgyrodsu

In that folder you will find two other files that is good to know about:

  • update.sh - For updating SteamDeckGyroDSU

  • uninstall.sh - For uninstalling SteamDeckGyroDSU

Step 2: Set RetroDECK Resolution

Go to back to game mode Game Mode

Go to RetroDECK.

But before you launch RetroDECK click on the ⚙️ icon - Properties - Shortcut - Game Resolution

Set the Resolution from Default to 1920x1080

Also turn on Set resolution for internal and external display (this might be hidden sometimes just go back one menu and go in again to make it show up).

Step 3: Configure the Controls

Open the RetroDECK Configurator and launch Yuzu from: Main Menu - RetroDECK Configurator - Open Emulator - Yuzu

In Yuzu:

Go to: Emulation - Configure - Controls

Press the Input Device dropdown menu select Steam Virtual Gamepad 0.

Make sure that the Motion is checked in the bottom left and click the Configure underneath the Motion checkbox.

Step 4: Test and Configure Motion

Make sure that the localhost IP-adress and port exists on the left side of the menu.

If it does not exist, you will need to manually add it:

  • Server: 127.0.0.1
  • Port: 26760
  • Press Add Server

Press the Test button to make sure you are getting data from SteamDeckGyroDSU.

If all has gone well, you will get a message saying:

Successfully received data from the server.

Step 5: Go back to Controls and press the motion button

Go back to Controls

Now you need to press the Motion button and Shake the Steam Deck to bind the motion.

If all is working correctly the tiny box in the middle of the controller should move with your built-in Gyro.

Step 6: Quit RetroDECK

Press OK - Press the Quit Emulator Hotkey (Select + Start) or go to File - Quit Yuzu

Quit the RetroDECK Configurator and Quit RetorDECK.

Step 7: Revert the Resolution to Default

Revert the changed you made to resolution in Step 2:

Click on the ⚙️ icon - Properties - Shortcut - Game Resolution

Set the Resolution from1920x1080 to Default

Also turn off Set resolution for internal and external display

Step 8: Launch RetroDECK

You can now launch RetroDECK and play Yuzu with gyro.