Usage of JMhing

The JMhing application comes in a .jar file and must be launched with java 1.5 or newer. This also means java must be installed on the system. To start the client simply double click on the file (and hope no archive programm is associated to the .jar extension). If this doesn't work load the client by hand by typing the following into a shell (windows prompt, unix shell, ...): java -jar JMhing.jar (or how the file is called). This will load an start the Client.class file. If you want to start a server type java -cp JMhing.jar Server in a shell and if the server should get a login password type java -cp JMhing.jar Server the_password instead. You can also start the client with java -cp JMhing.jar Client if you want.

The game use the TCP port 21314, defined in the Server.java file (Server#PORT).

To connect to a game select "Connect" from the menu and enter the login informations. If you are logged in into the server switch to the Lobby tab and wait for other players.

If all players (at least 2) are ready switch to the Game tab and see how the server deals cards to the players. After the cards are dealed one player is on turn and can draw a card from the stack by clicking on Draw card. You can select cards by clicking on them, they got highlighted and unselect them by clicking again. Depend on the action you want to do you need to select several cards. If you select mhing cards and play them for a combo a popup dialog is shown to specific the type and value of the mhing card. If the combos or any other actions are invalid an error message is shown.

After a player discard a card the other players can call this card by clicking on Sequence, Triplet or Mhing in the middle of the area. The timeout between discard a card and drawing a new one from the stack from the next player will be 5 seconds.

If a player wins a round the Summary tab is shown and the credits are calculated. After that you can switch to the Lobby again to start a new round.

The Network tab is for debugging the network protocol. In this tab you will see the messages between the Client and Server. The protocol itself is explained in the /docs/protocol.html file in the SVN repository.