two-torial/docs/errorcodes/sega.md

SEGA Error Codes

!!! info "Last updated: July 11th, 2024"

!!! warning "Before reading" This section contains various gamecode errors that a user may run across. There is an innumerable amount of these and I sometimes wonder if it's truly possible to have them all listed. Nonetheless, dozens, if not hundreds are currently missing. This list is a massive work in progress and will be updated with time.

Furthermore, not every solution listed can be the definitive solution to your error, sometimes various odd software and hardware nuances occur to create yet unseen issues.

Universal Game Error Codes

0000

!!! tip "Unexpected Error Occured" This error occurs when the data is horribly corrupt, incomplete, or modified incorrectly. Please redownload your data from a reliable source.

0032

!!! tip "Unexpected Error Occured" Generic network error with multiple symptoms, the most typical of which being enabling DHCP in Windows while the game expects a static IP. Try adding this to config_hook.json:

```json
{
    "network": {
        "property": {
            "dhcp": true
        }
    }
}
```

!!! tip If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

```json
{
    "emoney": {
        "enable": false
    },// (1)!
    "network": {
        "property": {
            "dhcp": true
        }
    }
}
```

1. Notice the comma here.

!!! tip If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

```
amdaemon.exe -f -c config_common.json config_server.json config_client.json {++config_hook.json++}
```

0800

!!! tip "Unknown Error" Generic network error usually thrown because the game is not able to connect to a server.

Make sure that you have correctly entered your network's address in `segatools.ini` under
the `[dns]` section:
```ini
[dns]
; Can also be an IP address:
; default=192.168.34.23
default=example.com
```

0919

!!! tip "DVD Drive Remain Error" This error occurs if the game detects an enabled DVD drive on the system. To resolve, either disable your computer's DVD drive, or enable DVD drive emulation in segatools.ini:

```ini hl_lines="2"
[dvd]
enable=1
```

0949

!!! tip "Keychip Not Found" Enable keychip emulation in segatools.ini:

```ini hl_lines="2"
[keychip]
enable=1
```

If on a real cabinet using a real keychip, confirm that the keychip is connected
properly and working.

4104

!!! tip "Unexpected Error Occured" Make sure that the game files are not on the E: or Y: drive. If that is already the case, check if the config files passed to AM Daemon exists and are valid JSON files:

```hl_lines="5"
Runtime exception occurred.
File: D:\Jenkins\workspace\amdaemon_all_build\libs\amdproc\src\ConfigFileLoader.cpp
Line: 79
Function: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)
Message: Cannot open "config_nonexistent.json".
```

```hl_lines="5 6"
Runtime exception occurred.
File: D:\Jenkins\workspace\amdaemon_all_build\libs\amdproc\src\ConfigFileLoader.cpp
Line: 89
Function: enum amdaemon::process::ConfigFileLoader::Result __cdecl `anonymous-namespace'::parse(const class std::basic_string<wchar_t,struct std::char_traits<wchar_t>,class std::allocator<wchar_t> > &,class picojson::value &)
Message: Cannot parse ".\config_hook.json".
syntax error at line 6 near: }
```

4105

!!! tip "Unexpected Error Occured" Check the AM Daemon window for any "runtime exception" messages, such as

```hl_lines="6"
amsGfetcherThreadContextInit: Line1345  Error: load Icf failed.
Runtime exception occurred.
File: D:\Jenkins\workspace\amdaemon_all_build\libs\libamw\src\amw_netdeliver_context.cpp
Line: 91
Function: enum am::util::ModuleContext<3>::Status __cdecl am::netdeliver::Context::initialize(void)
Message: amGfetcherInit(). ErrCode -1.
```

Then continue by checking [AMDaemon error codes](#amdaemon-error-codes).

6401

!!! tip "I/O board is not connected to main board" This error occurs when the game times out trying to communicate with the I/O board.

When using segatools, this happens because I/O emulation took too long, which is
usually caused by long-running background tasks (e.g. Windows Defender, Windows
Update, file-syncing software). Try to see if this can be fixed by setting the game
process and/or `amdaemon.exe` to high/realtime priority.

6501

!!! tip "Aime Card Reader Not Found" This error occurs when an Aime card reader is not found. Make sure you enabled Aime card reader emulation in segatools.ini if you don't have a physical reader connected:

```ini
[aime]
enable=1
```

6503

!!! tip "Failed to read Aime card" This error occurs when the Aime card cannot be read. Make sure your connection to the ALL.Net server is good (the network icon in the bottom corner is green).

8114

!!! tip "ALL.Net System error (RTC)" Make sure you're connected to an ALL.Net server for the first boot, or disable accounting by editing config_hook.json:

```json
{
    "allnet_accounting": {
        "enable": false
    }
}
```

!!! tip If you're copying into an existing config_hook.json, remove the outer braces and add a comma to the previous item, like so:

```json
{
    "emoney": {
        "enable": false
    },// (1)!
    "allnet_accounting": {
        "enable": false
    }
}
```

1. Notice the comma here.

!!! tip If your game files does not include config_hook.json, it is OK to create a new file, then edit the launch script (usually start.bat) to tell the game about it:

```
amdaemon.exe -f -c config_common.json config_server.json config_client.json {++config_hook.json++}
```

CHUNITHM Error Codes

3101

!!! tip "An unexpected error has occurred with the main device" This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if ChuniIO DLLs are working.

3102

!!! tip "Initialization failure with the main device" This error occurs when the game fails to communicate with the controller. Check if your controller is connected properly and if IO DLLs are working.

3201, 3202, 3203, 3204, 3205, 3206

!!! tip "Cannot confirm the connection with the side device sensor 1/2/3/4/5/6" This error occurs if the air sensors are not functional or blocked during system test. To resolve this, enter and exit Test mode by pressing the F1 key (or 1 on older segatools) then stay clear of your controller. If the error still happens, your air sensors may be faulty.

3300

!!! tip "Duplicate servers in the same network" If multiple CHUNITHM machines are on the same LAN network, only one of them can be the server (dip switch 1 ON). Set all other machines to dip switch 1 OFF:

```ini hl_lines="2"
[gpio]
dipsw1=0
```

3301

!!! tip "Duplicate STANDARD in the same group" If multiple CHUNITHM machines are on the same LAN network and cabinet group (A/B/C/D), one of them should set reference machine settings to STANDARD and the rest to FOLLOW THE STANDARD. Change this by going to Test menu -> Game Settings (4th option) -> Reference machine settings (2nd option).

3400

!!! tip "Monitor Not Supported 120fps" This error occurs if you're running the game in SP mode but the monitor is not 1920x1080@120Hz in 32-bit color mode. Adjust display settings and try again.

3401

!!! tip "Machine Not Supported 120fps" This error occurs if you're running the game in CVT mode at 120fps. Use SP mode (dip switch 3 OFF) to run the game in 120fps. In segatools.ini this would be:

```ini
[gpio]
dipsw3=0
```

AMDaemon Error Codes

ampdGd1232a01aInit(). ErrCode -4

!!! tip "" This error occurs because of a VFD port number mismatch. Update segatools, or if you're using a real VFD, confirm that the VFD uses the same port as specified in config_common.json or config_sp.json (CHUNITHM) under emoney.display_port:

```json
"emoney" :
{        
    "display_port" : 2 // (1)!
}
```

1. This should match the COM port that your real VFD is connected to.

amAppImageInit(). ErrCode -5

!!! tip "" Path to the configured AMFS directory is too long. Ensure that the path is shorter than 16 characters (32 bytes).

RegCreateKeyExW(). ErrorCode -5

!!! tip "" This error occurs because the Windows registry cannot be written to as a normal user. Start the game as administrator once, or update segatools.

amSysFileInitEx(). ErrCode -5

!!! tip "" The AMFS folder is read only. Uncheck the read only property in File Explorer for the AMFS folder.

amGfetcherInit(). ErrCode -1

!!! tip "" ICF1 is missing in the configured AMFS directory. Get the correct ICF for your game (the game ID in the ICF must be correct).