Robocode/Console Usage

This page describes how to run Robocode from a console.

Starting Robocode

Robocode is normally started by the robocode.bat (on Windows) or robocode.sh (on Linux and Mac OS) batch files. The batch files is used for setting required parameters for the Java VM in order to start and run Robocode properly.

Robocode is started from a console by writing:

java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar;libs/codesize.jar robocode.Robocode

Here you must stand in the 'robocode' directory where Robocode is installed.

• "java" is the command used for running the Java VM.
• "-Xmx512M" sets the maximum heap size the Java VM to 512 MB RAM.
• "-Dsun.io.useCanonCaches=false" prevents SecurityExceptions to occur when running code outside of Robocode's secured sandbox.
• "-cp libs/robocode.jar;libs/codesize.jar" specifies the required .jar files for running Robocode.
• "robocode.Robocode" specifies the main entry class of the Robocode game.

With all of the above, Robocode will startup with a graphical user interface (GUI) waiting for user inputs. But it is possible to change the way Robocode is started how it must run. That is, you can specify additional parameters to the command line that is used for running Robocode. These parameters are described in the following.

Console Usage

Usage: robocode [-cwd path] [-battle filename [-results filename] [-tps tps]
                [-minimize] [-nodisplay] [-nosound]]

where options include:
    -cwd <path>             Change the current working directory
    -battle <battle file>   Run the battle specified in a battle file
    -results <file>         Save results to the specified text file
    -tps <tps>              Set the TPS (Turns Per Second) to use
    -minimize               Run minimized when Robocode starts
    -nodisplay              Run with the display / GUI disabled
    -nosound                Run with sound disabled

properties include:
    -DWORKINGDIRECTORY=<path>    Set the current working directory
    -DNOSECURITY="true"|"false"  Enable or disable Robocode's security manager
    -Ddebug="true"|"false"       Enable or disable System.err messages

Example 1

In this first example, Robocode is running the 'sample.battle' from the 'battles' directory without the display (GUI), and where the results are written out to the file named 'results.txt':

java -Xmx512M -Dsun.io.useCanonCaches=false -cp libs/robocode.jar robocode.Robocode
 -battle battles/sample.battle -nodisplay -results results.txt