web/index.html

   1 <html>
   2 <head>
   3   <title>Stratego Based Programming Competition</title>
   4 </head>
   5
   6 <body>
   7
   8 <h1> Quick Details</h1>
   9 <h2> git </h2>
  10 <p> The git repository is listed on <a href="http://git.ucc.asn.au/"/>The UCC git page</a> as "progcomp2012.git" </p>
  11 <p> <a href="http://git.ucc.asn.au/?p=progcomp2012.git;a=summary"/>Direct Link Here</a></p>
  12
  13 <h2> Mailing List </h2>
  14 <p> We will use the same mailing list as last year (progcomp). </p>
  15
  16 <h2> irc channel </h2>
  17 <p> There is a #progcomp irc channel on the ucc irc server (irc.ucc.asn.au) where you can ask questions or help with setting things up. </p>
  18
  19 <h2> Programming Competition VM </h2>
  20 <p> I am in the process of learning how to set up a VM for this competition. Please be patient. </p>
  21
  22 <h1> Stratego </h1>
  23 <p> <a href="http://www.edcollins.com/stratego/"/>This site</a> explains what Stratego is. </p>
  24
  25 <p> Short Version: It is a board game in which all pieces have a value that is, initially, unknown to the opponent player. The objective is to destroy all enemy pieces, or capture the enemy "Flag". Pieces with higher values destroy pieces with lower values. There are several special pieces/rules. </p>
  26
  27
  28 <h1> Programming Competition </h1>
  29 <p> Create an AI to play Stratego. </p>
  30 <p> Programs are written independently and interface through stdin/stdout with a manager program, which queries them on setup and moves. </p>
  31
  32 <h3> The Manager Program </h3>
  33 <p> The manager program provides the protocol for two seperate AI to play a game of stratego. It has the imaginative name of 'stratego', but I will probably refer to it as 'the manager program' or 'stratego' with absolutely no consistency. </p>
  34 <p> It also aims to assist with AI design by providing options for graphical or terminal output and saving/reading games from files </p>
  35 <p> </p>
  36 <p> Human players are also supported, although the interface is minimal, as this feature is meant for testing. </p>
  37 <p> If you just want to play a game, without having to write your own AI, try <a href="http://www.probe.imersatz.com/"/>Probe</a> </p>
  38
  39 <h4> Screenshot </h4>
  40 <img border="0" src="screenshot.png" alt="Graphical output of 'stratego' manager program." title="Graphical output of 'stratego' manager program. Options '-g' for graphics and '-b' to hide Blue pieces that have not taken part in combat yet. Red and Blue are both linked to the 'asmodeus' AI. Taken with scrot on 7/12/11." width="327" height="344" />
  41
  42 <h3> Protocol </h3>
  43 <p> For the sake of simplicity and keeping things in one place, the protocol is now entirely described in the <a href="doc/manager_manual.txt"/>manual page</a> of the manager program. All updates to the protocol will be reflected in that file. </p>
  44
  45
  46 <p> <b> Warning:</b> The accuracy of the above file depends on how recently I pulled it from git. To ensure you get the latest version, find it under "web/doc/manager_manual.txt" in the <a href="http://git.ucc.asn.au/?p=progcomp2012.git;a=summary"/>git repository</a> </p>
  47
  48 <p> <b> Another Warning:</b> AI programs <b>must</b> unbuffer stdin and stdout themselves. This is explained in the manual page, but I figured no one would read it. It is fairly simple to unbuffer stdin/stdout in C/C++ and python, I have not investigated other languages yet. </p>
  49
  50 <h2> Long Term Scoring </h2>
  51 <p> <b> WARNING: Work in progress </b> </p>
  52 <p> It is currently planned to store all the AIs on a virtual machine, and periodically run a script to play a round robin </p>
  53 <p> The scores for each round and the total scores will be recorded from the start to the end of the competition. </p>
  54 <p> The competition will run over a period of weeks (depending on general enthusiasm...), and competitors will be able to alter their programs except during the periods in which the script is running. </p>
  55 <p> The following categories will be used when determining the final winners:</p>
  56 <p> <ol>
  57         <li> Total score</li>
  58         <li> Number of rounds won</li>
  59         </ol> </p>
  60
  61 <h2> Sample AI Programs </h2>
  62 <p> <b> WARNING: Work in progress </b> </p>
  63 <p> The following sample programs are currently available (and in a working state - refer to the git repository): </p>
  64 <table border="0">
  65 <tr> <th>Name</th> <th>Language</th> <th> Moves </th> <th> Considers... </th> </tr>
  66 <tr> <td>basic_python</td> <td>Python</td> <td>Randomised</td> </tr>
  67 <tr> <td>basic_cpp</td> <td>C++</td> <td>Randomised</td> </tr>
  68 <tr> <td>asmodeus</td> <td>Python</td> <td>Scored</td> <td>Path finding, known combat results, piece values</td> </th>
  69 </table>
  70 <p> It is planned to implement the equivelants of these samples in C++ and Python at least, possibly other languages later. </p>
  71
  72 <h2> Submissions </h2>
  73 <p> We (I?) are now accepting test submissions. </p>
  74 <p> You must submit the full source code, and build instructions or makefile(s) for your program. </p>
  75 <p> Also include the name of the executable or script, the name of the AI, your name, and optionally a description of your AI and its tactics. </p>
  76 <p> Please email matches@ if you have a submission. </p>
  77
  78 <h2> Dates </h2>
  79 <p> The competition will run in 2012. The exact dates have not been determined. I will consider whether it is worth waiting until freshers have a chance to make submissions March/April, or running the competition earlier in January/February. </p>
  80
  81 <h2> Involvement </h2>
  82 <p> If you want to help set up the competition, email matches@ </p>
  83 <p> There isn't much left to do, but all help is appreciated. Maybe you can suggest something, and volunteer to implement it! </p>
  84 <p> The most useful thing you can do is actually write an AI, and test the manager program. Please report any bugs (in the manager program, not in your AI!) to matches@ (you can feel free to fix them, but won't be able to push unless you email matches). </p>
  85
  86 <p> <b>Last webpage update: 20/12/11</b></p>
  87 </body>
  88
  89 </html>