Troubleshooting

Having problems getting MAMEHub or a specific game to work? Here is a checklist of questions and possible answers to common problems.

Q: Why does my game not show up in the list?

A: MAMEHub follows a list of files set up by the MAME and MESS community. The reason for this is to make sure people are
   playing the same versions in order to keep the lobby clear and avoid unnecessary confusion.

   The game list can display 2 types of icons in front of a title, a downward arrow and a green checkmark. Games that you can
   download from other people in the lobby are shown with a downward arrow. Verified games that you own yourself have green
   checkmarks. If a certain game is not on the list, nobody currently has it or it's not a common ROM (EG: translations & hacks).

   Even if you have the correct game it still may not show up with a green check mark. There are various reasons for this:

   - The ROM may be too old and is missing the correct files.
   - Consoles often require an additional BIOS file (EG: snes.zip), which has to be placed in the main ROMs directory.
   - The games for these consoles have to be placed in a sub-folder in your main ROMs directory, with the name of the system
     written in small case letters (EG: ../roms/snes).

Q: Why does my game not start?

A: The first thing you have to do is turn on the event log. You do this by going to Edit -> Settings and check the Show Emulator
   Log option. Run the game again, wait for a pop-up window and scroll down to read the error.

   A common reason for a game not starting is a missing BIOS file. Most consoles and home computers need one as do some Arcade
   games (Neo-Geo, Capcom, PGM, Naomi). Some games also need a so called CHD file (see below).

Q: Why can't I join somebody's game?

A: The emulator log (Edit -> Settings) may show you the reason you cannot connect. Make sure you and the person you're trying to
   join have opened port 6805 TCP & UDP in your routers and firewalls. Go to http://portforward.com/ for more information.

   Locked games also prevent other users from entering. A game closes automatically after a couple of minutes or the host can do
   it manually with the /lock command.

Q: What is desyncing and what can I do to prevent this?

A: When 2 or more played desync (desynchronize) it means that their games are no longer showing the same results. This often goes
   unnoticed until the behavior of the other players becomes extremely erratic.

   Games that do not support save states are more prone to having desyncs. Make sure all players are using the same (dipswitch)
   settings or cheats and do not reset the game while others are connected. Also, it is always wise to give the host a few
   seconds to set up the game before joining.

Q: What can I do to improve the in-game input lag / choppiness?

 A: Play with people that show a low ping in the lobby. Pings up to 200ms are playable depending on the type of game. Games that
   need high speed or reflexes, such as Fighters, benefit from a low ping (<100ms).

   Other options are to raise the priority of CSUME.EXE in the task manager. To do this hit CONTROL+ALT+DELETE, select the
   Processes tab, right-click CSUME.EXE and set the priority to AboveNormal.

   Playing through the command line (CSUME, see below) can sometimes help on extremely old machines, although the latest version
   of the MAMEHub lobby is well optimized.

Q: Can I play online without the Java lobby?

A: Yes you can, you will have to run the file CSUME.EXE from a command prompt. This can be useful for testing games that do not
   (yet) show up in the list or when you have an old PC and the Java applet is slowing your machine down. Another good reason to
   learn how use CSUME is when you wish to revert to an older version due to incompatibilities.

   Go to START -> Run... -> Type: cmd
   Change to the DIST folder with the 'cd' command, for example type: cd C:\Games\MAMEHub3\MAMEHubRepo\Binaries\dist
   Finally, make sure your game is in the ROMS folder and type:
   CSUME <system> -<media> <gamename> -server|-client -hostname <IP number> -username <name> -port <port>

   The system name is usually the same as the BIOS ZIP file, game name is the file name and media can be -cart (cartridge),
   -flop1 (floppy disk), -cass (cassette,tape), -cdrm (CDROM). Some examples:

   Arcade offline:      CSUME game1
   SNES online host:    CSUME snes -cart game2.smc -server -username Myname1 -port 6805
   Amiga online client: CSUME a500 -flop1 game3.adf -client -hostname 1.2.3.4 -username Myname2 -port 6805
   C64 offline:         CSUME c64 -cass "C:\Games\MAMEHub\c64_roms\use quotes if spaces in file.tap"
   TG16/PCE CDROM:      CSUME pce -cart syscard.pce -cdrm game4.chd

Q: I don't have a CHD file, now what? / How do I run CDROM games?

A: A CHD (Compressed Hard Drive) image file is needed for some hard drive based Arcade games and CDROM games (PS1, N64, SegaCD,
   PCE CDROM). If you only have the original CDROM or ISO you can create the CHD yourself. You need the LATEST VERSION of the
   program CHDMAN.EXE, which is included in the official MAME package.
   The command is (with the quotes):

   chdman.exe createcd -i "path & name of an ISO or CUE image of the CDROM" -o "path & name of the output CHD"

   Custom CHDs will not show up in the MAMEHub game list. You have the choice of running the game with CSUME (see above) or
   manually add it to a so called XML-file. Each system has its own file, which can be found in the HASH folder.

   Inside you will see files with the .xml extension. You can simply open them in Notepad, Wordpad or any other text editor. Each
   CHD-based game is verified by its SHA1 checksum, which is unique for every file. Use the following command to retrieve the
   correct checksum (copy the SHA1 not the Data SHA1):

   chdman.exe info -i "path & name of the CHD file"

   An example: To add a custom CHD named CustomGame1.chd with an SHA1 of 8d1g1tc0d38d1g1tc0d38d1g1tc0d38d1g1tc0d3 to the Japanese
   Playstation you will have to edit (or create, if the file does not exist) psj.xml and make sure you add the following code
   below the fourth line from the top:

   <software name="CustomGame1">
      <description>CustomGame1</description>
      <year>19??</year>
      <publisher>&lt;unknown&gt;</publisher>
      <part name="cdrom" interface="psx_cdrom">
         <diskarea name="cdrom">
            <disk name="CustomGame1" sha1="8d1g1tc0d38d1g1tc0d38d1g1tc0d38d1g1tc0d3" />
         </diskarea>
      </part>
   </software>

Q: Why does my Dip switches, Game Configuration not match the host?

A: Csume is able to mirror the "Tab menu" settings so that the client receives the 
same configuration as the Host. However It is currently bugged so that it will not show
in the clients UI the proper settings even though the feature works as intended other wise.