ILYOS
Jeu de plateau 3D dans le navigateur : îles flottantes, gardiens et couronnes.
Site statique en JavaScript, Three.js et KayKit. Node sert à l'outillage local.
ILYOS V2 / reconstruction avec agent IA : commencer par
docs/v2-context/START_HERE.md. Le pack V2
décrit V1 comme référence et laisse volontairement ouverts moteur, langage,
architecture, plateformes et évolutions de règles.
Commencer
Sur ce poste, Node, les dépendances et Chromium sont déjà présents.
npm run doctor
npm run dev
Sous Windows PowerShell, si npm.ps1 est bloqué, utiliser npm.cmd run dev
(et npm.cmd run doctor). Aucun changement des règles de sécurité Windows
n'est nécessaire.
Ouvrir http://localhost:8123. Les modifications de js/game/*.js reconstruisent
automatiquement le jeu ; recharger la page pour les voir. Arrêt : Ctrl+C.
Un autre port est possible : npm run dev -- 8130.
Sur une nouvelle machine : installer Node 24 LTS et Git, puis npm ci et
npm run test:install. La version des dépendances vient de package-lock.json.
Dans VS Code : ouvrir ce dossier, puis F5 pour lancer le jeu avec Edge.
Les commandes sont aussi disponibles dans Terminal → Exécuter la tâche.
La tâche de développement reste active après la fermeture du navigateur ;
l'arrêter via Terminal → Terminer la tâche.
Commandes utiles
| Commande | Usage |
|---|
npm run dev | Construire, surveiller les sources et servir le jeu |
npm start | Servir uniquement, sans reconstruire |
npm run doctor | Vérifier les prérequis locaux |
npm run check | Contrôler le bundle et la syntaxe |
npm run test:smoke | Caméra + découverte, limite de 2 min par test |
npm run test:ui | Choisir et observer les tests dans Playwright |
npm test | Suite complète, comprenant une longue partie IA |
npm run assets:audit | Inventorier les fichiers et leur poids |
Pour continuer
js/game.js est généré : modifier les fragments, puis exécuter npm run build
avant de partager les changements. Aucune clé API n'est nécessaire au jeu local.
