Software can be imperfect and Yuzu is not perfect, there are errors you will encounter but they have a fix and you can refer to the tables below to see what they mean. We go from simple to common errors, key errors, less-common errors and internal errors. You can also look at our FAQ and Troubleshooting section for any other Yuzu-related issues you come across.
What is an Error Code?
An error code is either comprised of numeric or alphanumeric numbers. It is like a code/reference that tells the authors/developers of a program what went wrong with the program. This way when users come across such an error code they can report it to the authors and they can know what exactly caused that code to appear.
Contents
Key Error Codes
| Error Codes | What They Mean |
| 0008-000C | This code means that the Production Key File is missing. |
| 0008-000D | This code means that the Header Key is missing. |
| 0008-000E | This code means that a incorrect header key is used. |
| 0008-0011 | This code means that the Title Key is missing. |
| 0008-0012 | This code means that the Title Kek is missing. |
| 0008-0014 | This code means that the KeyAreaKey is missing. |
| 0008-0015 | This code means that an incorrect header key is used. |
| 0008-0016 | This could mean that both the TitleKey or TitleKek are missing. |
| 0008-0018 | This means that the NCA hasn’t been found. |
Common Error Codes
| Error Codes | What They Mean |
| 0008-001C (ErrorNullFile) | This code means that the file you have is either a bad copy, corrupted or empty without any data. |
| 0008-001D (ErrorMissingNPDM) | This code means that the main.npdm file is missing. |
| 0008-001E (Error32BitISA) | This code means that you are trying to run a game with an architecture currently not support by Yuzu. |
| 0008-0029 (ErrorNAXInconvertibleToNCA) | This code means that you are trying to run a game with an architecture currently not supported by Yuzu. |
| 0008-002A (ErrorBadNAXFilePath) | This code means that you are trying to run your save file as a game. |
| 0008-0039 (ErrorMissingBKTRBaseRomFS) | This code means that a game update was run which will not work. To make sure game updates work, please go to File > Install and then select the update from the menu. |
Corruption Error Codes
All of the errors below are related to dump issues. These can be corrupt or bad dumps that you may have. Most of the time a re-dump fixes these issues.
| Error Codes | What They Mean |
| 0008-0004 (ErrorBadNPDMHeader) | This code means that you have a bad NPDM header. |
| 0008-0005 (ErrorBadACIDHeader) | This code means that you have a bad ACID header. |
| 0008-0006 (ErrorBadACIHeader) | This code means that you have a bad ACI header. |
| 0008-0007 (ErrorBadFileAccessControl) | This code means that you have an issue with your file permissions. |
| 0008-0008 (ErrorBadFileAccessHeader) | This code means that you have a bad file access header. |
| 0008-0009 (ErrorBadPFSHeader) | This code means that you have a bad PFS header. |
| 0008-000A (ErrorIncorrectPFSFileSize) | This code means that you have a bad PFS File Size. |
| 0008-0013 (ErrorInvalidRightsID) | This code means that your Rights ID is not correct and needs to be replaced. |
| 0008-0017 (ErrorXCIMissingProgramNCA) | This code means that your keys are missing and can’t be located. Try re-adding your keys. |
| 0008-0019 (ErrorNoExeFS) | This code means that the controller is in trouble. |
| 0008-001A (ErrorBadXCIHeader) | This code means that no ROM file system is present. |
| 0008-001B (ErrorXCIMissingPartition) | This code appears when you modify your XCI. |
| 0008-001F (ErrorNoRomFS) | This code means that no .exe is present in the file system. |
| 0008-0020 (ErrorIncorrectELFFileSize) | This code means that the ELF File Size is incorrect. |
| 0008-0021 (ErrorLoadingNRO) | This code means that the controller is in trouble. |
| 0008-0022 (ErrorNoIcon) | This code means that the game has no icons. |
| 0008-0023 (ErrorNoControl) | This code means that the issues with the controller are present. |
| 0008-024 (ErrorBadNAXHeader) | This code means that there is a bad NAX header that needs to be changed. |
| 0008-0025 (ErrorIncorrectNaxFileSize) | This code means that the NAX file size is not the one expected and is incorrect. |
| 0008-0031 (ErrorNSPMissingProgramNCA) | This code means that the NSP is missing the Program NCA. |
| 0008-0032 (ErrorBadBKTRHeader) | This code means that a bad BKTR header is being used and needs to be removed. |
General Error Codes
These error codes are rare to come by, so if you do see one you are modifying the emulator or not just playing games.
| Error Codes | What They Mean |
| 0008-000F (ErrorNCA2) | This code means that the NCA you are trying to load has an invalid format and is not supported. |
| 0008-0010 (ErrorNCA0) | This code also means that the NCA you are trying to load has an invalid format just a different error code but the same meaning. |
More Key Error Codes
These codes are not seen that often and are only shown if you do not use the correct key derivation methods.
| Error Codes | What They Mean |
| 0008-002B (ErrorMissingSDSeed) | This code means that the SDSeed is missing. |
| 0008-002C (ErrorMissingSDKEKSource) | This code means that the SDKEKSource is missing. |
| 0008-002D (ErrorMissingAESKEKGenertionSource) | This code means that the AESKEK Generation Source is missing. |
| 0008-002E (ErrorMissingAESKeyGenerationSource) | This codes means that the AES Key Generation Source is missing and needs to be added correctly. |
| 0008-002F (ErrorMissingSDSaveKeySource) | This code means that the SDSaveKeySource is missing. |
| 0008-0030 (ErrorMissingSDNCAKeySource) | This code means that the SD NCA Key Source is not correct, can’t be located or is missing. |
Internal Error Codes
These error codes are for internal use only and are meant for the development team only (now no longer active).
| Error Codes | What They Mean |
| 0008-0000 (Success) | This code means that whatever sequence you have run is successful. |
| 0008-0001 (ErrorAlreadyLoaded) | This code means that the file you are trying to load is already loaded. |
| 0008-0002 (ErrorNotImplemented) | This code means that the feature you just came by hasn’t been implemented yet fully. |
| 0008-0003 (ErrorNotInitialized) | This code means that your code isn’t initialized. |
| 0008-0026 (ErrorNAXKeyHMACFailed) | This code means that the NAX Key HMAC has failed and needs to be checked. |
| 0008-0027 (ErrorNAXValidationHMACFailed) | This code means that the NAX Validation on the HMAC Failed. |
| 0008-0028 (ErrorNAXKeyDerivationFailed) | This code means that the NAX Key Derivation Failed. |
| 0008-0033 (ErrorBKTRSubsectionNotAfterRelocation) | This code means that the BKTR Subsection relocation is not correct. |
| 0008-0034 (ErrorBKTRSubsectionNotAtEnd) | This code means that the BKTR Subsection is not at the end. |
| 0008-0035 (ErrorBadRelocationBlock) | This code means that the relocation block is corrupted and damaged. |
| 0008-0036 (ErrorBadSubsectionBlock) | This code means that the subsection block is not correct. |
| 0008-0037 (ErrorBadRelocationBuckets) | This code means that the relocation bucket is bad, choose another bucket. |
| 0008-0038 (ErrorBadSubsectionBuckets) | This code means that the subsection of the buckets is bad. Choose another subsection. |
Remember: As Yuzu is no longer developed, these codes may or may not be useful to anyone anymore. These are just here for reference.