bemanitools/doc/game-error-codes.md

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

Writing the FPGA firmware fails. Can have various causes depending on your setup.

FW TRNS-OUT

This typically happens if it takes too long to upload the base firmware to the USB IO. A potential root-cause can be bad timing since the game uses a bad combination of software sleeps and fixed timeouts making this code prone to fail.

Known occurances

• IIDX

How to fix

FPGA WRITE ERROR

• Restart the game
• Re-copy bemanitools

FW TRNS-OUT

• Restart the game
• Re-copy bemanitools
• Running the process on high priority and with admin rights
• If you attached a debugger, that might have messed with the timing and caused this. Try a different debugger or attach it later in the boot process

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)

BACKUP DATA ERROR

The backup data is corrupted. Press the test button to re-initialize it.

Known occurances

• IIDX 15 (BACKUP DATA ERROR)

How do I fix it?

ACIO ERROR

If you're using ACrealIO, cut the reset trace on your Arduino.

BACKUP DATA ERROR

Follow the instructions of the error message. You will have to re-set certain settings like clock settings in the operator menu to complete initialization.

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:

<dest __type="str">...</dest>

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.

<spec __type="str">...</spec>

Should almost always be A. DDR will support B for non-HD monitors.

<rev __type="str">...</rev>

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-1013

Description

NETWORK ERROR

Cannot communicate with server.

Ensure that your internet connection is working and that your router is turned on.

Ensure that your machine is connected to your router.

Press the service button to start the game.

Known occurances

• IIDX, probably all known versions

How do I fix it?

The original message is already telling you what is going on:

• Check if your machine/pc has an internet connection
• Check your firewall settings
• Check that the server address is configured and correct in iidxhook.conf (old games) or ea3-config.xml
• You can disable the network in the operator menu to just boot the game first. Note that this is not possible on any versions starting IIDX 20 (tricoro).

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 <network> section. The <network> section in your ea3-config.xml file is malformed in some way.

Known occurances

N/A

How do I fix it?

Ensure your <network> section follows the following format:

<network>
	<timeout __type="u32">10000</timeout>
	<sz_xrpc_buf __type="u32">102400</sz_xrpc_buf>
	<ssl __type="bool">0</ssl>
	<services></services>
	<url_slash __type="bool">1</url_slash>
</network>

Note: Delete the line <url_slash __type="bool">1</url_slash> 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:

<apsmanager __type="u8">0</apsmanager>