Table of Contents

• Can’t open Ryujinx: |E| Application : Unhandled exception caught: System.TypeInitializationException: The type initializer for 'Gtk.Application' threw an exception. ---> System.DllNotFoundException: Gtk: libgtk-3-0.dll, libgtk-3.so.0, libgtk-3.0.dylib, gtk-3.dll

• Can’t open Ryujinx: |E| Application : Unhandled exception caught: GLib.GException: Unrecognized image file format at Gdk.PixbufLoader.Write(Byte[] buf, UInt64 count)

• Can’t open Ryujinx, console closes without any errors and without opening the main window:

• Crashing after selecting Vulkan, trying to open settings or booting a game using Vulkan with |E| GUI.RenderLoop Application : Unhandled exception caught: Ryujinx.Graphics.Vulkan.VulkanException: Initialization failed, none of the available GPUs meets the minimum requirements. at Ryujinx.Graphics.Vulkan.VulkanInitialization.FindSuitablePhysicalDevice(Vk api, Instance instance, SurfaceKHR surface, String preferredGpuId) in D:\a\Ryujinx\Ryujinx\Ryujinx.Graphics.Vulkan\VulkanInitialization.cs:line 217

• Crashing after selecting Vulkan, trying to open settings or booting a game using Vulkan with |E| GUI.RenderLoop Application : Unhandled exception caught: System.NullReferenceException: Object reference not set to an instance of an object. at Ryujinx.Graphics.Vulkan.CommandBufferPool.AddWaitable(Int32 cbIndex, MultiFenceHolder waitable) in D:\a\Ryujinx\Ryujinx\src\Ryujinx.Graphics.Vulkan\CommandBufferPool.cs:line 147

• |E| GUI.RenderThread Application : Unhandled exception caught: Ryujinx.Graphics.Vulkan.VulkanException: Unexpected API error "ErrorFeatureNotPresent".

• |E| GUI.RenderLoop Application : Unhandled exception caught: System.IO.FileNotFoundException: Could not find or load the native library: vulkan-1.dll Attempted: "vulkan-1.dll", "C:\Users\pc\Desktop\publish\vulkan-1.dll" at Silk.NET.Core.Loader.LibraryLoader.ThrowLibNotFound(String name, PathResolver resolver)

• |E| GUI.RenderLoop Application : Unhandled exception caught: System.NotSupportedException: No supported Vulkan surface found! at SPB.Graphics.Vulkan.VulkanHelper.EnsureInit()

• Crashing after double-clicking any game with (Ryujinx:18152): Gtk-CRITICAL **: 00:44:23.202: gtk_list_store_get_value: assertion 'iter_is_valid (iter, list_store)' failed 00:00:00.058 |I| Gpu : Backend Threading (Auto): True Marshaling row-activated signal 00:00:00.265 |E| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.NullReferenceException: Object reference not set to an instance of an object. at Ryujinx.Ui.MainWindow.LoadApplication(String path, Boolean startFullscreen) in D:\a\Ryujinx\Ryujinx\Ryujinx\Ui\MainWindow.cs:line 718

• Crashing after booting a game or crashing after applying an update with |E| HLE.OsThread.8 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> LibHac.Common.HorizonResultException: ResultFsNonRealDataVerificationFailed (2002-4604): Hash error!

• |E| Application : Unhandled exception caught: LibHac.Common.HorizonResultException: ResultFsPartitionSignatureVerificationFailed (2002-4644): Invalid Partition FS type "????" at LibHac.Common.ThrowHelper.ThrowResult(Result result, String message)

• Crashing after booting a game with |E| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> LibHac.Common.HorizonResultException: ResultFsPathNotFound (2002-0001)

• Crashing with |E| HLE.OsThread.8 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.IO.FileNotFoundException: System archive with titleid 0100000000000823 was not found on Storage BuiltInSystem. Found in None.

• “RYU-0003: Firmware parsing error Ryujinx was unable to parse the provided firmware. This is usually caused by outdated keys.”

• Crashing on boot with |E| HLE.OsThread.8 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> LibHac.Common.Keys.MissingKeyException: Missing NCA title key.

• Crashing on boot with |E| HLE.OsThread.8 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> LibHac.Common.Keys.MissingKeyException: Unable to decrypt title key.

|E| HLE.OsThread.8 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.Collections.Generic.KeyNotFoundException: The given key 'None' was not present in the dictionary.

• |N| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> LibHac.Common.Keys.MissingKeyException: Unable to decrypt NCA section.

• Can’t open settings/crashing with |E| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.ArgumentException: An item with the same key has already been added.

• Game hangs on boot, log says |E| Loader LoadNca: No ExeFS found in NCA

• Ryujinx showing a black screen:

• Black screen with sound on Nvidia:

• Ryujinx window is transparent/see-through:

• Emulator window hanging/not responding after exiting a game:

• Game crashes with |E| GUI.RenderThread Application : Unhandled exception caught: Ryujinx.Graphics.Vulkan.VulkanException: Unexpected API error "ErrorOutOfDeviceMemory".

• Game crashes with |E| GUI.RenderLoop Application : Unhandled exception caught: Ryujinx.Graphics.Vulkan.VulkanException: Unexpected API error "ErrorDeviceLost".

• Game crashing with |E| HLE.GuestThread.19 Application : Unhandled exception caught: Ryujinx.HLE.Exceptions.GuestBrokeExecutionException: The guest program broke execution! at Ryujinx.HLE.HOS.Kernel.SupervisorCall.Syscall.Break(UInt64 reason) in D:\a\Ryujinx\Ryujinx\Ryujinx.HLE\HOS\Kernel\SupervisorCall\Syscall.cs:line 1873

• Crashing with Fatal error. System.AccessViolationException: Attempted to read or write protected memory. This is often an indication that other memory is corrupt.

• |E| HLE.GuestThread.20 Cpu InvalidAccessHandler: Invalid memory access at virtual address 0x0000000000000000. |E| HLE.GuestThread.20 Application : Unhandled exception caught: Ryujinx.Memory.InvalidMemoryRegionException: Attempted to access an invalid memory region.

• Inconsistent frame pacing/frame times:

• Fullscreen framerate is not as smooth as on windowed mode/G-Sync not working:

• RTSS/MSI Afterburner won’t hook to Ryujinx:

• Controller buttons exit emulation/joystick moves cursor/mouse moves on its own/controller presses keyboard keys:

• Any kind of issue using DualShock 4, DualShock 5 gamepads:

• Instant communication error trying to play LDN:

• ldn_mitm won't connect/Ryujinx and Switch won’t see each other:

• Game says save file is corrupted:

• |W| HLE.OsThread.10 ServiceNv Wait: GPU processing thread is too slow, waiting on CPU.

• |W| GPU.MainThread Gpu Log: Shader translator: Shader instruction Votevtg is not implemented ///|E| GPU.MainThread Gpu GetInfo: Invalid texture format 0x7FFFF (sRGB: False).

• Crashing with |E| HLE.OsThread.6 Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.ArgumentException: No valid channel configuration found!

• Updated Ryujinx and it didn’t restart when clicking “Yes”:

• Ryujinx executable disappeared/deleted itself after updating:

• Updated Ryujinx and now the executable/all my files are gone/named “.ryuold”:

• Can’t connect to the internet/Error Code: 2306-0520 Unable to connect to the Internet. The DNS settings or proxy server may have been entered incorrectly:

• Experiencing audio delay after playing for over an hour:

• Antivirus flagged Ryujinx as FileRepMalware:

• Games not loading/freezing after loading caches/PPTC:

• Updated Ryujinx and now every game is crashing with |E| Application : Unhandled exception caught: System.Reflection.TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.InvalidOperationException: Could not map view of backing memory. va=0x0000000008000000 size=0x0000000000010000, error code 998)

• |E| HLE.GuestThread.22 Application : Unhandled exception caught: Ryujinx.HLE.Exceptions.UndefinedInstructionException: The instruction at 0x000000000bfaeff0 (opcode 0x00000000) is undefined!

• Low performance on Linux/Steam Deck:

• Any kind of audio issues/softlocking/crashing on macOS:

• Crashing on Mac with |E| HLE.GuestThread.16 Application : Unhandled exception caught: System.Exception: Unhandled exception from guest kernel with ESR 0x82000086 (InstructionAbortLowerEl). at Ryujinx.Cpu.AppleHv.HvExecutionContext.Execute(HvMemoryManager memoryManager, UInt64 address) in /runner/_work/Ryujinx_Eve/Ryujinx_Eve/Ryujinx.Cpu/AppleHv/HvExecutionContext.cs:line 143

• Touch screen not working properly:

• LDN Error Codes

Game-Specific Errors and Troubleshooting

Animal Crossing New Horizons

Astral Chain

Bayonetta 3

Bayonetta Origins: Cereza and the Lost Demon

FIFA 202anything

Fire Emblem Engage

Hyrule Warriors: Age of Calamity

Kirby and the Forgotten Land

Luigi’s Mansion 3

Mario Kart 8 Deluxe

Mario Party Superstars

Mario Strikers: Battle League

Metroid Dread

Metroid Prime Remastered

Monster Hunter Rise

Nintendo Switch Sports

Octopath Traveler II

Pokémon Legends Arceus

Pokémon Let's Go Pikachu/Eevee

Pokémon Scarlet/Pokémon Violet

Pokémon Sword/Pokémon Shield

Sonic Frontiers

Sonic Origins

Splatoon 2

Splatoon 3

Super Mario Bros. Wonder

Super Mario Maker 2

Super Mario Odyssey

Super Smash Bros. Ultimate

Taiko no Tatsujin

The Great Ace Attorney Chronicles

The Legend of Zelda: Breath of the Wild

The Legend of Zelda: Link’s Awakening

The Legend of Zelda: Skyward Sword HD

The Legend of Zelda: Tears of the Kingdom

The World Ends With You -Final Remix-

Xenoblade Chronicles: Definitive Edition

Xenoblade Chronicles 2

Xenoblade Chronicles 3