If you run games through Yuzu, it’s not unusual to hit a loader error now and then. Yuzu shows these as short codes like XXXX-XXXX, mixing letters and numbers. Each one points to a specific problem, and this guide breaks down what those codes are telling you and how to deal with them.
Tip: If you’re using Windows, click Ctrl + F or Cmd + F on macOS and search for the error code to jump straight to the relevant section.
Common Loader Error Codes and Their Meanings
| Error Codes | What They Mean |
|---|---|
| 0008-0000 | Success |
| 0008-0001 | ErrorAlreadyLoadedThis is an internal error and should be reported to the devs immediately. |
| 0008-0002 | ErrorNotImplemented |
| 0008-0003 | ErrorNotInitialized |
| 0008-0003 | ErrorNotInitialized |
| 0008-0004 | ErrorBadNPDMHeader |
| 0008-0005 | ErrorBadACIDHeader |
| 0008-0006 | ErrorBadACIHeader |
| 0008-0007 | ErrorBadFileAccessControl |
| 0008-0008 | ErrorBadFileAccessHeader |
| 0008-0009 | ErrorBadPFSHeader |
| 0008-000A | ErrorIncorrectPFSFileSize |
| 0008-000B | ErrorMissingHeaderKeyTo read any encrypted file, you need the NCA header key. This should go in your prod.keys under header_key |
| 0008-000C | ErrorIncorrectHeaderKey |
| 0008-000D | ErrorNCA2The NCA you are attempting to load is using an older format that is not currently supported. If you would like support to be added, consider filing an issue. |
| 0008-000E | ErrorNCA0The NCA you are attempting to load is using an older format that is not currently supported. If you would like support to be added, consider filing an issue. |
| 0008-000F | ErrorMissingTitlekey |
| 0008-0010 | ErrorMissingTitlekek |
| 0008-0001 | ErrorInvalidRightsID |
| 0008-0000 | ErrorMissingKeyAreaKey |
| 0008-0000 | ErrorIncorrectTitlekeyOrTitlekek |
| 0008-0000 | ErrorXCIMissingProgramNCA |
| 0008-0000 | ErrorNCANotProgram |
| 0008-0000 | ErrorNoExeFS |
| 0008-0000 | ErrorBadXCIHeader |
| 0008-0000 | ErrorXCIMissingPartition |
| 0008-0000 | ErrorNullFile |
| 0008-0000 | ErrorMissingNPDM |
| 0008-0000 | Error32BitISAThe game you are trying to run uses the 32-bit ARM architecture, which is not currently supported by yuzu. |
| 0008-0000 | ErrorNoRomFS |
| 0008-0000 | ErrorIncorrectELFFileSize |
| 0008-0000 | ErrorLoadingNRO |
| 0008-0000 | ErrorNoIcon |
| 0008-0000 | ErrorNoControl |
| 0008-0000 | ErrorBadNAXHeader |
| 0008-0000 | ErrorIncorrectNAXFileSize |
| 0008-0000 | ErrorNAXKeyHMACFailed |
| 0008-0000 | ErrorNAXValidationHMACFailed |
| 0008-0000 | ErrorNAXKeyDerivationFailed |
| 0008-0000 | ErrorNAXInconvertibleToNCA |
| 0008-0000 | ErrorBadNAXFilePath |
| 0008-0000 | ErrorMissingSDSeed |
| 0008-0000 | ErrorMissingSDKEKSource |
| 0008-0000 | ErrorMissingAESKEKGenerationSource |
| 0008-0000 | ErrorMissingAESKeyGenerationSource |
| 0008-0000 | ErrorMissingSDSaveKeySource |
| 0008-0000 | ErrorMissingSDNCAKeySource |
| 0008-0000 | ErrorNSPMissingProgramNCA |
| 0008-0000 | ErrorBadBKTRHeader |
| 0008-0000 | ErrorBKTRSubsectionNotAfterRelocation |
| 0008-0000 | ErrorBKTRSubsectionNotAtEnd |
| 0008-0000 | ErrorBadRelocationBlock |
| 0008-0000 | ErrorBadSubsectionBlock |
| 0008-0000 | ErrorBadRelocationBuckets |
| 0008-0000 | ErrorMissingBKTRBaseRomFS |
Final Notes
Yuzu changes fast, and updates often fix problems that used to be common. An error you see today might be gone after upgrading.
Most loader issues come down to bad or outdated keys, or a faulty game dump, so double-check both before digging deeper.
If you still can’t pin it down, open an issue on Yuzu’s GitHub and include the exact error code along with your logs. That gives the developers something concrete to work with.
The primary objective of this guide is not merely to understand mistakes but to assist you in comprehending the actual problem. So that you can resume playing without spending hours on troubleshooting.