Scrap & Sparks

Installer le jeu

Tu fais quatre choses ; le fichier de démarrage fait le reste. Environ une heure la première fois, surtout à attendre les téléchargements.

Windows 10 ou 11

  1. Activer WSL

    5 minutes, puis un redémarrage

    WSL permet à Windows de faire tourner des programmes Linux. Docker en a besoin.

    1. Fais un clic droit sur le bouton Démarrer et choisis Terminal (administrateur) (sous Windows 10 : Windows PowerShell (admin)). Clique sur Oui quand Windows le demande.
    2. Tape wsl --install et appuie sur Entrée.
    3. Quand c'est fini, redémarre ton ordinateur.
    Un problème ?
    Il dit que WSL est déjà installé
    Parfait : tape wsl --update, appuie sur Entrée, et passe à l'étape suivante.
    Il parle de virtualisation
    La virtualisation est désactivée dans les réglages de ton ordinateur (BIOS ou UEFI). Cherche sur le web la marque de ton ordinateur et « activer la virtualisation », active-la, puis recommence cette étape.
    Rien ne se passe, ou un code d'erreur
    Vérifie que Windows est à jour (Paramètres › Windows Update), redémarre, puis réessaie. Le guide de Microsoft : Installer WSL.
  2. Installer Docker Desktop

    10 minutes
    1. Ouvre la page d'installation de Docker pour Windows (en anglais) et télécharge Docker Desktop for Windows.
    2. Ouvre le fichier téléchargé. Laisse coché Use WSL 2 instead of Hyper-V, suis les étapes, puis clique sur Close.
    3. Ouvre Docker Desktop depuis le menu Démarrer et clique sur Accept pour accepter ses conditions. Pas besoin de compte Docker.
    4. Attends que le bas de sa fenêtre affiche Engine running.
    Un problème ?
    Docker dit que WSL doit être mis à jour
    Rouvre Terminal (administrateur), tape wsl --update, appuie sur Entrée, puis rouvre Docker Desktop.
    Il reste longtemps sur « Starting »
    Redémarre ton ordinateur et rouvre Docker Desktop. Le premier démarrage peut prendre quelques minutes.
    Docker me demande de me connecter
    Ce n'est pas nécessaire pour ce jeu : tu peux passer cette étape.
  3. Télécharger le jeu

    1 minute

    Télécharger le jeu (zip)

    1. Fais un clic droit sur le fichier zip téléchargé et choisis Extraire tout.
    2. Choisis un endroit que tu retrouveras, par exemple ton dossier Documents.

    Le dossier contient quelques petits fichiers. n8n et le jeu arrivent plus tard, par Docker.

    Un problème ?
    J'ai ouvert le zip, mais l'étape suivante ne marche pas
    Windows montre le contenu d'un zip sans le décompresser. Utilise d'abord Extraire tout, puis ouvre le nouveau dossier.
  4. Démarrer le jeu

    10 à 30 minutes la première fois, ensuite moins d'une minute
    1. Dans le dossier du jeu, double-clique sur start.bat.
    2. Si Windows avertit à propos d'un fichier venu d'internet, choisis Informations complémentaires, puis Exécuter quand même (ou Exécuter).
    3. Une fenêtre noire montre ce qui se passe. Elle démarre Docker Desktop si besoin, puis télécharge n8n et le jeu (environ 4 Go) la première fois. Laisse-la travailler.
    4. Le jeu s'ouvre dans ton navigateur à l'adresse http://localhost:8765.
    Un problème ?
    « Docker Desktop is not installed yet »
    Reviens à l'étape 2, puis double-clique de nouveau sur start.bat.
    « Docker Desktop did not start »
    Ouvre toi-même Docker Desktop, attends Engine running, puis double-clique de nouveau sur start.bat.
    « another program already uses port 5678, 8765 or 5688 »
    Ferme le programme qui l'utilise (souvent un autre n8n), ou redémarre ton ordinateur, puis réessaie.
    « The game is taking long to start »
    Attends une minute, puis ouvre toi-même http://localhost:8765 dans ton navigateur.
  5. Jouer

    5 minutes pour le niveau 0

    Le jeu s'ouvre sur le niveau 0. Madame Ferrous te guide à partir de là : tu crées ton compte n8n (il reste sur ton ordinateur) et une clé qui permet au jeu de vérifier ton travail.

    Pour arrêter le jeu, double-clique sur stop.bat. Ta progression et ton n8n restent enregistrés ; start.bat les fait revenir.

Mac

  1. Installer Docker Desktop

    10 minutes
    1. Regarde la puce de ton Mac : menu Pomme › À propos de ce Mac. Il indique Puce (Apple silicon, par exemple M1) ou Processeur (Intel).
    2. Ouvre la page d'installation de Docker pour Mac (en anglais) et télécharge la version pour ta puce.
    3. Ouvre Docker.dmg et glisse Docker dans Applications.
    4. Ouvre Docker depuis Applications et clique sur Accept pour accepter ses conditions. Pas besoin de compte Docker.
    Un problème ?
    Docker dit que mon macOS est trop ancien
    Docker Desktop fonctionne avec le macOS actuel et les deux précédents. Mets macOS à jour (Réglages Système › Général › Mise à jour de logiciels) si tu peux.
    Docker me demande de me connecter
    Ce n'est pas nécessaire pour ce jeu : tu peux passer cette étape.
  2. Télécharger le jeu

    1 minute

    Télécharger le jeu (zip)

    Double-clique sur le fichier zip pour le décompresser, puis range le nouveau dossier à un endroit que tu retrouveras, par exemple Documents.

  3. Démarrer le jeu

    10 à 30 minutes la première fois, ensuite moins d'une minute
    1. Ouvre Terminal (appuie sur Cmd + Espace, tape Terminal, appuie sur Entrée).
    2. Tape sh puis une espace, glisse le fichier start.sh du dossier du jeu dans la fenêtre du Terminal, puis appuie sur Entrée.
    3. Le Terminal montre ce qui se passe. Il démarre Docker Desktop si besoin, puis télécharge n8n et le jeu (environ 4 Go) la première fois. Laisse-le travailler.
    4. Le jeu s'ouvre dans ton navigateur à l'adresse http://localhost:8765.
    Un problème ?
    « Docker Desktop did not start »
    Ouvre toi-même Docker depuis Applications, attends qu'il tourne, puis relance sh start.sh.
    « another program already uses port 5678, 8765 or 5688 »
    Ferme le programme qui l'utilise (souvent un autre n8n), puis réessaie.
    « The game is taking long to start »
    Attends une minute, puis ouvre toi-même http://localhost:8765 dans ton navigateur.
  4. Jouer

    5 minutes pour le niveau 0

    Le jeu s'ouvre sur le niveau 0. Madame Ferrous te guide à partir de là : tu crées ton compte n8n (il reste sur ton ordinateur) et une clé qui permet au jeu de vérifier ton travail.

    Pour arrêter le jeu, lance stop.sh de la même façon (sh, une espace, glisse le fichier, Entrée). Ta progression et ton n8n restent enregistrés.

Linux

  1. Installer Docker Engine et Compose

    10 minutes
    1. Suis le guide de Docker pour ta distribution (Ubuntu, Debian, Fedora et d'autres, en anglais). Il installe Docker Engine et son plugin Compose.
    2. Autorise ton utilisateur à lancer Docker sans sudo : étapes après l'installation sous Linux. Déconnecte-toi puis reconnecte-toi ensuite.
    3. Vérifie que ça marche : docker compose version affiche une version.
    Un problème ?
    « permission denied » en lançant docker
    Ton utilisateur n'est pas encore dans le groupe docker, ou tu ne t'es pas déconnecté puis reconnecté. Voir les étapes après l'installation ci-dessus.
    « docker: 'compose' is not a docker command »
    Le plugin Compose manque : installe le paquet docker-compose-plugin en suivant le guide de Docker.
  2. Télécharger le jeu

    1 minute

    Télécharger le jeu (zip)

    Décompresse-le là où tu ranges tes affaires, par exemple avec ton gestionnaire de fichiers ou unzip.

  3. Démarrer le jeu

    10 à 30 minutes la première fois, ensuite moins d'une minute
    1. Ouvre un terminal dans le dossier du jeu et lance sh start.sh.
    2. Il télécharge n8n et le jeu (environ 4 Go) la première fois. Laisse-le travailler.
    3. Le jeu s'ouvre dans ton navigateur à l'adresse http://localhost:8765.
    Un problème ?
    « Docker is not running »
    Démarre-le, par exemple avec sudo systemctl start docker, puis relance sh start.sh.
    « another program already uses port 5678, 8765 or 5688 »
    Arrête le programme qui l'utilise (souvent un autre n8n), puis réessaie.
    Le navigateur ne s'ouvre pas
    Ouvre toi-même http://localhost:8765.
  4. Jouer

    5 minutes pour le niveau 0

    Le jeu s'ouvre sur le niveau 0. Madame Ferrous te guide à partir de là : tu crées ton compte n8n (il reste sur ton ordinateur) et une clé qui permet au jeu de vérifier ton travail.

    Pour arrêter le jeu : sh stop.sh. Ta progression et ton n8n restent enregistrés.

Questions

Docker est-il gratuit ?
Docker Desktop est gratuit pour un usage personnel, l'enseignement, et les entreprises de moins de 250 employés et de moins de 10 millions de dollars de chiffre d'affaires annuel. Les plus grandes entreprises ont besoin d'un abonnement Docker payant. Voir les tarifs de Docker.
Quelle place ça prend ?
Environ 4 Go à télécharger une fois : n8n, son assistant pour le Code node, et le jeu. Docker lui-même vient en plus.
Mon n8n va-t-il sur internet ?
Non. n8n tourne sur ton ordinateur et seul ton ordinateur peut l'ouvrir. Le jeu ne lit que les workflows avec le tag scrap-and-sparks. Ce que le jeu envoie, si tu le permets, est expliqué sur la page vie privée.
Comment tout supprimer ?
Arrête le jeu, puis lance docker compose down -v dans le dossier du jeu. Cela supprime définitivement le n8n du jeu et ses workflows. Supprime ensuite le dossier, et les images dans Docker Desktop (Images) si tu veux récupérer la place.