Error Codes


Translated JSON files for known error codes used by the Wii U and 3DS

Formatting

We have a script called format-translation-files.mjs which will:

- Ensure all translation strings end with a period
- If only one of "long_x" or "short_x" is present, the other will be set to the same value so they're equal at least (ideally, long_x should be a more detailed version of short_x)

You can run it on the directory containing the translation files you want to format. Example usage:

``sh
$ node format-translation-files.mjs .\data\022
`

Path Structure

There are paths: modules and codes. The data folder contains the error code data. The root of the data folder contains the modules. Inside each module folder are the translation files for the module and folders for each of the module's error codes. Inside each module error code folder are the translation files for the error. Example path structure:

`
data
├── 102
│ ├── en_US.json
│ ├── 2482
│ │ └── en_US.json
│ ├── 2483
│ │ └── en_US.json
│ └── etc
└── 103
├── en_US.json
├── 0504
│ └── en_US.json
├── 1101
│ └── en_US.json
└── etc
`

Translation Files

Each translation file is a JSON object named using standard locale names. The contents of each file contains strings intended for both use in our Discord bot Bandwidth and our websites support pages. Due to this each file may have many strings, some of which may seem redundant.

Each file starts with 1 or 2 objects, each with 1 key each. The first object key is the module ID. If the translation file is for a module, there is only this top level object. If the translation file is for an error the second object's key is the error code. This may seem redundant, and it is. This is done so that translation tools such as the in-development Locali by NeatoJS can index each string as module.string_name and module.error.string_name. Example object structures:

`json
{
"102": {
"name": "act",
"description": "Nintendo Network Accounts",
"system": "Wii U"
}
}
`

`json
{
"102": {
"2802": {
"name": "BANNED_ACCOUNT_ALL",
"message": "This Nintendo Network ID\ncannot be used.\n\nPlease make a note of the error code\nand visit support.nintendo.com.",
"short_description": "Your account is permanently banned from all aspects of the network.",
"long_description": "The account you are trying to use has been permanently banned from all aspects of the network. This includes, but is not limited to:\n\n- Miiverse\n- Game servers\n- 3rd party services which opt-in to respecting network bans",
"short_solution": "Not applicable.",
"long_solution": "Not applicable.",
"support_link": "https://preten.do/102-2802"
}
}
}
`

$3

| Name | Description |
| ------------- | ------------------------------------------------- |
| name | The name of the sysmodule |
| description | A short description of what the sysmodule handles |
| system | The system the sysmodule is for |

$3

| Name | Description |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| name | The internal name of the error. Not all errors have an internal name. If missing, Unknown |
| message | The message exactly as it appears _on the console_. If there is no relevant translation for the message, use the en_US version |
| short_description | A short description of the error. Intended to be used by the Discord bot. Plain text |
| long_description | A longer, more detailed, description of the error. Intended to be used by the website. Markdown |
| short_solution | A short solution for the error. Intended to be used by the Discord bot. Plain text |
| long_solution | A longer, more detailed, solution for the error. Intended to be used by the website. Markdown |
| support_link | Link to a relevant support page for the error. Typically the website, but does not have to be |

$3

The main purpose of this repository is to maintain the JSON translation files. However 2 utility functions are also included for JavaScript/TypeScript projects.

- getModuleInfo(sysmodule, locale) - Returns the module information for the locale, or null if not found
- getErrorInfo(sysmodule, code, locale) - Returns the error information (including the module information) for the locale. Returns null if either the module or error code is not found
- getAllErrors() - Returns an array of all error codes for all modules in the form MODULE-CODE`