doc/manual_fr.rdoc in UG_RRobots-1.3 vs doc/manual_fr.rdoc in UG_RRobots-2.0

- old
+ new

@@ -17,11 +17,11 @@ == Un exemple de script rudimentaire === il pourrait ressembler à ceci : -<code language="ruby"> +<code class="ruby"> require 'robot' class NervousDuck include Robot def tick events turn_radar 1 if time == 0 @@ -59,71 +59,36 @@ - *fire*(_power_) : lance un boulet de canon dans le sens de votre canon, la puissance va de 0,1 à 3 (plus la puissance est grande plus le temps de surchauffe est grand) - *turn*(_degrés_)* : tourne votre robot et donc votre canon et votre radar (max 10 degrés par tick) - *turn_gun*(_degres_) : tourne votre canon et donc votre radar (max 30 degrés par tick) - *turn_radar*(_degres_) : tourne votre radar (max 60 degrés par tick) - *dead* : renvoie vrai si vous êtes mort +- *drop_mine* : pose une mine sous le robot (une mine ne peut pas abimer le robot qui l'a posée) * *say*(_msg_) : affiche un message sur l'écran en mode GUI/TK au dessus de votre robot. -* *broadcast*(_msg_) : envoie un message à tous les robots sur le champs de bataille, une clef '*broadcast*' est ajouté au hachage '*events*' avec le message +* *broadcast*(_msg_) : envoie un message à tous les robots sur le champs de bataille, une clef '*broadcast*' est ajouté au hachage '*events*' avec le message et la direction +- *team_broadcast*(_msg_) envoie un message à tous les robots de votre equipe sur le champs de bataille, une clef '*team_broadcast*' est ajouté au hachage '*events*' avec le message et la direction Cette liste de méthode est volontairement réduite et basique, à la charge du joueur créer ses propres méthodes de haut niveau grace à la puissance de Ruby. (exemple : move_to, fire_at, etc...) === Quelques mots d'explication : - Le canon est monté sur le corps du robot, donc si vous bougez le robot le canon suit. Pareil pour le radar, qui se trouve sur le canon. -- Le radar scan tout se qui trouve sur le rayon de déplacement cumulé du robot, du canon et du radar lui même (mouvement relatif du radar) sur un '*tick*' donné, mais ne renvoi que la distance vers le/les objets scannés (clef *scanned_robots* avec la distance en valeur pour les robots, et clef scanned_toolboxes avec la distance en valeur pour les boites à outils) ceci fait donc un angles d'incertitude maximum de 100°, pour pouvoir être précis il faut bouger votre radar plus doucement. +- Le radar scan tout se qui trouve sur le rayon de déplacement cumulé du robot, du canon et du radar lui même (mouvement relatif du radar) sur un '*tick*' donné, mais ne renvoi que la distance vers le/les objets scannés (clef *robot_scanned* avec la distance en valeur pour les robots, clef toolbox_scanned avec la distance en valeur pour les boites à outils, clef *mine_scanned*) ceci fait donc un angles d'incertitude maximum de 100°, pour pouvoir être précis il faut bouger votre radar plus doucement. - UG RRobots Fork introduit les boites à outils, elle sont donc détectables par le radar, lorsqu'un robot passe sur l'une d'elle, il récupère des points d'energie (20 par défaut). Les boites à outils apparaissent de façon aléatoire et reste pour une durée définie ( 200 ticks par défaut), chaque tick elle ont la même chance (faible) d'apparaître (1 sur 100 par défaut) +Les mines déposables peuvent être détecté par les autres robots si il sont suffisamment près d'elle, et dans l'axe du radar (défaut 500 px) +Les mines sont destructible par l'abus du canon d'un robot de force > (par défaut 2). -UG RRobots Fork comme la version d'origine est implémenté en Ruby pur avec une Interface Graphique TK et peut tourner sur de nombreuses plateformes qui possèdent Ruby et TK, le moteur du jeu en lui même peu très bien se passer de TK. +UG RRobots Fork, comme la version d'origine, est implémenté en Ruby pur avec une Interface Graphique TK et peut tourner sur de nombreuses plateformes qui possèdent Ruby et TK, le moteur du jeu en lui même peu très bien se passer de TK. UG RRobots Fork à été testé sur Windows, la plus part des distributions Linux, FreeBSD et Windows -== Utilisation du moteur de match simple +== Utilisation des commandes -<pre> - ruby rrobots.rb [resolution] [#match] [-nogui] [-speed=<N>] [-timeout=<N>] [-with-toolboxes] <RobotClassName[.rb]> <RobotClassName[.rb]> <...> - - [resolution] (optionel) doit être de la forme 640x480 ou 800*600. - 800x800 par défaut - [match] (optionel) pour rejouer un match, préciser un numéro de match , avec le signe - # devant. - [-nogui] (optionel) lance le match sans GUI/TK, ignore -speed - [-with-toolboxes] (optionel) active l'apparition de boite à outils et leurs détections. - [-speed=<N>] (optionel, défaut 1) rafraîchit la GUI après N ticks. - Plus N est grand, plus le match s'affichera vite. - [-timeout=<N>] (optionel, defaut 50000) nombre de ticks maximum d'un match - [-ignore-config] (optional) pour ignorer la config au format YAML dan un fichier dans le path. - [-write-config] (optional) pour ecrire la config au format YAML dan un fichier dans le path. -</pre> - -* le fichier d'un robot doit avoir le même nom que la Classe du Robot -* (jusqu'à 8 robots) - -exemple : - - ruby rrobots.rb SittingDuck NervousDuck' - -ou - - ruby rrobots.rb 600x600 #1234567890 SittingDuck NervousDuck' - -== Utilisation du moteur de tournoi : - -Pas besoin de TK - -<pre> - ruby tournament.rb [-timeout=<N>] [-matches=<N>] (-dir=<Directory> | <RobotClassName[.rb]>+) - - [-timeout=<N>] (optionel, defaut 50000) nombre de ticks maximum d'un match - [-with-toolboxes] (optionel) active l'apparition de boite à outils et leurs détections. - [-matches=<N>] (optionel, defaut 2) nombre de rounds par match entre deux robots - -dir=<Directory> tout les fichiers .rb dans le répertoire seront considérents comme des robots concurents - [-ignore-config] (optional) pour ignorer la config au format YAML dan un fichier dans le path. -</pre> +:include:usage_fr.rdoc - le fichier d'un robot doit avoir le même nom que la Classe du Robot - les robots s'affrontes un contre un - les resultats son disponible au formats YAML et HTML \ No newline at end of file