readme

网络战船游戏

                               Batalla Naval
  			       -------------
							   
                                   idea:
		  Sebastian Cativa Tolosa and Ricardo Quesada

              server, XView client, GTK client, ncurses client:
                            by Ricardo Quesada
                            ([e-mail])


                               win16 client:
 			     por Horacio Pe馻
		          ([e-mail])



What do I need to play the game ?
---------------------------------
          A color X server for the GTK client or...
	  a color X server for the XView client or...
	  a color console (80x24) for the ncurses client or...
	  a VT100 terminal (80x24) for the ncurses client or...
	  a Windows 3.1+ for the Windows Client and...
	  Linux for the server and most of the clients :)



What do I need to know ?
------------------------
        The name of the host where the bnserver is running and the port number.
        Default is: port=1995 host=localhost



Command line arguments:
-----------------------
        bnclient [-p port_number] [-s host_name] [-u username] [-m | -c]
	options:
	    -p        the port that the server is listening to
	              default is 1995
	    -s        the name of the host where the bnserver ir running
	              default is localhost
            -u        username
                      default is your login name
	    -c        force color ( only in the ncurses client )
	    -m        force black & white ( only in the ncurses client )
	    
        eg:  bnclient -p 2001 -s era.balug.org.ar -u riq



client GTK ( gbnclient )
--------------------------
       It is very simple to use this program. You need a mouse and nothing
       more.
       1) If not connected try to establish a connection with the bnserver.
          Use 'Config'.
       2) Fill the left window with your ships.
       3) Press the 'Send Board' button.
       4) Wait another player (1 or more).
       5) Press 'Start' (to start the game).
       6) The enemies are in the right notebook ( fire there ).
       7) Wait your turn and hit in the right window.



client XView ( xbnclient )
--------------------------
       It is very simple to use this program. You need a mouse and nothing
       more.
       1) If not connected try to establish a connection with the bnserver.
          Use 'Config'.
       2) Fill the left window with your ships.
       3) Press the 'Send Board' button.
       4) Wait another player (1 or more).
       5) Press 'Start' (to start the game).
       6) Use the 'Players' with the right button of the mouse to see the
          enemys boards.
       7) Wait your turn and hit in the right window.

       Do not run this program under rxvt (vt100 emulation under X). Use,
       instead, xterm if you need a shell.Otherwise it will cause a 
       segmentation fault. Why ? I dont know.

       You can hide your board in the 'config'. (See below)



client ncurses ( nbnclient ):
-----------------------------
       It isnt as easy as xbnclient, because mouse is not supported. But you
       will find it very intuitive.
       1) If you are not connected try to establish a connection with the 
          bnserver using 'Connect'. If you have any problem press 'Config'.
          Use Tab to move to the buttons, and the use the cursors to move
	  between the buttons.
       2) Fill the left window with your ships. Move with the cursors and
          press Space or 'x' to toggle ships.
       3) Press the 'Send Board' button.
       4) Wait others players ( 1 or more at least ).
       5) Press 'Start' (to start the game).
       6) To see the enemys board use Page Down or 'n' for the next player's
          board.
	  Use Page up or 'p' for the previous player's board.
       7) Go to the right window. Press Tab to go the buttons, then the right
          cursor.
       8) Wait your turn and hit in the right window with Space.
       
       Keys that are equivalent (for VT100 terminals):
 
       Original        for VT100          meaning:       
       Page up         'p'                previous player's board.
       Page down       'n'                newt player's board.
       Cursor left     'j'                you know
       Cursor right    'l'                  "
       Cursor up       'i'                  "
       Cursor down     'k'                  "
       Tab             't'                Move between windows.
       Space           'x'                togles something on or off
       Backspace       '/'                you know

       More keys:
       'h' or 'H'      Hides your board. This is util if you are playing
                       against another player in the same room.

       Do not use this program under terminal with COLUMNS<80 or LINES<24.
       It will cause a segmentation fault.



server ( bnserver ):
--------------------
       bnserver [options] [-p port_number]
	options:
	    -p         the port that the server will listen to
	               default is 1995
            -d or -x   debug mode on (a monitor is activated)

        eg:  bnserver -d -p 2001
	     
       You need a terminal with 80x24.
       Do not use debug mode in background (unpredictable results).



Windows client ( bnwin )
------------------------
       The information of this client is in the wbnclient directory.

       

Meanings and otras yerbas:
--------------------------
      xbnclient &
 nbnclient (color mode)   nbnclient (B&W mode)
        GREEN                    ##             my ship
        RED                      xx             my ship was hit
        BLACK                    **             my ship was sunk
        BLUE                     ..             I missed the hit (water)

Quantity of ships:
        4 ships of 1 block
	3 ships of 2 blocks
	2 ships of 3 blocks
	1 ships of 4 blocks
	
	The ships cant be in diagonal and they cant touch each other.

        Buttons & meanings:

        Connect or Disconnect: Try to establish a connection with bnserver
	                       running in HOST listening to PORT, or 
	  		       disconnect from bnserver.
        Send Board or Start:   First you must fill your board with the ships.
	                       Then you must press 'Send Board' to check it.
			       If the board is OK, the legend of the button
			       changes to Start. You must press it to start
			       the games.
	Status:                Press this button to see the status of the
                               players. It will show you their names and the
			       status (connected,not connected,ready to play,
			       playing and playing *.This indicates the turn.)
        Send Msg:              Send message to another player. If local echo
  	                       is ON, the message will be copied in your
			       terminal. If you send a message to player 0,
			       the message will be send to everyone(broadcast).
        Config:                You can modify the:
 		               host name: (default is localhost)
			       port name: (default is 1995)
			       user name: (default is your login name)
			       And in the xbnclient you can hide your board.
                               (press 'h' in the nbnclient)
        About:                 It will show you the credits.
	Quit:                  Quits the games.


	
warning:
--------