Merge pull request #70 from gnieark/dev

Dev
This commit is contained in:
Gnieark 2016-06-08 21:30:28 +02:00
commit b2b4998d14
4 changed files with 8 additions and 56 deletions

Binary file not shown.

View File

@ -1,48 +0,0 @@
<h2>Functioning of duels for battle four</h2>
<p>Your program does not have to manage a whole part of noughts and crosses, just one turn</p>
<h3>Connect four's grid</h3>
<ul>
<li>weight: 7 cases</li>
<li>height: 6 cases</li>
</ul>
</p>
<h3>Request Arena -> your bot</h3>
<p>The arbitrator program (the arena) builds a request with POST parameters as follow :</p>
<table class="tabledoc">
<tr><th>name</th><th>value</th></tr>
<tr>
<td>game</td>
<td>
String, always "connectFour".<br/>
Can be usefull if you use the same URL to play others games.
</td>
</tr>
<tr>
<td>match_id</td>
<td>
String. Match the following regular expression : ^[0-9]+-(1|2)$<br/>
The first number (digits before the hyphen) identifies the game.<br/>
The number after the hyphen indicates whether you are the first or second bot playing.<br/>
It will help you if your AI makes statistics on games.
</td>
</tr>
<tr><td>you</td><td>your symbol in the grid</td></tr>
<tr><td>grid</td><td>String, representing an array in JSON format. this is the grid.<br/>
the first seven values are the bottom horizontal line.<br/>
Exemple:<br/>
<pre>
[["","","","X","0","",""],
["","","","X","","",""],
["","","","","","",""],
["","","","","","",""],
["","","","","","",""],
["","","","","","",""]]
</pre>
</td></tr>
</table>
<h3>what your bot should respond</h3>
<p>only one char: 0,1,2,3,4,5 or 6 that indicates the column you want to play</p>

View File

@ -4,7 +4,7 @@
<li>largeur: 7 cases</li>
<li>hauteur: 6 cases</li>
</ul>
</p>
<h2>Communications entre l'arène et votre bot</h2>
<p>Pour communiquer, l'arène (le serveur hébergeant botsarena) fait des requetes http(s) de type POST vers les bots. Le message est dans le corps de la requête au format JSON.</p>
@ -42,7 +42,7 @@
</ul>
<h4>la map</h4>
<p>Elle est contenue dans le champs board du message JSON.C'est un tableau à deux dimmensions au format JSON vous indiquant l'état de la grille.<br/>
Exemple:<br/>
Exemple:</p>
<pre>
[["","","","X","0","",""],
["","","","X","","",""],

View File

@ -3,7 +3,7 @@
Do not trust the animated GIF of the site's home page.<br/>
It's the illustration of the overall operation of the arena, but it is wrong : the tictactoe only needs to send 10 variables to the bots.<br/>
The choice was therefore made to pass them by GET parameters and not by POST as shown in the animation.
</p>
<h2>requests from BotsArena to your bot</h2>
<p>To talk, botsarena (the server hosting botsarena) execute a POST request on your bot's http(s) server with the json as body</p>
<p>Your bot responds with a JSON array</p>
@ -170,14 +170,14 @@ X O X
DRAW
</pre>
<h2> Tools for developing and testing your bot </h2>
<p> To help you on how to manage communications between the bot and the arena, please take a look in the <a href = "https://github.com/gnieark/IAS/blob/master/stupidIATictactoe.php "> source PHP stupidIA </a>. <p>
<p> To help you on how to manage communications between the bot and the arena, please take a look in the <a href = "https://github.com/gnieark/IAS/blob/master/stupidIATictactoe.php "> source PHP stupidIA </a>.</p>
<h3> <a href="/testBotScripts/tictactoe.html"> Script Botsarena </a> </h3>
<p> This small html + javascript page will allow you to test and debug on your bot. <br/> It will allow you to test your boot via its URL, against himself, a human or stupidIA. <br/> Once ready, Express Sign your bot in the arena. </ p>
<p> By default, browsers do not allow javascript to make Cross domain queries. It is a browser security. So there are three options: </ p>
<ul> <li> You add to your bot <a href="https://www.qwant.com/?q=allow%20cross%20domain%20query%20http%20header&t=all"> headers than allow for CORS </a> field. </li>
<p> This small html + javascript page will allow you to test and debug on your bot. <br/> It will allow you to test your boot via its URL, against himself, a human or stupidIA. <br/> Once ready, Express Sign your bot in the arena. </p>
<p> By default, browsers do not allow javascript to make Cross domain queries. It is a browser security. So there are three options: </p>
<ul> <li> You add to your bot <a href="https://www.qwant.com/?q=allow%20cross%20domain%20query%20http%20header&t=all"> headers that allow cross POST queries</a></li>.
<li> More simple, you download the page (right click, save target as) and put it in your bot VHOST time tests. All the code (html, css and javascript) is included in the page without external resource, in order that it can be easily downloaded and used. </li>
<li> You use a web browser that supports JavaScript and allows cross domain queries. <a href="https://www.thepolyglotdeveloper.com/2014/08/bypass-cors-errors-testing-apis-locally/"> It seems possible </a>. </ li>
<li> You use a web browser that supports JavaScript and allows cross domain queries. <a href="https://www.thepolyglotdeveloper.com/2014/08/bypass-cors-errors-testing-apis-locally/"> It seems possible </a>. </li>
</ul>
<p> This problem does not arise at the arena once your bot will be registered. Because in that case, it is the requests to the bot, not a browser. </p>
<h3> <a href="https://github.com/moul/bolosseum"> Bolosseum </a> </h3>