How to submit a warrior, or a guide to e-mail sent to SAL.
Send bug reports to koth+bugs@sal.discontinuity.info.
Help text for e-mail messages
-----------------------------
The body of e-mail messages to the hill server should be in ASCII text
and consist of two parts:
[optional @commands]
[optional source code of a challenge]
where the syntax of @commands and the source code is described below.
E-mail should be sent to koth@sal.discontinuity.info.
The optional source code block contains the program you want to
challenge a hill, and has the form:
;redcode-HILLKEY
... redcode ...
end
Most pMARS ;declarations are understood in the source code. The
HILLKEY specifies the key of a hill that you want to challenge with
your program. The first block of ';' comments are interpreted
specially as directives to the server and can be used to describe your
warrior.
Help for ;declarations
----------------------
;redcode-HILLKEY Start of source code.
Starts the source of a warrior. Must be the first declaration.
;name WARRIORNAME
Gives the name of your warrior. WARRIORNAME may include only
non-control ASCII characters (octal range 040..176). The ;name of a
warrior may be given only once. The WARRIORNAME is visible in
hill reports.
;author AUTHORNAME
Gives the author name you want visible on hill reports. The ;author
of a warrior may be given only once. The AUTHORNAME is visible
in hill reports.
;strategy TEXT
...
;strategy TEXT
A multiline block of ;strategy declarations containing text
that describes the strategy of your warrior. The ;strategy lines
will be visible in hill reports.
;kill WARRIORNAME
Before submitting the warrior to the hill kill the warrior called
WARRIORNAME. You must be the person you submitted WARRIORNAME
to the hill in the first place before the killing is done.
NOTE WELL: Unlike other KOTH servers, WARRIORNAME must match exactly
with the name of the warrior you want killed. Regexp mathing
is not supported!
An alternative method of killing a warrior is with the @kill
command described below.
Help for @commands
-------------------
Parameters can be put in double quotes "like so". You can include a
double quote in a double-quoted parameter by escaping it with a
backslash like so: \". Literal backslashes in double quoted
parameters should be escaped too like so: \\.
@end Stop parsing e-mail message.
Stops parsing the e-mail message. Useful to stop the hill server
from trying to interpret your (or your ISP's) .sig as a command.
@help Print a help text.
Print this text.
@auth USERNAME PASSWORD Authenticate yourself.
The hill server must know who you are when you send e-mail commands
to it, or login to the www pages. Your commands are accepted if i)
they are sent from your e-mail address that is known to the hill
server, or ii) you provide a matching username and password.
@kill HILLKEY WARRIORNAME Kill a warrior.
Kill a warrior of yours from the hill named by HILLKEY and called
WARRIORNAME. WARRIORNAME shouldn't be put in double quotes
even if it does contain spaces. Note: you can only kill your own
warriors.
@change email=NEWEMAIL Change your email address.
Change your email address in the hill server. All hill reports are
sent to the address NEWEMAIL. Responses to your e-mail commands,
however are sent to the originator address of the e-mail. Your
e-mail address will not be divulged to others.
@change username=NEWUSERNAME
Change your username to NEWUSERNAME. NEWUSERNAME must consist only
of alphanumeric characters a-z, A-Z, and 0-9. Even though your
username is not divulged to others, anyone can find out what
warriors you have submitted to the hill server by clicking on the
"Author" link of one of your warriors.
@change password=NEWPASSWORD Change your password.
Change your password to NEWPASSWORD. NEWPASSWORD must consist only
of alphanumeric characters a-z, A-Z, and 0-9. Your password is not
divulged to others.
@change verbosity=NEWVERBOSITY Change your verbosity level
Change your verbosity level to NEWVERBOSITY, one of:
quiet The hill server never sends you hill reports,
except for your own challenges.
normal The hill server sends you hill reports only when
a warrior successfully challenges a hill with
at least one of your warriors on it.
verbose You get hill reports for every challenge to
a hill with at least one of your warriors on it.
Your default verbosity level is 'verbose'. Note that unlike other
KOTH servers, verbosity is a per-player setting, not a per-warrior
setting.
End of Help