From b4c2877a7bca3f4c57fc1ad664d7d4e369cc5604 Mon Sep 17 00:00:00 2001
From: tiyn <tiyn@mail-mk.eu>
Date: Sun, 6 Aug 2023 04:24:28 +0200
Subject: [PATCH] emulators: added yuzu emulator and links, cleaned up

---
 wiki/games/citra.md     |  2 +-
 wiki/games/dolphin.md   |  9 +++------
 wiki/games/emulators.md |  5 +++--
 wiki/games/yuzu.md      | 44 +++++++++++++++++++++++++++++++++++++++++
 4 files changed, 51 insertions(+), 9 deletions(-)
 create mode 100644 wiki/games/yuzu.md

diff --git a/wiki/games/citra.md b/wiki/games/citra.md
index 0013bd0..d117f03 100644
--- a/wiki/games/citra.md
+++ b/wiki/games/citra.md
@@ -1,6 +1,6 @@
 # Citra
 
-[Citra](https://citra-emu.org/) is a 3DS [emulator](./emulators.md).
+[Citra](https://citra-emu.org/) is a Nintendo 3DS [emulator](./emulators.md).
 
 ## Setup
 
diff --git a/wiki/games/dolphin.md b/wiki/games/dolphin.md
index 59afbd2..75333b9 100644
--- a/wiki/games/dolphin.md
+++ b/wiki/games/dolphin.md
@@ -1,7 +1,6 @@
 # Dolphin
 
-[Dolphin](https://dolphin-emu.org/) is a GameCube and Wii
-[emulator](./emulators.md).
+[Dolphin](https://dolphin-emu.org/) is a Nintendo GameCube and Wii [emulator](./emulators.md).
 
 ## Setup
 
@@ -15,14 +14,12 @@ package is called `org.DolphinEmu.dolphin-emu`.
 The following sections describe specific issues relating to the configuration
 and usage of Dolphin.
 
-### Steam Deck specific settings
+### Steam Deck Specific Settings
 
 The following settings are especially useful when emulating games on the
 [Steam Deck](./steam_deck.md) as pointed out by
 [nchristopher](https://github.com/nchristopher/steamdeck-emulation/blob/main/emulators/dolphin.md).
-But it is a good starting point for other systems aswell.
-It is important to emphasize that the system needs to meet the requirements to
-run Vulkan.
+
 Select the configuration and select the paths tab.
 There the directories for Wii and GameCube [ROMs](./emulators.md) can be added.
 In the audio tab select `Pulse` as your audio backend.
diff --git a/wiki/games/emulators.md b/wiki/games/emulators.md
index db7a0c1..965f5bd 100644
--- a/wiki/games/emulators.md
+++ b/wiki/games/emulators.md
@@ -16,6 +16,7 @@ Emulator games can even be
 
 ## List of Emulator software
 
+- [Citra](/wiki/games/citra.md) is made to emulate Nintendo 3DS games.
+- [Dolphin](/wiki/games/dolphin.md) is made to emulate Nintendo GameCube and Wii games.
 - [PPSSPP](/wiki/games/ppsspp.md) is made to emulate Playstation Portable games.
-- [Dolphin](/wiki/games/dolphin.md) is made to emulate GameCube and Wii games.
-- [Citra](/wiki/games/citra.md) is made to emulate 3DS games.
+- [Yuzu](/wiki/games/yuzu.md) is made to emulate Nintendo Switch games.
diff --git a/wiki/games/yuzu.md b/wiki/games/yuzu.md
new file mode 100644
index 0000000..e8d64f5
--- /dev/null
+++ b/wiki/games/yuzu.md
@@ -0,0 +1,44 @@
+# Yuzu
+
+[Yuzu](https://yuzu-emu.org/) is a Nintendo Switch [emulator](./emulators.md).
+
+## Setup
+
+Citra can be installed on different systems, a list for this can be found on
+the [Yuzu website](https://yuzu-emu.org/downloads/#windows).
+Additionally it can be installed using [Flatpak](../linux/flatpak.md) where the
+package is called `org.yuzu_emu.yuzu`.
+
+After installation keys need to be added.
+A guide on this can be found on the 
+[Yuzu website](https://yuzu-emu.org/help/quickstart/#setting-up-the-decryption-keys-and-firmware).
+
+## Usage
+
+The following sections describe specific issues relating to the configuration
+and usage of Dolphin.
+
+### Start Yuzu Emulated Game in Fullscreen Mode
+
+In different scenarios it can be useful to start directly into a game in fullscreen mode.
+One example would be using the [Steam Deck](/wiki/games/steam_deck.md) to 
+[set up a game in the Steam UI](/wiki/games/steam_deck.md#running-a-game-directly-through-the-interface) 
+so it can be run directly without switching to the desktop mode.
+For this add the `-f` flag for fullscreen mode aswell as the `-g` flag in front of the path to the 
+game that should to be started.
+
+### Steam Deck Specific Settings
+
+The following settings are especially useful when emulating games on the
+[Steam Deck](./steam_deck.md) as pointed out by
+[sofakng](https://www.reddit.com/r/SteamDeck/comments/12ivsky/what_are_the_best_yuzu_settings/).
+
+For a better performance select `Vulkan` under the `Graphics` in `Graphics`.
+If crashes happen switch the option back to `OpenGL`
+Under the `Advanced` tab set the following.
+
+- Enable `Use asynchronous shader building (Hack)`
+- Set `GPU Accuracy` to  `Normal`
+- Enable `Use Fast GPU Time (Hack)`
+
+Under `System` set the memory option to `Extended memory layout (8GB DRAM)`.