Ryujinx - Common Errors and Troubleshooting


                      This is a partial archive of the Ryujinx Github Wiki.
                Some solutions have been taken from Discord and implemented here.
                    If you instead need a list of Game-specific Issues, see:
                                 https://pastebin.com/3955YTvc

		#################################################################
		#################################################################
		##                                                             ##
		##                                                             ##
		## Find the error in your Log.txt and compare it to this list. ##
		##  The error is usually printed right before the StackTrace.  ##
		##                                                             ##
		##                                                             ##
		#################################################################
		#################################################################

##################################
###
### ResultErrApplicationAborted (2162-0001)
###
##################################

     Either the game itself crashed (not the emulator,) or Ryujinx doesn't support this game! Try again, good luck.

##################################
###
### System.Collections.Generic.KeyNotFoundException: The given key '0' was not present in the dictionary.
###
### System archive with titleid <id> was not found on Storage BuiltInSystem. Found in None.
###
### Firmware parsing error Ryujinx was unable to parse the provided firmware.
###
### System update title was not found in the firmware package.
###
### The given key 'None' was not present in the dictionary.
###
### Unable to decrypt NCA section.
###
### Unable to decrypt title key.
###
### Missing NCA title key.
###
##################################

     You lack or have outdated keys\firmware.

##################################
###
### ResultFsOutOfRange (2002-3005)
###
### ResultFsNonRealDataVerificationFailed (2002-4604)
###
### ResultFsPartitionSignatureVerificationFailed (2002-4644)
###
##################################

     For (2002-2644), the game you're trying to load may have been renamed as an incorrect file extension.
     Try renaming the extension from .nsp to .xci

     Alternatively, your game file, update file, or both are corrupted. Replace the files from a different source.

##################################
###
### The header key is incorrect or missing and therefore the NCA header content type check has failed.
###
### The file encountered was not of a valid type.
###
### No applications found in selected file.
###
##################################

     Make sure what you're trying to load is actually a game, not an update, patch file, or anything else.

     Otherwise, the game you're trying to load likely has been renamed as an incorrect file extension.
     Rename the extension from .xci to .nsp or otherwise from .nsp to .xci

     Alternatively, your game file, update file, or both are corrupted. Replace the files from a different source.

##################################
###
### Invalid memory access at virtual address 0x0000000000000000
###
##################################

     Usually caused by mod or cheat conflicts.

     Check that any given 2 (or more) mods or cheats you’re using don’t modify the same game files, and remove them if they do.
     Be aware that disabled cheats are still loaded into memory, even if they’re disabled!

     This error can also be caused by poorly-made mods that don’t work on real hardware.

##################################
###
### Attempted to access an invalid memory region.   at Ryujinx.Memory.Tracking.MemoryTracking.VirtualMemoryEvent
###
### System.InvalidOperationException: Out of handles!
###
##################################

      Either caused by mods, cheats, or an issue with the game that cannot be resolved without further emulator updates.

##################################
###
### NPDM file not found, using default values!
###
### ResultFsPathNotFound (2002-0001)
###
### Could not find Main NCA
###
##################################

     You might be running an update file instead of a game file.

     This can also be due to a permission issue caused by being placed in:

     a. The desktop (with OneDrive)
     b. The root of a drive (C:\)
     c. Any kind of protected folder.

     An antivirus not allowing the files to be accessed by the emulator is another cause.

##################################
###
### The paging file is too small for this operation to complete.
###
##################################

     You followed an outdated guide or bad information that told you to limit your pageFile size.

     Set your system pageFile back to System Managed and/or clean up your storage drive's space.

##################################
###
### Insufficient memory to continue the execution of the program.
###
##################################

     You've ran out of available RAM. If you're using mods, try disabling them and see if this helps.

     Alternatively, upgrade your hardware. Ideally you'd not have less than 16GB of RAM.

##################################
###
### Unexpected API error "ErrorOutOfDeviceMemory"
###
##################################

     This means you ran out of GPU VRAM.

     Check that your resolution scaling isn’t too high; 4x is overkill.
     If your resolution is on native, it might not be possible to emulate that particular game with your system.

     For the games below, enable Texture Recompression in Graphics settings.

     1. Astral Chain
     2. Bayonetta 3
     3. Fire Emblem Engage
     4. Metroid Prime Remastered
     5. Super Mario Bros. Wonder
     6. The Legend of Zelda: Tears of the Kingdom

     Enabling Recompression is not guaranteed to fix your problem.

##################################
###
### Unexpected API error "ErrorDeviceLost"
###
##################################

     This is a generic Vulkan crash. Most of the time it’s not something users can fix.
     On Nvidia, try downgrading your driver to below 527.37.
     On AMD or Intel, a bigger amount of games have this issue; your best bet is to try Linux.

##################################
###
### ResultKvdbInvalidKeyValue (2020-0005)
### ResultFsPermissionDenied (2002-6400)
### ResultFsTargetNotFound (2002-1002)
###
##################################

     Try removing the game's Save Data first, then test.

     Usually means Ryujinx has been denied access to the save folder for this game.
     Most of the time it’s solved if you delete the save folder: Right click the game > Open User Save Directory.
     Backup the contents if you care about the save. Go up 2 levels and delete the selected folder. Run the game again.

     If this doesn’t fix it, check that Ryujinx isn’t within a protected folder such as the desktop with OneDrive
     or the root of a drive (C:\), and that a third party antivirus isn’t blocking Ryujinx from using the save folder.
     Else, make a portable install and bring over your caches and saves from the previous installation of Ryujinx

##################################
###
### System.NullReferenceException: Object reference not set to an instance of an object.   at Ryujinx.Ui.MainWindow.LoadApplication
###
##################################

     Click the game in your list once, then press Enter, or use the Avalonia UI instead of GTK.

##################################
###
### System.NullReferenceException: Object reference not set to an instance of an object.
###      at Ryujinx.Graphics.OpenGL.Queries.CounterQueueEvent.TryConsume
###
##################################

     An issue with AMD GPUs using OpenGL. Use Vulkan instead.

##################################
###
### The instruction at 0x000000000bfaeff0 (opcode 0x00000000) is undefined!
###
##################################

     If you have this opcode, right click the game > Cache Management > Open PPTC Directory and delete its contents.
     Otherwise this game is not supported by Ryujinx.

##################################
###
### Ryujinx.Memory.InvalidMemoryRegionException: Not mapped: [...]   at Ryujinx.Cpu.Jit.MemoryManagerHostMapped.AssertMapped
###
##################################

      Rare issue on Smash Bros. Ultimate, maybe others, no known solution.

##################################
###
### An item with the same key has already been added.
###
##################################

     1. Try updating your keys.
     2. Try right-clicking the game -> Cache Management -> Queue PPTC Rebuild
     3. Try going to Portable or %appdata%\Ryujinx -> bis\system\Contents\registered
	    Delete the contents of the registered folder, then reinstall your firmware.

##################################
###
### No valid channel configuration found!
###
##################################

     Change your audio backend to SDL2 or OpenAL. SoundIO can cause this crash in certain situations.

##################################
###
### Unhandled exception from guest kernel with ESR 0x82000086
###
##################################

     Update your macOS version.

##################################
###
### No ExeFS found in NCA
###
##################################

     When dumping your game, enable “Remove console specific data”, “Generate ticket-less dump”
     and “Change NPDM RSA key/sig in Program NCA” in nxdumptool-rewrite.

     https://nightly.link/DarkMatterCore/nxdumptool/workflows/rewrite/rewrite

##################################
###
### GLib.GException: Unrecognized image file format   at Gdk.PixbufLoader.Write(Byte[] buf, UInt64 count)
###
### System.DllNotFoundException: Gtk: libgtk-3-0.dll, libgtk-3.so.0, libgtk-3.0.dylib, gtk-3.dll
###
##################################

     Some emulator files are missing. Redownload Ryujinx, make sure it’s extracted properly and don’t put it
     on the desktop or the root of a drive, as those are protected folders. Third party antivirus software can
     also randomly delete these files, so if you have one, make exceptions for Ryujinx or uninstall the antivirus.

##################################
###
### Initialization failed, none of the available GPUs meets the minimum requirements.
###
### Object reference not set to an instance of an object.   at Ryujinx.Graphics.Vulkan.CommandBufferPool.AddWaitable
###
### Ryujinx.Graphics.Vulkan.VulkanException: Unexpected API error "ErrorFeatureNotPresent"
###
### System.NotSupportedException: No supported Vulkan surface found!
###
### Could not find or load the native library: vulkan-1.dll
###
##################################

     If you have a system consisting of an AMD Ryzen CPU with an AMD Radeon iGPU (4600H, 4800H, 5600H etc) and
     an Nvidia dGPU, you need to update BOTH graphics card drivers from their respective websites. Not just the
     dedicated Nvidia one, and not just from Windows update.

     https://www.amd.com/en/support

     https://www.nvidia.com/download/index.aspx

     If your hardware doesn’t match the above, it’s possible your GPU drivers are simply out of date.
     In the case that they aren’t, your GPU might not meet the minimum requirements to run Ryujinx,
     for example any Intel iGPUs 5th gen or older.

##################################
###
### CLI Window: System.AccessViolationException: Attempted to read or write protected memory.
###
##################################

     This is a generic error. A possible cause is Ryujinx being in a protected folder or blocked by a third party antivirus.

     If you're getting this error on a Rog Ally, go to Add or remove programs on Windows
     Uninstall the "OpenCL, OpenGL, and Vulkan Compatibility Pack".

     If you're getting this error when running a game on Vulkan and the strings mention SDL2,
     you need to uninstall Gshade or stop it from trying to hook onto Ryujinx. Similarly, close Medal.