From 9c49839e57f942ba60e89b55b5350689d110cae2 Mon Sep 17 00:00:00 2001 From: icex2 Date: Sun, 2 May 2021 13:42:18 +0200 Subject: [PATCH] Add document with game error codes Reasoning given in document why this should be part of btools --- doc/game-error-codes.md | 720 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 720 insertions(+) create mode 100644 doc/game-error-codes.md diff --git a/doc/game-error-codes.md b/doc/game-error-codes.md new file mode 100644 index 0000000..41dc66b --- /dev/null +++ b/doc/game-error-codes.md @@ -0,0 +1,720 @@ +# Bemani Game Error Codes + +This document collects the various error codes that are know across the many games including some +information what can be done. + +This information is not part of bemanitools but useful to many users using it to run the games. We +saw users encountering these errors not knowing what they mean. Therefore, we include these errors +in the repository to provide an accessible source of information regarding them. + +Important: The error codes are not consistent throughout the many years of game series and versions. + +It is adviced to read the error information carefully (use Google Translate App with your phone's +camera) and check the following sections. It would be great to get feedback if you see information +missing or specific games and versions not matching to increase the value of the list. + +## 5-0000 series errors + +### 5-0000-0000 + +#### Description + +A generic critical error. + +#### Known occurances + +N/A + +#### How to fix + +* Make sure your data is not set to read only, especially the dev folder. +* Disable all network adapters other than the one used to connect to the Internet. +* Check for hidden network adapters in Device Manager. + +## 5-1500 series errors + +### 5-1500-0000 + +#### Description + +IO ERROR + +#### Known occurances + +* Pop'n Music 15 + +#### How to fix + +No information available. + +### 5-1500-0002 + +#### Description + +SOUND DATA CREATE ERROR + +#### Known occurances + +N/A + +#### How to fix + +* Check the integrity of the data you have, i.e. some files might be corrupted +* Check your physical drive. Is it failing? + +## 5-1501 series errors + +### 5-1501-0000 + +#### Description + +IO BOARD ERROR + +#### Known occurances + +N/A + +#### How to fix + +* Recopy Bemanitools. +* For Reflec Beat, make sure you are not missing device.dll. (This seems to apply to some older +version of bemanitools) + +## 5-1502 series errors + +### 5-1502-0000 + +#### Description + +BACKUP CHECK ERROR + +#### Known occurances + +* Pop'n'Music 21 Sunny Park + +#### How to fix + +* Give access to gamestart.bat and launcher.exe from Windows Firewall if enabled. +* Make sure no antivirus software firewall is blocking access to those files. +* Start gamestart.bat as Administrator. + +### 5-1502-0000 + +#### Description + +HDD READ ERROR + +#### Known occurances + +N/A + +#### How to fix + +* Make sure `/dev/` isn't read-only. + +### 5-1502-0002 + +#### Description + +HDD READ ERROR + +#### Known occurances + +* GFDM V4 + +#### How to fix + +Unknown + +## 5-1503 series errors + +### 5-1503-0000 + +#### Description + +USB I/O ERROR (FPGA WRITE ERROR) + +#### Known occurances + +N/A + +#### How to fix + +* Make sure data\hex\030408.hex exists. + +### 5-1503-0001 + +#### Description + +DATA ERROR + +"Could not read the file normally. There is a likelihood the file is damaged." + +This error occurs when a file is either missing or corrupt. + +#### Known occurances + +N/A + +#### How to fix + +* Check the integrity of the data you have, i.e. some files might be corrupted +* If the data came in an archive format, try extracting it again with another application. +* Make sure your game is up to date with the current data available. +* Check your physical drive. Is it failing? + +### 5-1503-0004 + +#### Description + +USBIO ERROR (NO ANSWER...) + +This error occurs when the game does not receive a heartbeat from the IO board. On legitimate +hardware, this error is usually caused by the IO board resetting during play. The issue is rarely +fixed by simply restarting the game and will require a full power cycle. + +#### Known occurances + +N/A + +#### How do I fix it? + +Real hardware: + +* Check the USB cable between the PC and the IO board is okay. +* Make sure the IO board is getting enough of a clean supply of power. + +Bemanitools: + +* Don't attempt to put your computer to sleep while playing rhythm games. +* Change launcher.exe process priority to High when starting the game. + +### 5-1503-0006 + +#### Description + +CARD DEVICE ERROR + +#### Known occurances + +N/A + +#### How do I fix it? + +* Recopy Bemanitools. + +### 5-1503-0007 + +#### Description + +USBIO ERROR (FM DL-ERR) + +#### Known occurances + +N/A + +#### How do I fix it? + +* Run the game using gamestart.bat, don't just drag and drop the game dll onto launcher.exe + +### 5-1503-0008 + +#### Description + +FPGA Write error + +#### Known occurances + +* IIDX Tricoro + +Seen in Tricoro Omnimix RC1. + +#### How do I fix it? + +Unknown + +### 5-1503-9000 + +### Description + +PCB ERROR (PCB is unusual.) + +#### Known occurances + +N/A + +#### How do I fix it? + +* Make sure your AC(real)IO board is on the correct COM port. + +## 5-1504 series errors + +### 5-1504-0000 + +#### Description + +IC CARD READER ERROR + +Something is wrong with your e-amusement card readers (usually a timeout due to them not existing). + +#### Known occurances + +N/A + +#### How do I fix it? + +Real hardware: + +* Make sure your readers are connected and powered on. +* Check your serial cables are good. + +### 5-1504-0003 + +### Description + +N/A + +#### Known occurances + +N/A + +#### How do I fix it? + +N/A + +### 5-1504-0004 + +### Description + +SDLOAD TIMEOUT or SOUND LOAD TIMEOUT + +#### Known occurances + +N/A + +#### How do I fix it? + +N/A + +## 5-1505 series errors + +### 5-1505-0000 + +#### Description + +HDD Data Error(BPM Notes) + +For Jubeat Ripples, getting this error the first time you boot is normal. After getting this error, +the game may take 1-3 minutes longer to boot as it regenerates backup data. + +#### Known occurances + +* Jubeat Ripples + +#### How do I fix it? + +* Check the integrity of the data you have, i.e. some files might be corrupted +* If the data came in an archive format, try extracting it again with another application. +* Check your physical drive. Is it failing? + +### 5-1505-0001 + +#### Description + +HDD Data Error(Music Data) + +#### Known occurances + +N/A + +#### How do I fix it? + +* Check the integrity of the data you have, i.e. some files might be corrupted +* If the data came in an archive format, try extracting it again with another application. +* Check your physical drive. Is it failing? + +### 5-1505-0002 + +#### Description + +Coin Error + +This error occurs when the coin line (the input triggered when a coin is inserted) is held closed +for too long. + +#### Known occurances + +N/A + +#### How do I fix it? + +##### Real hardware + +* There may be a coin stuck, check. +* The coin mechanism may be stuck, check. +* Don't hold down the coin line so long. + +### 5-1505-0006 + +#### Description + +HDD DATA ERROR(MOUNT IMAGEFS) + +#### Known occurances + +N/A + +#### How do I fix it? + +* Check the integrity of the data you have, i.e. some files might be corrupted +* If the data came in an archive format, try extracting it again with another application. +* Check your physical drive. Is it failing? + +### 5-1505-0025 + +#### Description + +N/A + +#### Known occurances + +* Jubeat Saucer Fullfill + +#### How do I fix it? + +* Disable excess network adapters + +## 5-1506 series errors + +### 5-1506-0000 + +#### Description + +ACIO ERROR (ERR_INIT_LINE) + +#### Known occurances + +N/A + +#### How do I fix it? + +* If you're using ACrealIO, cut the reset trace on your Arduino. + +### 5-1506-0001 + +#### Description + +SHOP NAME ERROR + +This error may happen before the monitor check on IIDX. + +#### Known occurances + +* IIDX (version?) + +#### How do I fix it? + +Press the service button and set the shop name in "NETWORK OPTIONS". + +### 5-1506-1001 + +#### Description + +CLOCK ERROR + +#### Known occurances + +N/A + +#### How do I fix it? + +* "Set" and save the clock date and time in the test menu +* Recopy Bemanitools + +## 5-1507 series errors + +### 5-1507-0000 + +#### Description + +SECURITY ERROR + +#### Known occurances + +N/A + +#### How do I fix it? + +Make sure your ea3-config.xml file contains valid values on the following lines: + +```xml +... +``` + +Should almost always be `J`. Certain games will support `K` (Korea) or `A` (Asia) but there is +rarely a reason to use it. DDR 2014 and forward will support `U`. DanEvo will support (I believe) +`C`. + +```xml +... +``` + +Should almost always be `A`. DDR will support `B` for non-HD monitors. + +```xml +... +``` + +Should always be `A`. + +## 5-1508 series errors + +### 5-1508-0000 + +#### Description + +LAMP CHECK ERROR + +#### Known occurances + +* Pop'n Music 20 Fantasia + +#### How do I fix it? + +N/A + +## 5-1509 series errors + +### 5-1509-0000 + +#### Description + +REBOOT THE MACHINE + +The original message in Japanese: 電源を再投入して下さい + +#### Known occurances + +* Pop'n Music 22 Lapistoria + +#### How do I fix it? + +Restart entire machine if on cabinet, or close the game (ALT+F4/ALT+TAB and then close through +taskbar) and re-run the launcher/gamestart file + +## 5-2000 series errors (Network errors) + +### 5-2000-0000 + +#### Description + +Router error. + +Something's not okay with the connection between the game and your router. This can either be a +(W)LAN error, or something within your computer settings (firewall, network adapter, etc.) + +#### Known occurances + +N/A + +#### How do I fix it? + +* Restart your game. +* Check if your computer is connected to the Internet at all. +* Make sure the services URL is correct. +* Disable all network adapters other than the one used to connect to the Internet. Alternatively, +setting that adapter to have the highest affinity also works. +* If none of the above work, reinstall a newer or older version of your network drivers. + +### 5-2002-0000 + +#### Description + +speculation: general malformed ea3-config.xml file or server communication error + +#### Known occurances + +N/A + +#### How do I fix it? + +* Make sure you're editing the right file for network configuration settings. + +### 5-2002-0916 + +#### Description + +Cannot communicate with the server. + +#### Known occurances + +N/A + +#### How do I fix it? + +N/A + +### 5-2002-2301 + +#### Description + +Cannot communicate with the server. + +#### Known occurances + +N/A + +#### How do I fix it? + +Your ea3 services URL is probably incorrect. + +### 5-2000-2402 + +#### Description + +No PCBID. You have no PCBID. + +#### Known occurances + +N/A + +#### How do I fix it? + +Add a valid PCBID to `ea3-config.xml`. + +### 5-2002-0910 + +#### Description + +Server Error. The game cannot communicate with the server. + +#### Known occurances + +N/A + +#### How do I fix it? + +Make sure the services URL is correct. + +### 5-2002-2403 + +#### Description + +Unauthorized. The server is rejecting your PCBID. + +#### Known occurances + +N/A + +#### How do I fix it? + +* Check that there is a valid PCBID in ea3-config.xml. + +### 5-2002-2400 + +#### Description + +Bad Request. Syntax was entered improperly and the server does not understand it. + +#### Known occurances + +N/A + +#### How do I fix it? + +Check your services URL and make sure it is entered correctly (e.g. "http:" instead of "https:") + +### 5-2002-2404 + +#### Description + +Not found. The server can't find the URL that the game has requested, this is usually because the +game is attempting to connect to an incorrect endpoint. + +#### Known occurances + +N/A + +#### How do I fix it? + +* Check your services URL in `ea3-config.xml`. Make sure to remove any slash at the end of the URL +and check for https/http. +* If you are running Spada, ensure to use a service URL that supports that older game (check with +your private server provider) +* If you are running Tune Street, ensure to use a service URL that supports that older game (check +with your private server provider) + +### 5-2003-2404 + +#### Description + +Malformed `` section. The `` section in your `ea3-config.xml` file is malformed +in some way. + +#### Known occurances + +N/A + +#### How do I fix it? + +Ensure your `` section follows the following format: + +```xml + + 10000 + 102400 + 0 + + 1 + +``` + +Note: Delete the line `1` if you're connecting to Arcana + +### 5-2002-2500 + +#### Description + +??? (Logs say http status 500) + +#### Known occurances + +N/A + +#### How do I fix it? + +If you are playing Lincle, use the `/core/services` URL from Tricoro, not xrpc. + +### 5-2003-2502 + +#### Description + +Server Error. The game cannot communicate with the server. + +#### Known occurances + +N/A + +#### How do I fix it? + +Check if your `hosts` file has any DNS redirects to other private servers that might interfere +with this + +### 5-2016-0000 + +#### Description + +"apsmanager" is a special eAM Participation system for Korean machines(XXX:K). This system +is maybe not supported by private servers. + +#### Known occurances + +N/A + +#### How do I fix it? + +Make sure your `ea3-config.xml` has this line set to 0: + +```xml +0 +```