NAME

       bubbros-server - the bub-n-bros server.

SYNOPSIS

       bubbros-server [ level-file.bin ] [options]

DESCRIPTION

       bubbros-server  starts  an http server that acts as a control panel for the server. The server listens on
       port 8000 by default. The url for the control panel is http://server:port/0xN where 0xN is a  random  hex
       number  (acts as minimal protection). This url is printed when the server starts.  You can start and view
       games and kill the server from this panel. The control panel also allows you to type in the address of  a
       server  to  connect  to,  the script will then open a client to that server. The http server also servers
       java applet clients for those players who wish to use one.

       When a game is started the script opens a port for the game server. This port can then be connected to by
       a client.  Clients autodetect servers running on the local network with UDP ping on port 8056.

   Connection forming
       The client forms a tcp connection to the server. Or, when  using  the  metaserver,  the  server  forms  a
       connection  to  the  client.  If  this  fails, the client and server try a simultaneous SYN connect. This
       sometimes works if the server and client are behind firewalls. The server then tries to transmit the data
       over udp. If it gets no response from the client it will fall back to the existing tcp connection.

OPTIONS

       -b N, --begin N, --start N
              Start at board (level) number N.  The default is 1. See also the -s option.

       -h, --help
              Display help.

       -i, --infinite
              Restart the server at the end of the game. Normally the server quits after  a  certain  period  of
              inactivity.  This is useful when used with the -m option to make a public server that is available
              for a long time.

       -l N, --lives N
              Limit number of lives to N.  If this option is not specified the number of lives will be infinite.

       -m, --metaserver
              Register server with the Metaserver (currently) at codespeak.net:8050.   This  makes  your  server
              visible to everybody, and also facilitates joining through a fascistic firewall.

       --port TYPE=N Sets default listening ports. If type is LISTEN , sets the game server port to N.  The game
              server  port  is chosen randomly by default. If the type is HTTP , sets the http server port to N.
              The http server port defaults to 8000.  Another port will be chosen if none was specified and 8000
              is already in use. The server also listens to UDP ping on port 8056.

       -s N, --step N
              Increase board number with N when a board is completed. Defaults to 1. see also the -b option.

OUTPUT

       The server outputs helpful debug information concerning the http and game servers.

SEE ALSO

       bubbros(6) bubbros-client(6)

                                                December 7, 2007                               bubbros-server(6)