IA War

L'idée est de créer une IA qui va se battre contre tous les autres IA des autres joueurs.

Le principe du jeu est simple : trouver la sortie placée au hasard sur une map de nxn pixels

Les IAs seront affectées à des équipes au lancement du jeu. Le jeu s'arrête une fois que tous les joueurs d'une équipe ont trouvés la sortie

Sur la map, se trouvent des bouts de murs qui vous empecherons d'avancer. Si vous tentez de vous déplacer sur un mur, l'action sera nulle et rien ne se passera.

Déroulement du jeu

A chaque tour, le jeu demandera à votre IA (et celles de tous les autres joueurs) ce qu'elle veut faire à ce tour.

Votre IA pourra répondre l'une de ces deux actions :

move
ask
teleport

D'un côté plus technique, le jeu appellera la méthode action de votre IA et votre IA devra retourner un objet qui contient les clés action (l'identifiant de l'action que vous voulez réaliser) et params les paramètres de l'action.

La méthode principale que vous devrez implémenter ressemblera à ça :

{
    action: function action(position, round, walls) {
        //à vous de gérer la logique de décision

        return actionObject; //l'objet qui contient l'action que vous voulez exécuter
    }
}

A chaque appel de action sont passés en paramètres :

position {Object} votre position actuelle ;
round {Number} le numéro du tour en cours.

action `move`

l'action move permet de vous déplacer sur la map. Voila l'objet que le jeu attendra de votre part si vous voulez exécuter l'action move :

{
    action: "move",
    params: {
        dx: 0, //1 mouvement positif, -1 mouvement négatif, 0 aucun mouvement sur cet axe
        dy: 0
    }
}

les paramètres dx et dy définissent si vous voulez vous déplacer dans le sens positif ou négatif selon l'axe x ou y. Le joueur ne peux que se déplacer que d'une case à la fois, donc mettre une valeur de 10 par exemple ne fera pas avancer plus votre joueur. Le jeu regarde uniquement si la valeur retournée est positive, négative ou nulle.

Attention, si vous essayez de vous déplacer sur un mur, l'action de déplacement sera nulle et rien ne se passera.

action `ask`

Vous pouvez demander au jeu où vous vous trouvez par rapport à la sortie. Vous ne pouvez demander où vous êtes que selon un axe unique (x ou y)

Pour demander où vous êtes par rapport à la sortie, voila l'objet que le jeu attendra :

{
    action: "ask",
    params: "x" //ou y
}

Suite à ça le jeu vous répondra en appelant une méthode de votre IA. Suivant l'axe sur lequel vous lui posez la question il appelera onResponseX ou onResponseY

{
    //...
    onResponseX: function onResponseX(position) {
        // à vous d'enregistrer cette information pour vous en servir au prochain tour
    }
}

action `teleport`

Vous pouvez vous téléporter à n'importe quel endroit de la map (à condition que ça soit dans les limites de la map bien sur). Pour cela, vous pouvez demander à faire l'action teleport. En paramètres, vous aurez à donner la position en x et y à laquelle vous voulez vous téléporter.

⚠ Vous ne pourrez utiliser l'action teleport qu'une fois. Au delà chaque appel à teleport ne fera plus rien.

Exemple :

{
    action: "teleport",
    params: {
        x: x,
        y: y
    }
}

Soyez à l'écoute

Petite astuce, quand l'une des IA de votre équipe trouve la sortie, toutes les autres IA de l'équipe sont avertie de la position de la sortie. Concrètement, quand l'un de vos alliés gagne, le jeu appel la méthode onFriendWins de votre IA. C'est donc à vous de stocker cette information pour tous rusher vers la sortie et ainsi faire gagner l'équipe.

un exemple d'implémentation serait :

{
    onFriendWins: function storeExit(exit /* = { x: .., y: .. }*/) {
        //garder en mémoire la position de la sortie
    }
}

Attention aux erreurs

Le jeu compte les erreurs que vous faites. Parmis les erreurs, le jeu compte :

les exceptions qui sont jettées par votre code ;
les actions appelées avec les mauvais paramètres (par exemple un appel à teleport sans paramètre x) ;
les mouvements (move et teleport) en dehors de la carte qui seront demandés (eg. demander à avancer de 1 alors qu'on est en bout de carte).

Dans tous les cas, une erreur va paralyser votre joueur pour le tour en cours.

Wrapping up

Vous trouverez un exemple d'archi d'IA à ce chemin src/bots/felix.ia.js. Inspirez vous en pour développer votre IA.

Vous pouvez ajouter autant d'IA que vous voudrez dans le repertoire src/bots ils seront ajoutés dans le jeux. En revanche, une seule de ces IA pourra jouer pour le match final.

Les main dans le code

⚠ nécessite Node.js

Installation

Vous aurez besoin de quelques outils avant de pouvoir commencer à coder votre IA. Pour les installer, jouer simplement :

npm install

à la racine du projet.

Compilation des sources

Les sources du jeu sont écrite en utilisant une syntaxe ES6, pour être complétement sûr de la compatibilité du code, on va utiliser un transpileur pour le convertir en ES5. Pour compiler le code du jeu + celui de votre IA :

npm run build

Pour ne pas avoir à faire ça à chaque fois que vous faites une modification sur votre IA, pour pouvez lancer la commande :

npm run watch

qui compilera automatiquement les sources dès qu'il y a un changement dessus.

Tester votre IA

Pour tester votre IA, vous n'aurez qu'à lancer le jeu en ouvrant le fichier index.html à la racine du projet.

Amusez vous, entraidez vous

Contributeur

Pseudo	Contribution	Licence
atomrc	Créateur	Licence
paul604	Bot: paul - paul_ligne - paul_diago - teleport	Licence.paul.md

paul604/IA-War