All C++Robots commands are executed via an eMail message send to <c++robots@gamerz.net>.  The SUBJECT line of your message instructs the server what you want done.  Response time is usually very quick, and you should always get a response (unless something goes horribly wrong).   If the server does not respond to a command, please try the 'help' command to see if the system is responding at all.  If all else fails, contact <rrognlie@gamerz.net>, C++Robots creator/janitor.

C++Robots Recognized Commands

help

This sends the generic C++Robots help file.

help C++Robots.FAQ

This sends a copy of the C++Robots FAQ.

standings

This gives a list of all programs on the hill along with their scores.

challenge program-name robot-1 [ ... robot-N ]

Challenge one or more robots on the hill to a single free-for-all Battle. The results of a "trace" of this battle will be mailed back to you. This battle does not count towards any robot's standings on the hill.

C++Robots will expect your code to be bracketed by a 'BEGIN' and 'END' line. If no 'BEGIN' line is found, the start of the mail message will be used as the start of the program. If no 'END' line is found, and a line that looks like a .sig is found (e.g. '--'), that line will be used as the end. If no 'END' and no '--' are found, the end of the mail message will mark the end of the program.

program program-name password

Attempt to place a new program on the hill. The body of your mail message is assumed to contain the C++ code for a robot control program. 

C++Robots will expect your code to be bracketed by a 'BEGIN' and 'END' line. If no 'BEGIN' line is found, the start of the mail message will be used as the start of the program. If no 'END' line is found, and a line that looks like a .sig is found (e.g. '--'), that line will be used as the end. If no 'END' and no '--' are found, the end of the mail message will mark the end of the program.

The 'BEGIN' line is also where any C++Robots options are set. Currently, those options are:

source/nosource default: nosource

specifies whether your source code is visible to other C++Robots users.

quiet/normal/verbose default: normal

specifies when you will receive hill standings updates. Quiet notifies you only when your program is initially submitted, and when your program is bumped from the hill. Normal notifies you when your program is submitted, and anytime its position changes.  Verbose notifies you evertime a program makes it on the hill, regardless of whether it affects your position on the hill.

Any comments found between the start of the mail message and the start of the program will be assumed to be comments that will be returned to people who request the 'info' for that program.

info [ program-name-1 ... program-name-N ]

Get the "info" for each of the named programs. If no program names are specified, the info for all programs on the hill will be returned.

source [ program-name-1 ... program-name-N ]

Get the source listing for each of the named programs. If no program names are specified, the source for all programs on the hill will be returned. Note: The only source returned is source for those programs submitted by you *or* the were submitted with the 'source' option set.

delete program-name password

Delete one of your robots from the hill.