WendiGame est un jeu de déduction et de survie à rôles cachés. Imaginez le célèbre jeu du "Loup-Garou de Thiercelieux", mais sans avoir besoin de cartes en carton ou de quelqu'un qui sacrifie sa soirée pour faire le "Maître du Jeu".
L'application s'occupe de tout et s'adapte à vous :
- Vous êtes tous dans le même salon ? Sortez vos téléphones. L'application distribue les rôles en secret, synchronise la tombée de la nuit sur tous les écrans en même temps, et compte les votes pour vous.
- Vous jouez chacun chez vous sur PC ? Mettez un casque. Le jeu intègre un système vocal "spatialisé" : vous entendrez les autres joueurs comme s'ils étaient vraiment assis autour de vous.
- Les Villageois doivent débusquer les monstres qui se cachent parmi eux et voter pour les éliminer pendant la journée.
- Les Wendigos (les monstres) se réveillent la nuit pour dévorer un villageois en secret.
- D'autres rôles spéciaux (comme la Voyante) ont des pouvoirs uniques pour aider leur camp.
Tu veux faire tourner le jeu sur ton propre ordinateur pour tester ? Pas de panique, suis ce guide étape par étape. C'est comme une recette de cuisine !
Avant de commencer, ton ordinateur a besoin de deux logiciels gratuits pour comprendre le code du jeu :
- Docker Desktop : C'est le moteur qui va faire tourner les serveurs du jeu de manière isolée. Télécharge-le, installe-le et lance-le.
- Nix : C'est une boîte à outils magique qui va installer automatiquement tout le reste pour toi (Go, Node.js, etc.) sans rien casser sur ton ordinateur.
⚠️ Petite note pour les utilisateurs de Windows : La boîte magique Nix ne comprend que le langage "Linux". Pas d'inquiétude ! Il te suffit d'installer un petit traducteur officiel appelé WSL. Cherche le programme PowerShell sur ton ordi, fais un clic droit pour l'ouvrir "en tant qu'administrateur", tapewsl --install, appuie sur Entrée, puis redémarre ton ordinateur. Tu es maintenant prêt !
Ouvre ton Terminal (ou Invite de commandes) et copie-colle ceci pour télécharger le dossier du jeu sur ton ordinateur :
git clone
cd WendiGameMaintenant que tu es dans le dossier du jeu, dis à Nix de préparer tes outils. Dans ton terminal, tape :
nix develop(Patiente un peu la première fois, il télécharge ce dont il a besoin).
Le jeu a besoin de fichiers de configuration (qu'on appelle variables d'environnement) pour que ses différents morceaux communiquent entre eux. On a préparé des fichiers "exemples" qu'il suffit de copier :
Tape ces deux commandes pour créer tes propres fichiers .env :
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.envTout est prêt. Déplace-toi dans le dossier du serveur et lance la commande magique de démarrage :
cd backend
task up(Docker va se mettre en route. Tu vas voir beaucoup de texte défiler, c'est normal : il construit le serveur, la base de données et le système vocal).
Une fois que le terminal s'arrête de défiler frénétiquement :
- Ouvre ton navigateur internet (Chrome, Firefox, Safari...).
- Va à l'adresse suivante :
http://localhost:5173 - Crée-toi un compte, clique sur "Create Game", et amuse-toi !
Pour tout éteindre quand tu as fini : Retourne dans ton terminal et tape
task down.
Si tu es un développeur et que tu te demandes comment ça marche :
- Backend : Écrit en Go pur avec le framework réseau Gorilla WebSockets. Il agit comme un chef d'orchestre autoritaire (State Machine).
- Frontend : Une interface ultra-réactive codée en React / TypeScript, stylisée avec Tailwind CSS.
- Base de données : PostgreSQL pour sauvegarder les joueurs et Valkey/Redis pour gérer les salons d'attente instantanés.
Créé avec ❤️ et beaucoup de café par Billy Hallé.
Merci à Gabriel et Antony pour avoir enduré les premiers crash-tests du serveur.