X-Git-Url: https://git.ucc.asn.au/?a=blobdiff_plain;f=doc%2FUNSUPPORTED.txt;h=fb73fca055edc0f079080506bd18ee72cf446b92;hb=99e58b5bf2cf64614798aaa41059433ce2cf1b99;hp=02317e8c1b3a1f6a8733816bd29bd107ceabef8a;hpb=9de8fe1e1b7f8148cbaf850c5fa8dd1082f2353a;p=progcomp10.git

diff --git a/doc/UNSUPPORTED.txt b/doc/UNSUPPORTED.txt
index 02317e8..fb73fca 100644
--- a/doc/UNSUPPORTED.txt
+++ b/doc/UNSUPPORTED.txt
@@ -1,4 +1,38 @@
-UNSUPPORTED.txt: You should not need this file.
+UNSUPPORTED.txt: This file describes the wire protocol. You should only need this if you're debugging an external agent, or if you're interested in writing an agent in an unsupported language.
 
-Consult the website.
-FIXME: more info?
\ No newline at end of file
+If you are interested in using an unsupported language, consult the website for details on how to check with the organiser first.
+
+=== Wire protocol ===
+
+The syntax for input and output is as follows. Every line of input given by the supervisor must be replied with the correct response.
+Segmentation fault is never the correct response :-). Rumour has it that if you just use Python, this won't happen. 
+
+The angle brackets (<>) indicate whether the line is output from the agent or input to it respectively, and are not part of the actual formatting.
+
+Syntax for when your agent is spawned:
+>HI uuid
+
+Syntax for an attacking agent:
+>ATTACK foeName
+<ATTACKING itemToUse itemToPromise
+Example:
+>ATTACK agent00002
+<ATTACKING Paper Scissors
+
+Syntax for a defending agent:
+>DEFEND foeName foePromisedItem
+<DEFENDING itemUsed
+Example:
+>DEFEND agent00001 Scissors
+<DEFENDING Rock
+
+Syntax for collecting results:
+>RESULTS foeName isInstigatedByYou winner yourItem theirItem promisedItem pointChange
+<OK
+Example:
+>RESULTS agent00001 False Attacker Rock Paper Scissors -2
+<OK
+
+Syntax for cleaning up after your bot - either the round has ended, or you've been killed off
+>BYE
+{program exits without responding}
\ No newline at end of file