Bonjour à tous !

Durant cette chaude (quoique) période de vacances, les membres du Site du Zéro se sont imaginés mettre en place des ateliers en rapport avec les sujet traités sur le site. Cependant, intégrer la partie plus scientifique semblait un véritable défi, jusqu'à ce que soit proposée, par Akio, une idée :

Le mahjong

Pour ceux qui ne connaitraient pas ce jeu, les règles en sont assez simples : il s'agit d'un jeu ou les pièces (on parle aussi de tuiles) se présentent par paires, qu'il faut reconstituer. Cependant, ces pièces sont empilées de différentes manières afin de former un "plateau". Une tuile ne peut être retirée que si elle ne dérange pas les autres pièces du jeu, on considère donc qu'une tuile peut être enlevée si il n'y a aucune pièce sur elle et à sa droite ou sa gauche. Par exemple, dans le plateau suivant,

Les pièces qui peuvent être déplacées sont les pièces avec le parasol ainsi que la pièce avec un œil, située sur le haut à droite de l'image. Vous l'aurez compris, on formera une paire avec les pièces représentant un parasol, ce qui libérera par la même occasion les autres pièces.

Cependant, afin d'ajouter une difficulté, au jeu, il a été décidé de développer différents mods de jeu : si la version originale emploie des tuiles identiques pour faire une paire, cette version implique la reconnaissance de tuiles complémentaires. Prenons par exemple le mod développé pour l'occasion : il se base sur la reconnaissance des symboles chimiques et de leur noms (après tout, le but de base était de proposer quelque chose qui soit plus orienté scientifique, mais rien n’empêche de choisir d'autres sujets). Le jeu comprend un chronomètre, afin de mesurer les performances.

Vous pouvez d'ores et déjà voir le jeu en action dans une implémentation de test située ici, il vous est même possible de tester et d'ajouter votre nom au palmarès

Objectifs

Le but de cet atelier est simple : dans le langage de votre choix (surprenez nous), il vous est proposé de créer

• Le jeu tel que décrit ci-dessus. Vous pouvez vous inspirer de ce qui a déjà été fait, mais attention ! Afin que tout le monde puisse essayer, il y a des règles à respecter concernant l'écriture/la lecture des modes de jeux, qui sont présentées plus bas, de même que pour l'écriture et la lecture des plateaux.
• Implémenter un éditeur de mods respectant les mêmes règles (ce qui à l'heure ou j'écrit ceci n'as jamais été fait).

Vous pouvez participer dans la catégorie que vous le désirez, voire même aux deux si vous êtes motivés.

Planning et règles

Cet atelier a lieu à partir d'aujourd'hui et jusqu'au 31 aout (il pourra être prolongé le cas échéant). Chacun est bien entendu invité à présenter sa création dans ce topic, néanmoins tout en respectant les règles suivantes :

• Vous devez respecter le format de fichier des mods, et ce afin que chacun puisse essayer les mods des autres, de même pour les plateaux. Le choix du langage est par contre totalement libre. L'imposition d'une telle règle permettra d'échanger les fichiers mods créés.
• En ce qui concerne la présentation des codes, ne les postez pas directement sur le topic, pour des raisons de lisibilité. Employez plutôt des services tels que github, pastebin, ... Ou autres. Mettez ensuite un lien vers celui-ci. Vous pouvez bien entendu agrémenter la présentation par l'une ou l'autre capture d'écran de l'implémentation en action. Si le langage le permet, vous pouvez même indiquer le lien vers votre création en action !
• Il est permis de travailler en équipe. Néanmoins, une personne ne peut pas participer dans plusieurs équipes.

À la fin de l'atelier, un compte rendu de l'ensemble des créations sera effectué, mais tout un chacun est invité à donner son avis sur les participations des autres zéros.

Bonne chance à tous et toutes

Les fichiers mods

Ces fichiers, si leur syntaxe est respectée, permetent à tous d'échanger des mods, ainsi que d'en créer de nouveaux. Si une idée vous passe par la tête, n'hésitez pas à la tester, ainsi qu'à la partager ici.

Ils seront écrits dans la syntaxe JSON. Si vous ne la connaissez pas, je vous invite à faire un tour sur la page Wikipédia de ce langage, ou sur le site de référence du langage. Ce langage a été choisi car moins "lourd" que le XML, tout en étant implémenté dans une grande variété de langage (PHP, C, C++, ...). Le fichier JSON contient 5 champs, qui sont tous obligatoires :

• "name" : le nom du mod
• "author" : son auteur
• "rules" : les règles s'y rapportant
• "pieces" : liste des pièces
• "associations" : la liste des associations possibles entre les pièces, les pièces étant présentées selon leur champ name (voir plus bas).

Chaque tuile (piece) sera défini par les trois paramètres suivants, obligatoires :

• "name" : le nom de la pièce, unique identifiant de celle-ci.
• "type" : indique si la pièce contient du texte ou une image, vaut donc "text" ou "image".
• "value" : ce qu'indique la pièce, en fonction de son type, indique le chemin de l'image ou le texte affiché par la pièce. Dans le cas ou il s'agit d'une image, sa taille doit être de 48x72 pixels.

Un fichier mod doit obligatoirement comprendre la définition de 144 pièces, afin de respecter les règles du mahjong original. Des paramètres supplémentaires (facultatifs) sont également possibles :

• "rotated" : indique si le contenu de la pièce doit être tourné de 90° ou non. Vaut donc true ou false. En l'absence de ce paramètre, le contenu ne doit pas être retourné.
• "information" : donne des informations supplémentaires sur ce que représente la pièce ou son contenu.
• "context" : deux pièces ayant le même context ne peuvent être associées ensemble pour former une paire, mais peuvent faire partie de la même association. Ce paramètre a été rajouter afin de tenir compte du fait que certaines pièces ne pouvaient logiquement pas être mises ensemble. Ainsi, par exemple, si un mod venait à faire l'association d'une pièce marquée "chat" et d'une image de chat, si plusieurs images de chats sont présentes, il faut plusieurs pièces marquées "chat" (elles font donc partie de la même association, puisque une pièce marquée "chat" peut être mise avec n'importe quelle image), mais il ne serait pas logique que pour former une paire, un utilisateur mettent ensemble deux pièces marquées "chat" : on donnera un context différent au pièces "chat" et aux images. L'absence de ce paramètre permet d'associer la pièce avec n'importe lesquelles (pour peux bien entendu qu'elles soient dans la même association).

Ces paramètres supplémentaires ne doivent pas obligatoirement être implémentés et sont laissés à l'apréciation de chacun.

Le champ value, si il est sous forme de texte, comprend une syntaxe basique de mise en forme largement inspirée de LaTeX et donc l'implémentation est une fois encore facultative (dans le cas contraire, il vous suffira de vous en débarrasser) :

• _{texte} indique que le texte sera en indice.
• ^{texte} indique que le texte sera en exposant.
• \n indique un retour à la ligne.
• \size(pourcent){texte} indique que le texte devra être à une taille de pourcent% par rapport au texte original.
• \color(couleur){texte} indique que le texte devra être écrit en couleur. Les couleurs sont décrites suivants leur nom (en anglais). Une liste des couleurs possibles est disponible ici, mais vous n'êtes pas obligé de toute les implémenter, les plus évidentes suffiront ("red", "green", "blue", "yellow", "orange", "black", "pink", "purple" et "white").

Un exemple de fichier mod est téléchargeable ici. Si vous avez des idées de mods, n'hésitez pas à les poster ici.

Les plus motivés d'entre vous peuvent même imaginer l'intégration d'un mode de difficulté supplémentaire : en effet, le jeu est plus complexe lorsqu'il est composé des paires en doubles (car il peut conduire à des situations ou plus aucune paire ne peut être formée). Ces dispositions entraînent alors des cas ou le plateau ne peut pas être résolu : il serait alors intéressant d'intégrer un système de comptage de points. Un exemple serait de mettre par exemple une partie à 10 000 point, qui ne vaudraient plus que 0 point après un certain laps de temps (disons 30 minutes), ces points décroieraient linéairement en fonction du temps. Lorsque quelqu'un remporterai le plateau, il gagnerai 100% des points à ce moment là. S'il n'avait réussi qu'à faire 40%, il gagnerai 40% des points au temps ou le jeu serai terminé. Ou bien plus diabolique, bien entendu 3:)

Les fichiers plateaux

Les fichiers de plateau sont écrits sous forme de texte. La première ligne de ceux ci donne le nom, la largeur et la hauteur du plateau, le tout séparé par des virgules et terminé par un point virgule. Vient ensuite la définition du plateau proprement dite : on le défini par "couche", chaque couche étant terminée par un point virgule. Chaque couche est constituée de largeur fois hauteur signes (les retours à la ligne ne comptent pas), indiquant la présence d'une pièce ainsi que sa position :

• . indique qu'il n'y en a pas.
• + indique la présence d'une pièce. Ainsi, pour un plateau de 2x2, le code +++.; serait rendu comme suit :
• % indique que la pièce doit être remontée d'une demi-case. Ainsi, toujours pour un plateau de 2x2, le code .+%+; serait rendu
• & indique que la pièce doit être décalée d'une demi case vers la gauche. Ainsi, pour le plateau 2x2, le code .&++; serait rendu
• # est un mix des deux précédente, donc décalée d'une demi-case vers le haut et la gauche.

Au total, un plateau doit contenir 144 emplacements qui ne soient pas des ., avec autant de couches que nécéssaire. Un exemple de fichier plateau est présenté ici (il s'agit de la forme dite tortue, un grand classique du mahjong). Cette syntaxe permet à peu près de se rendre compte de la forme finale du plateau une fois dessiné. Une fois encore, le but d'imposer une syntaxe est que tout un chacun puisse employer les plateaux des autres. Un certain nombre de plateaux ont par ailleurs déjà été écrit à cet usage, vous pouvez d'ailleurs les tester sur l'implémentation de test, et les télécharger dans le zip situé ici.

Le mot de la fin

L'atelier est ouvert à tout le monde quelque soit votre niveau, le but étant évidement de s'amuser.

Alors bon courage à tous

Participations

Mises à jour

• 5 aout : corrections orthographiques.
• 10 aout : ajout de détails concernant les couleurs comprises par le parseur, merci à alphadelta de l'avoir signalé.

-
Edité par Anonyme 10 août 2013 à 9:47:25