07 - Carnet de Bord GameShell : Finir le Jeu

Épopée E1 · Sprint 2 — Apprendre le terminal par le jeu · Station Debian + Konsole + réseau
Compétences visées : C-1.2.2 (manipulation du système en ligne de commande) et C-1.4.1 (tenue du carnet d’apprentissage).

---

🎮 1. Le principe du jeu

GameShell est un jeu d’aventure textuelle qui s’exécute directement au sein de votre terminal Linux. Vous y explorez un univers médiéval fantastique en tapant de vraies commandes Linux (navigation, manipulation de fichiers, jokers, redirections, processus, droits d’accès).

• Objectif central : Terminer les 44 missions dans l’ordre chronologique — chaque mission validée débloque automatiquement la suivante jusqu’à l’écran FINAL_MISSION.

---

🛠️ 2. Installation et Lancement du jeu sous Debian

Ouvrez votre terminal Konsole et réalisez les trois étapes suivantes :

Étape 1 : Installer les paquets et outils requis

Installez les dépendances indispensables (compilateur, visionneuse d’arborescence, utilitaires calendrier et gestion des processus) :

sudo apt update && sudo apt install -y gettext gcc man-db procps psmisc nano tree bsdmainutils x11-apps wget

Étape 2 : Télécharger le script du jeu

Placez-vous à la racine de votre dossier personnel et téléchargez le script exécutable :

cd ~
wget https://pierre-hyvernat.apps.math.cnrs.fr/data/Enseignement/2526/info201/TP2/gameshell.sh

Étape 3 : Démarrer la partie

Lancez le jeu avec l’interpréteur Bash :

bash ./gameshell.sh

💡 Reprise automatique : chaque mission validée est enregistrée dans une sauvegarde locale. Si vous quittez ou fermez votre console, relancez simplement bash ./gameshell.sh pour reprendre exactement là où vous vous étiez arrêté.

---

⌨️ 3. Les 3 réflexes de survie en terminal

Avant même d’aborder les énigmes, trois automatismes doivent devenir des réflexes absolus :

1. La touche Tab (autocomplétion magique) :
   Ne tapez jamais un nom de fichier ou de dossier en entier ! Tapez 2 ou 3 lettres puis appuyez sur Tab. Si plusieurs correspondances existent, pressez Tab une seconde fois pour afficher la liste des choix.
2. Le frein d’urgence Ctrl + C :
   Si une commande tourne en boucle, attend indéfiniment ou semble figée, ne fermez pas la fenêtre : pressez simultanément Ctrl et C pour interrompre immédiatement le processus sans quitter votre session.
3. La boussole pwd (Print Working Directory) :
   Lorsque vous êtes égaré au fil de l’arborescence du jeu, tapez pwd pour afficher le chemin absolu de votre dossier de travail actuel.

---

⚖️ 4. Les ordres de l’arbitre de jeu (gsh)

Tout au long de l’aventure, un programme arbitre nommé gsh évalue votre environnement :

Ordre de l’arbitre	Quand et comment l’utiliser
gsh goal	Vous ne savez plus quoi faire : réaffiche en clair l’objectif et les conditions de la mission active.
gsh check	Vous pensez avoir réussi la manipulation : l’arbitre teste l’état du système. Si c’est validé, la mission suivante est débloquée.
gsh reset	Vous êtes bloqué, avez fait une fausse manipulation ou effacé un fichier clé : réinitialise la mission en cours à zéro.
gsh help	Affiche la liste des ordres et options disponibles.
gsh exit	Vous terminez votre séance de travail : sauvegarde l’état d’avancement et quitte proprement le jeu.

⚠️ Trois conseils d’organisation

• Aucune solution fournie à l’avance : Lisez attentivement l’objectif, expérimentez et testez avec gsh check. Se tromper et analyser ses erreurs fait partie intégrante de l’apprentissage.
• Missions chronométrées : Pas de panique en cas de compte à rebours, gsh reset permet de recommencer l’épreuve sans pénalité.
• Progression incrémentale : Inutile de boucler les 44 épreuves d’une seule traite, progressez méthodiquement par blocs.

---

📝 5. Document livrable : le carnet de bord sous LibreOffice Writer

Parallèlement au jeu, vous devez consigner vos découvertes dans un document de synthèse technique personnel.

Modalités de conception :

1. Créer le document :
   Ouvrez LibreOffice Writer (Lanceur d’applications, touche Super, tapez writer). Enregistrez le document sous le nom carnet-de-bord-gameshell.odt dans votre dossier ~/Documents, en mentionnant vos nom, prénom et classe dans l’en-tête.
2. Insérer le tableau récapitulatif :
   Dans le menu Tableau → Insérer un tableau, créez un tableau à 3 colonnes :
   • Commande
   • Rôle
   • Exemple d’utilisation
3. Alimenter au fil des missions :
   À chaque nouvelle commande ou option découverte, insérez une ligne complète :
   • Le nom exact de la commande (ex : pwd, ls, cd, mkdir, rm, mv, cp, cat, grep, chmod).
   • Son rôle résumé en une phrase claire et précise.
   • Un exemple réellement testé par vos soins dans le cadre du jeu.

Exemple de référence à reproduire :
pwd | Affiche le chemin absolu du dossier courant | pwd
mkdir -p | Crée un dossier et tous ses répertoires parents manquants | mkdir -p ~/Foret/Hutte/Coffre
rm -f | Supprime un fichier sans demander confirmation | rm -f temp.txt

---

✅ 6. Critères d’évaluation & de réussite de la séance

La séance est officiellement validée lorsque les deux conditions suivantes sont réunies :

• L’écran final FINAL_MISSION est atteint (les 44 missions du jeu ont été validées auprès de l’arbitre gsh check).
• Le fichier carnet-de-bord-gameshell.odt est dûment complété avec une ligne exhaustive par commande (rôle synthétique et exemple concret testé).