Skip to content

Yuzu

Jump to bottom Edit New page
rawdatafeel edited this page Mar 14, 2023 · 127 revisions

Yuzu is a Nintendo Switch emulator.

Website: https://yuzu-emu.org/

Github: https://github.com/yuzu-emu/yuzu-mainline

Github Releases: https://github.com/yuzu-emu/yuzu-mainline/releases

Compatibility List: https://yuzu-emu.org/game/

Quickstart guide: https://yuzu-emu.org/help/quickstart/

Table of Contents

  1. Getting Started with Yuzu

  2. Yuzu Tips and Tricks

Getting Started with Yuzu

Back to the Top

In order to play Nintendo Switch games on Yuzu, you will need a prod.keys file to decrypt your ROMs. The title.keys file is auto-generated. You will need to continue to keep your prod.keys up to date as new Nintendo Switch firmware releases.

If you play a Nintendo Switch game with Miis (for example - Mario Kart 8 Deluxe), you will need firmware files.

Read Yuzu's Quick Start guide to learn how to dump Nintendo Switch keys, firmware, and ROMs: https://yuzu-emu.org/help/quickstart/.

Place your ROMs in Emulation/roms/switch. Read the Configuration section to learn more about Yuzu and its folder locations.

To launch your ROMs in game mode, use Steam ROM Manager and use one of the following parsers to play your Nintendo Switch ROMs:

  • EmulationStation-DE
  • Nintendo Switch - Yuzu
  • Emulators

Configuration:

Back to the Top

  • Type of Emulator: AppImage
  • Executable Location: /home/deck/Applications/yuzu.AppImage
  • Config Location: /home/deck/.config/yuzu/
  • Default storage Location: /home/deck/.share/local/yuzu/
  • Persistent Storage: Emulation/storage/yuzu
    • Contains: dump, load, nand, screenshots, sdmc, and tas
  • ROMs: Emulation/roms/switch/
  • Firmware: Emulation/bios/yuzu/firmware/
  • Keys: Emulation/bios/yuzu/keys/
  • Saves:
    • Symlink: Emulation/saves/yuzu/
    • Target: Emulation/storage/yuzu/nand/user/save/

Note: ~/.local is an invisible folder by default. In Dolphin (file manager), click the hamburger menu in the top right, click "view hidden files" to see these folders.

Works with:

  • Steam ROM Manager
  • EmulationStation-DE

How to Update Yuzu

Back to the Top

How to Update Yuzu

IMPORTANT: Prior to version 0.17.5 of Emudeck, we used the Flatpak version of Yuzu. This was installed from the discover store. We have since moved away from this release for performance reasons, and usability reasons (menus not opening). When updating to Emudeck 0.17.5 or later your data will be migrated from the flatpak location to the appimage location. During this time, your nand (installed data) will also be migrated to the Emulation/storage/yuzu folder.

If you happened to use the Appimage at a prior time, and you have data in its data paths, you will be prompted about which one to keep. The data will be backed up, and your choice will be used.

How to Launch Yuzu in Desktop Mode

Back to the Top

How to Launch Yuzu in Desktop Mode

  • Launch yuzu EmuDeck from the Applications Launcher (Steam Deck icon in the bottom left of the taskbar)
  • Launch the script from Emulation/tools/launchers, yuzu.sh
  • Launch the AppImage in /home/deck/Applications/Yuzu.AppImage
  • Launch the emulator from Steam after adding it via the Emulators parser in Steam ROM Manager

File Formats

Back to the Top

  • .kp
  • .nca
  • .nro
  • .nso
  • .nsp
  • .xci

How to Manage DLC and Updates

Back to the Top

DLC and Updates are installed directly through the Yuzu menu.

Quick Tutorial

  1. In Desktop Mode, open Yuzu
  2. Click File
  3. Click Install Files to NAND..
  4. (Optional) If your DLC or update files are on your SD Card, your path is: /run/media/.... To navigate here, click Computer on the left, open the / folder, open the run folder, then the media folder, and follow the path to the files on your SD Card.
  5. Your DLC or update files are now installed

IMPORTANT: Do not keep your DLC or update files in the Emulation/roms/switch folder. Steam ROM Manager will parse your updates and DLC and create broken shortcuts. After installing your DLC or updates, you can discard them or save them for Ryujinx.

Ryujinx expects your DLC and update files to stay permanently in a folder, either in a folder of your choice, or in Emulation/storage/ryujinx/patchesAndDlc. For further detail, read: https://github.com/dragoonDorise/EmuDeck/wiki/ryujinx#how-to-manage-dlc-and-updates.

Hotkeys

Back to the Top

Combo hotkeys have been mapped for this emulator.

Hotkey Yuzu
Menu Select + R3
Full Screen Select + R3
Docked Mode Start + DPAD Up
GPU Accuracy Start + DPAD Down
Filter Start + DPAD Left
Pause Select + A
Fast Forward Select + R2

Steam Deck Button Layout: https://github.com/dragoonDorise/EmuDeck/wiki/Hotkeys#steam-deck-button-layout

Known Issues

Back to the Top

  • Files with special characters in the name will not launch from shortcuts created by Steam ROM Manager in Steam or EmulationStation-DE. Rename your ROMs if they contain any of the following characters.
    • Known Cases:
      • é in Pokémon
      • ' in Link's Awakening
  • The 3.4.6 SteamOS Stable Update on March 13th updated Mesa to 23.1. Some games may be affected.
    • Known Issues:
      • Super Mario 3D World has flicking textures in snow levels.
    • Recommended Workarounds:
      • Use the Yuzu Flatpak
      • Test older Yuzu versions
    • Date added to this page: March 14th, 2023
  • Yuzu Mainline 1296 merged YFC 1.5. Recent versions of Yuzu may have some stability issues or regressions.
  • Shin Megami Tensei V may have some performance regressions in recent versions of Yuzu.
  • Pokemon Legends Arceus may have some crashes in recent versions of Yuzu.

Yuzu Tips and Tricks

Back to the Top

How to Configure Gyro

Back to the Top

Gyro for Yuzu requires SteamDeckGyroDSU. SteamDeckGyroDSU can be installed via EmuDeck in the Tools & Stuff menu, or it can be installed manually.

Visual Reference:

How to Install SteamDeckGyroDSU: https://github.com/dragoonDorise/EmuDeck/wiki/frequently-asked-questions#how-do-i-install-steamdeckgyrodsu

How to Optimize Performance (Power Tools)

Back to the Top

Prerequisites

Recommended Settings

  • Power Tools: Turn SMT off
    • Open the QAM ("..." button), select the Socket icon, select POWERTOOLS, turn off SMT
      • Visual Reference:
    • (Optional) Use the Persistent toggle to set these settings on a per-game basis
      • Visual Reference:
  • Steam Deck Performance Menu: Set Manual GPU Clock Control to 1200 frequency
    • Open the QAM ("..." button), select the Battery icon, enable Advance View, scroll down, enable Manual GPU Clock Control, and set it to 1200
      • Visual Reference:
    • Toggle per game profiles
      • Visual Reference:
  • IMPORTANT: Some Nintendo Switch games will not perform well regardless and will require the Yuzu team to improve compatibility
    • In some cases, these games may have workarounds through modifying settings or applying patches or mods. Search on Google for your respective game, and see if these workarounds exist
    • Check the Yuzu Compatibility List: https://yuzu-emu.org/game/

How to Configure Multiplayer

Back to the Top

Multiplayer for Yuzu is configured out of the box, no additional configuration is needed.

You may need to set the Controller Order in the Steam QAM (... button).

How to Install Mods

Back to the Top

Mod Resources

This list is not comprehensive

Preface

Read Yuzu's instructions on how to install mods here: https://yuzu-emu.org/help/feature/game-modding/

The folder structure of a mod is important. It should generally look like the following:

mod_directory
  - exefs
  - romfs
  - romfs_ext

Tutorial

  1. In Desktop Mode, open Yuzu
  2. Right click a game you intend on modding
  3. Click Open Mod Data Location
    1. Visual Reference:
  4. Place your mod folder in the opened folder
    1. You may need to extract the mod first
    2. Visual Reference:
  5. In Yuzu, right click the same game, open Properties, click the Add-Ons tab
  6. Check the box to the left of your mod(s)
    1. Visual Reference:
  7. Your mod is now installed

Special Characters

Back to the Top

Files with special characters in the ROM name will not launch from steam. Rename your ROMs and remove the special character.

Known Cases:

  • é in Pokémon
  • ' in The Legend of Zelda: Link's Awakening

If you used Steam ROM Manager previously, re-run Steam ROM Manager after renaming your ROMs.

Special Game Configurations

Back to the Top

Some games will take additional setup, requiring mods or an extensive alteration of settings. The EmuDeck Community Creations page collects these configurations in one centralized location.

You can submit or view special game configurations here: https://github.com/dragoonDorise/EmuDeck/wiki/community-creations#yuzu-nintendo-switch

Current List of Special Game Configurations

  • The Legend of Zelda: Link's Awakening
Add a custom footer
Clone this wiki locally