NAME

       RealTimeBattle - a robot programming game

SYNOPSIS

       realtimebattle  [-n|-c|-d|-D  debug-level]  [-g]  [-o  option-file] [-l logfile] [-t tournament-file] [-s
       statistics-file] [-p port-number]
       realtimebattle --replay logfile [-p port-number]
       realtimebattle -h | --help
       realtimebattle -v | --version

DESCRIPTION

       RealTimeBattle is a programming game, in which robots controlled by programs compete against each  other.
       The goal is to destroy the enemies, using the radar to examine the environment and the cannon to shoot.

       Even  though  the environment the robots are moving in is fairly simple, it is far from easy to construct
       an intelligent robot-program. RealTimeBattle is constructed to be easy to use,  flexible  and  fast.  The
       intention is that the program could be used for learning programming languages, as a test for intelligent
       algorithms or just as a game to play and enjoy.

       Here is a list of features of RealTimeBattle:

       •   Game progresses in real time, with the robot programs running as child processes to RealTimeBattle.

       •   The robots communicate with the main program using the standard input and output.

       •   Robots can be constructed in almost any programming language.

       •   Any number of robots can compete simultaneously if allowed by operating system and hardware.

       •   A  simple  messaging  language  is  used for communication, which makes it easy to start constructing
           robots.

       •   Robots behave like a real physical object.

       •   Own arenas can be created.

       •   The simulation environment is highly configurable.

       •   It is possible to connect external clients to the simulation server.

       •   Basic team support is directly integrated in the game, sophisticated team play available due to  team
           frameworks.

       •   RealTimeBattle is distributed under the General Public License (GPL).

OPTIONS

       --debug_mode, -d
              debug mode

       --debug_level 0-5, -D 0-5
              sets the initial debug level. implies -d

       --normal_mode, -n
              normal mode (default)

       --competition_mode, -c
              competition mode

       --no_graphics, -g
              no graphics will be displayed

       --option_file file, -o file
              selects option-file (default: $HOME/.rtbrc)

       --log_file file, -l file
              make log file, if 'file' is '-' the log is sent to STDOUT

       --tournament_file file, -t file
              specify a tournament file to autostart a tournament

       --statistics_file file, -s file
              file to print the statistics to when autostarting

       --message_file file, -m file
              redirect messages to 'file'.
               '-' as 'file' is equivalent to STDOUT.  If both log and messages are send to STDOUT, '-m' will be
              ignored

       --replay file, -r file
              a log file to replay.  if '-' is specified as file, input is taken from STDIN

       --help, -h
              prints this message

       --version, -v
              prints the version number

       --port_number, -p
              specifies  the  port  for  remote  clients  (default  is  32134)  (only available if compiled with
              --enable-network)

EXAMPLES

       realtimebattle
              Just start RealTimeBattle in normal mode with graphical user interface and  listening  for  remote
              clients on port 32134 (if compiled with --enable-network).

       realtimebattle -D 5
              Enable  full  debugging  output.  Note  that this is also useful for debugging robots, because the
              debug level is sent to the robots as a game option.

       realtimebattle -c -g -o option-file -t tournament-file -l logfile -s statistics-file
              A typical competition start of RealTimeBattle. There will be no graphical user interface  and  the
              results of the competion will be written to logfile and statistics-file.

FILES

       /usr/share/doc/realtimebattle
       /usr/lib/realtimebattle/Arenas
       /usr/lib/realtimebattle/Robots
       /usr/include/realtimebattle/Messagetypes.h

SEE ALSO

       The  full documentation for RealTimeBattle is maintained as an SGML manual and should have been installed
       together with the program in various formats.  You may have a look at the  project  website,  which  also
       contains the documentation: http://realtimebattle.sourceforge.net/

MAINTAINER

       The  current maintainer of the RealTimeBattle project is Johannes Nicolai <jonico@users.sourceforge.net>.
       Feel  free  to  contact  him  and  the   other   developers   at   the   source   forge   project   page:
       http://sourceforge.net/projects/realtimebattle/

BUGS

       If  you find anything in this package which doesn't work, appears strange, is missing, is spellt wrong or
       is just confusing, don't  hesitate  to  send  in  a  bug  report  to  the  Sourceforge  Bug  Tracker  at:
       http://sourceforge.net/tracker/?group_id=561

AUTHOR

       This manual page was written by Falko Menge <fakko@users.sourceforge.net> and is part of RealTimeBattle.

1.0.8                                              2006-01-25                                  realtimebattle(6)