Sur ce dépôt git, nous allons stocker les sauvegardes et captures d'écran de notre première partie de Pokémon Jaune, suivant les idées présentées dans ce projet "GBA-RPG-via-GitHub-contre-Covid-2020".

Auteur : Lilian Besson (@Naereen), inspiré librement par Twitch plays Pokémon. Regardez le premier projet sur Pokémon.

Venez discuter sur ce serveur Discord ! Dans le canal "Fire Emblem".

Il faut suivre les instructions suivantes :

1. Créer un compte GitHub, ajouter une étoile au projet (ou au méta projet). Je vous invite à devenir membre de l'organisation, puis il vous faut éditer ce fichier sans faire de fusio-demande (= pull request).

2. Télécharger un émulateur, je recommande mGBA ou Visual Boy Advance, sur un ordinateur et pas un téléphone,

3. Télécharger la ROM, vérifier que c'est la bonne en vérifiant sa somme md5sum, son nombre de bits (et les informations renvoyées par file Fire_Emblem_Europe.gba dans un terminal sous GNU/Linux). Regarder ce ticket si vous avez du mal à télécharger la ROM.

4. Cloner le dépôt, et vérifier que vous pouvez lancer le jeu, et charger la sauvegarde. Vérifier que vous pouvez sauvegarder, puis ensuite prenez l'habitude de lancer une session de jeu avec make play, qui automatise l'algorithme de gestion de conflit de jeux (cf. explications ci-dessous).

5. Si vous n'avez jamais joué à un jeu de la série des Fire Emblem, je vous encourage à faire le tutoriel (cf. ce ticket) ou à regarder la vidéo suivante que j'ai enregistrée et ajoutée sur YouTube pour montrer le tutoriel :

Une fois le dépôt cloné, si vous êtes sous GNU/Linux ou Mac OS, le fichier Makefile donne quelques commandes pour automatiser certaines choses

• make metadata permet de vérifier que la ROM Fire_Emblem_Europe.gba téléchargée est la bonne ;
• make start_playing permet de commencer à jouer avec mGBA,
• make play automatise l'algorithme de gestion de jeu :
  1. vérifier que personne n'est en train de jouer (avec make check_free_slot),
  2. écrire et envoyer un commit disant que le joueur actuel est en train de jouer (ie, un commit dont le message commence par "START user ...") (avec make commit_start),
  3. lance mGBA sur la sauvegarde actuelle (avec make start_playing),
  4. quand mGBA se ferme, ajoute dans un commit git la nouvelle sauvegarde, et les captures d'écran, et envoie un commit de fin de session (ie, un commit dont le message commence par "DONE user ..."_) (avec make commit_done).

Il faut regarder l'auteur du dernier commit, qui a commencé sa session de jeu avec un commit dont le message commence par "START ...".

Personne ne joue actuellement.

La ligne précédente est normalement mise à jour automatiquement.

• Il n'y a pas et il n'y aura pas de mécanisme de file d'attente : dès que le joueur courant arrête, c'est-à-dire qu'elle a terminé sa session de jeu (avec un commit dont le message commence par "END ..."), n'importe qui peut venir jouer et prendre le relai !

• Essayez de gérer cela intelligemment, et ne soyez pas trop pressé : si vous vous abonnez au flux RSS du projet, vous pouvez recevoir des notifications ou des mails quand un joueur commence et termine sa session.

  Moi je vais le faire, au moins au début, pour vérifier que le projet ne part pas en cacahuètes.

• Donc je me répète : pas de mécanisme de file d'attente, et on reste calme et pas trop réactif pour éviter les bogues !

Il faut regarder l'historique des commits. Vous pouvez aussi consulter ce fichier whoPlayedWhen.log.

Dernière ligne de l'historique :

TODO

La ligne précédente est normalement mise à jour automatiquement.

• Posez une question en ouvrant un ticket.

• Au tout début !

• Regardez dans ce dossier
• TODO tout le monde doit prendre l'habitude de finir sa session de jeu en faisant une capture d'écran dans ce dossier !

  Il faut juste montrer où on se trouve l'aventure.

MIT Licensed (file LICENSE). © Lilian Besson, 2020.