.
This commit is contained in:
parent
bed06591c9
commit
edf836eb37
|
|
@ -262,329 +262,8 @@ Ainsi, vous pouvez pousser le délire jusqu'à faire un algorythme qui s'adapte
|
|||
</ul>
|
||||
|
||||
|
||||
<h2>Exemple de partie</h2>
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"init","game":"tictactoe","players":2,"board":"","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"name":"moul-tictactoe"}
|
||||
</pre>
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"init","game":"tictactoe","players":2,"board":"","player-index":1}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"name":"moul-tictactoe"}
|
||||
</pre>
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"","0-1":"","0-2":"","1-0":"","1-1":"","1-2":"","2-0":"","2-1":"","2-2":""},"you":"X","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"0-1"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 1 joue en 0-1 la nouvelle grille est
|
||||
X
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"","0-1":"X","0-2":"","1-0":"","1-1":"","1-2":"","2-0":"","2-1":"","2-2":""},"you":"O","player-index":1}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"1-1"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 2 joue en 1-1 la nouvelle grille est
|
||||
X
|
||||
O
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"","0-1":"X","0-2":"","1-0":"","1-1":"O","1-2":"","2-0":"","2-1":"","2-2":""},"you":"X","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"0-0"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 1 joue en 0-0 la nouvelle grille est
|
||||
X X
|
||||
O
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"","1-0":"","1-1":"O","1-2":"","2-0":"","2-1":"","2-2":""},"you":"O","player-index":1}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"0-2"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 2 joue en 0-2 la nouvelle grille est
|
||||
X X O
|
||||
O
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"O","1-0":"","1-1":"O","1-2":"","2-0":"","2-1":"","2-2":""},"you":"X","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"2-0"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 1 joue en 2-0 la nouvelle grille est
|
||||
X X O
|
||||
O
|
||||
X
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"O","1-0":"","1-1":"O","1-2":"","2-0":"X","2-1":"","2-2":""},"you":"O","player-index":1}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"1-0"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 2 joue en 1-0 la nouvelle grille est
|
||||
X X O
|
||||
O O
|
||||
X
|
||||
</pre>
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"O","1-0":"O","1-1":"O","1-2":"","2-0":"X","2-1":"","2-2":""},"you":"X","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"1-2"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 1 joue en 1-2 la nouvelle grille est
|
||||
X X O
|
||||
O O X
|
||||
X
|
||||
</pre>
|
||||
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"O","1-0":"O","1-1":"O","1-2":"X","2-0":"X","2-1":"","2-2":""},"you":"O","player-index":1}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"2-1"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 2 joue en 2-1 la nouvelle grille est
|
||||
X X O
|
||||
O O X
|
||||
X O
|
||||
</pre>
|
||||
<pre class="arrenaMessage">
|
||||
{"game-id":"1126","action":"play-turn","game":"tictactoe","players":2,"board":{"0-0":"X","0-1":"X","0-2":"O","1-0":"O","1-1":"O","1-2":"X","2-0":"X","2-1":"O","2-2":""},"you":"X","player-index":0}
|
||||
</pre>
|
||||
<pre class="botResponse">
|
||||
{"play":"2-2"}
|
||||
</pre>
|
||||
<pre>
|
||||
Player 1 joue en 2-2 la nouvelle grille est
|
||||
X X O
|
||||
O O X
|
||||
X O X
|
||||
|
||||
Match nul
|
||||
</pre>
|
||||
|
||||
<h2>Outils pour développer et tester votre bot</h2>
|
||||
<p>Afin de vous aider sur la façon de gérer les communications entre le bot et l'arène, n'hésitez pas à jeter un coup d'oeil dans le <a href="https://github.com/gnieark/IAS/blob/master/stupidIATictactoe.php">code source PHP de stupidIA</a>.<p>
|
||||
|
||||
<h3><a href="/testBotScripts/tictactoe.html">Script Botsarena</a></h3>
|
||||
<p>Cette petite page html+javascript vous permettra de tester et débogguer votre bot.<br/> Elle vous permettra de tester votre boot via son url, contre lui même, un humain ou stupidIA.<br/> Une fois prêt, vous l'inscrirez dans l'arène.</p>
|
||||
<p> Par défaut, les navigateurs ne permettent pas en javascript de faire des requettes Cross domaine. C'est une sécurité du navigateur. Il y a donc trois possibilités:</p>
|
||||
<ul><li>Vous ajoutez à votre bot les <a href="https://www.qwant.com/?q=allow%20cross%20domain%20query%20http%20header&t=all">headers permettant les requettes de type POST provenant d'un autre domaine</a>.</li>
|
||||
<li>Plus simple, vous téléchargez la page (click droit, enregistrer la cible du lien sous)et la mettez dans le VHOST de votre bot le temps des tests. Tout son code (html, css et javascript) est inclus dans la page sans ressource externe, dans le but qu'elle puisse etre facilement téléchargée et utilisable.</li>
|
||||
<li>Vous utilisez un navigateur web qui supporte le javascript et permet les requetes cross domain. <a href="https://www.thepolyglotdeveloper.com/2014/08/bypass-cors-errors-testing-apis-locally/">Ça semble possible</a>.</li>
|
||||
</ul>
|
||||
<p>Ce problème ne se posera pas au niveau de l'arène une fois que votre bot sera inscrit. Car dans ce cas, c'est le serveur qui fait les requetes vers les bots, pas un navigateur web.</p>
|
||||
<h3><a href="https://github.com/moul/bolosseum">Bolosseum</a></h3>
|
||||
<p>Vous trouverez des outils en ligne de commande pour tester et déboguer votre bot sur le projet github Bolosseum de @moul.</p>
|
||||
<h3>Script Botsarena en cours de développement</h3>
|
||||
<h2>Faire entrer votre bot dans cette arène</h2>
|
||||
<p>Le formulaire d'inscription de votre bot est sur la page d'accueil du site.</p>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<p>
|
||||
La bataille navale se joue en deux phases :
|
||||
</p>
|
||||
<ul>
|
||||
<li>Placement des bateaux sur les maps</li>
|
||||
<li>Echange de tirs</li>
|
||||
</ul>
|
||||
<p>
|
||||
A chaque tour de jeu l'arène fait des requetes http(s) contenant des paramètres de type POST, vers vos bots.<br/>
|
||||
Ces derniers doivent répondre selon les spécifications ci dessous.
|
||||
</p>
|
||||
<h2>Descriptif des paramètres envoyés par l'arène</h2>
|
||||
<table class="tabledoc">
|
||||
<tr>
|
||||
<th>Paramètre</th>
|
||||
<th>Description</th>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>game</td>
|
||||
<td>
|
||||
Chaîne de caractères, sera toujours "Battleship".<br/>
|
||||
Peut servir si votre url sert à plusieurs jeux.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>match_id</td>
|
||||
<td>
|
||||
Chaîne de caractères. Répond à l'expression régulière suivante: ^[0-9]+-(1|2)$<br/>
|
||||
Le premier nombre (digits avant le tiret) identifie le match.<br/>
|
||||
Le numéro après le tiret vous indique si vous êtes le bot 1 ou le bot 2 dans l'ordre de jeu.<br/>
|
||||
Ça vous servira si votre IA fait des statistiques sur les matchs.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>act</td>
|
||||
<td>
|
||||
Peut prendre deux valeurs :<br/>
|
||||
<ul>
|
||||
<li>"init" : On démarre la partie, vous devez placer vos bateaux</li>
|
||||
<li>"fight" : Vous envoyez un tir</li>
|
||||
</ul>
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>opponent</td>
|
||||
<td>
|
||||
Chaîne de caractères identifiant votre adversaire.<br/>
|
||||
Ainsi, vous pouvez pousser le délire jusqu'à faire un algorythme qui s'adapte en fonction de l'adversaire et de l'historique des combats avec ce dernier.
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>width</td>
|
||||
<td>Entier, compris entre 1 et 100, bornes incluses, vous indique la largeur de la map.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>height</td>
|
||||
<td>Entier, compris entre 1 et 100, bornes incluses, vous indique la hauteur de la map.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>ship1</td>
|
||||
<td>Entier, compris entre 0 et 10, bornes incluses, vous indique le nombre de bateaux de longeur 1 case à placer.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>ship2</td>
|
||||
<td>Entier, compris entre 0 et 10, bornes incluses, vous indique le nombre de bateaux de longeur 2 cases à placer.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>...</td>
|
||||
<td>...</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>ship6</td>
|
||||
<td>Entier, compris entre 0 et 10, bornes incluses, vous indique le nombre de bateaux de longeur 6 cases à placer.</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>your_strikes</td>
|
||||
<td>
|
||||
<p>
|
||||
|
||||
</td>
|
||||
</tr>
|
||||
<tr>
|
||||
<td>his_strikes</td>
|
||||
<td>Idem sauf qu'il s'agit du tir de l'adversaire.</td>
|
||||
</tr>
|
||||
</table>
|
||||
<h2>Ce que doit retourner votre bot</h2>
|
||||
<h3>Lors de l'initialisation de la partie</h3>
|
||||
<p>
|
||||
Lors de l'initialisation d'une partie StupidIA VS StupidsIA, l'arène a envoyé au bot les parametres POST suivants :
|
||||
</p>
|
||||
<pre>
|
||||
game=Battleship&match_id=828-1&act=init&opponent=stupidIA&width=10&height=10&ship1=0&ship2=1&ship3=2&ship4=1&ship5=1&ship6=0
|
||||
</pre>
|
||||
<p>
|
||||
Soit, sous forme plus lisible :
|
||||
</p>
|
||||
<pre>
|
||||
[game] => Battleship
|
||||
[match_id] => 828-1
|
||||
[act] => init
|
||||
[opponent] => stupidIA
|
||||
[width] => 10
|
||||
[height] => 10
|
||||
[ship1] => 0
|
||||
[ship2] => 1
|
||||
[ship3] => 2
|
||||
[ship4] => 1
|
||||
[ship5] => 1
|
||||
[ship6] => 0
|
||||
</pre>
|
||||
<p>
|
||||
La page http que doit générer votre bot contient la position des navires.
|
||||
</p>
|
||||
<p>
|
||||
Vous retournez une chaine de caractères qui est un tableau JSON ayant autant d'enregistrements que de navires.<br/>
|
||||
Chaque navire est défini par les coordonnées de ses extrémités.
|
||||
</p>
|
||||
|
||||
<h3>Lors du combat</h3>
|
||||
<p>
|
||||
Voici quelques exemples des parametres envoyés par l'arène.
|
||||
</p>
|
||||
<h4>Premier tour de jeu (your_strikes et his_strikes sont vides)</h4>
|
||||
<pre>
|
||||
[game] => Battleship
|
||||
[match_id] => 834-1
|
||||
[act] => fight
|
||||
[opponent] => stupidIA
|
||||
[width] => 10
|
||||
[height] => 10
|
||||
[ship1] => 0
|
||||
[ship2] => 1
|
||||
[ship3] => 2
|
||||
[ship4] => 1
|
||||
[ship5] => 1
|
||||
[ship6] => 0
|
||||
[your_strikes] => []
|
||||
[his_strikes] => []
|
||||
</pre>
|
||||
<h4>Deuxième tour de jeu</h4>
|
||||
<pre>
|
||||
[game] => Battleship
|
||||
[match_id] => 834-1
|
||||
[act] => fight
|
||||
[opponent] => stupidIA
|
||||
[width] => 10
|
||||
[height] => 10
|
||||
[ship1] => 0
|
||||
[ship2] => 1
|
||||
[ship3] => 2
|
||||
[ship4] => 1
|
||||
[ship5] => 1
|
||||
[ship6] => 0
|
||||
[your_strikes] => [{"target":"4,6","result":""}]
|
||||
[his_strikes] => [{"target":"7,8","result":""}]
|
||||
</pre>
|
||||
<h4>Troisième tour de jeu</h4>
|
||||
<pre>
|
||||
[game] => Battleship
|
||||
[match_id] => 834-1
|
||||
[act] => fight
|
||||
[opponent] => stupidIA
|
||||
[width] => 10
|
||||
[height] => 10
|
||||
[ship1] => 0
|
||||
[ship2] => 1
|
||||
[ship3] => 2
|
||||
[ship4] => 1
|
||||
[ship5] => 1
|
||||
[ship6] => 0
|
||||
[your_strikes] => [{"target":"4,6","result":""},{"target":"3,9","result":"hit"}]
|
||||
[his_strikes] => [{"target":"7,8","result":""},{"target":"7,8","result":""}]
|
||||
</pre>
|
||||
<h4>Vous devez tout simplement retourner l'adresse de la case sur laquelle vous souhaitez tirer sous forme de x,y</h4>
|
||||
<pre>
|
||||
6,9
|
||||
</pre>
|
||||
<p>
|
||||
Pour tirer aux coordonnées x=6 y=9
|
||||
</p>
|
||||
<p>Le formulaire d'inscription de votre bot est sur la page d'accueil du site.</p>
|
||||
Loading…
Reference in New Issue
Block a user