À propos du projet

Dungeon est un RPG d'aventure textuelle solo local servi par une application Node.js. Il nécessite Node.js 22.13 ou version ultérieure et aucune installation de paquets ; après avoir copié .env.example vers .env et renseigné une clé de fournisseur, npm start sert le jeu à l'adresse http://127.0.0.1:4317. L'interface et le texte de campagne peuvent être réglés indépendamment en anglais ou en russe. Les joueurs commencent une nouvelle campagne à partir de modèles d'aventure intégrés ou personnalisés, avec un cadre, un scénario, un personnage et un contenu secret facultatif réservé au MJ. Les modèles personnalisés sont stockés dans data/adventure-templates.json, peuvent être modifiés ou copiés sans révéler les instructions cachées, et les modèles intégrés peuvent être réinitialisés. Une visionneuse de test ne peut révéler les secrets de MJ rédigés et les faits cachés établis du monde qu'après une confirmation de divulgâchage, sans modifier la campagne. La configuration des modèles est disponible via une page Paramètres. Elle prend en charge les connexions aux fournisseurs Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek et xAI, les identifiants de modèles personnalisés et les listes de modèles récupérées depuis les API officielles des fournisseurs sans inférence payante ; les listes sont mises en cache pendant une heure. Le défaut demandé est Gemini gemini-3.8-flash. Une clé API Artificial Analysis facultative permet d'obtenir des références de prix, mises en cache pendant six heures, avec un repli OpenRouter. Tous les appels de modèles partagent un registre local des dépenses, et l'application ne fait qu'estimer les dépenses locales au lieu de servir de facture de fournisseur à l'échelle du compte. Le gameplay utilise un seul personnage joueur. Le MJ invente des détails dans le cadre et l'histoire établie. Les jets significatifs présentent la difficulté de base, les modificateurs étiquetés, le total avant écrêtage, la probabilité de réussite et un résultat d100 réel ; les actions dont la probabilité calculée est de 0 ou 100 pour cent sont garanties et n'utilisent pas de dé. Les joueurs peuvent poser des questions hors jeu, faire appel des décisions ou demander des corrections/annulations, consulter les connaissances sourcées du personnage et du monde, et rechercher dans le journal. La sauvegarde et le rechargement sont automatiques. Les données de campagne sont stockées dans data/campaigns.sqlite, les dépenses dans data/spend-ledger.json et les résultats privés des fournisseurs dans data/provider-results. Le dépôt inclut les validations npm test et npm run check utilisant des fournisseurs simulés, avec des tests de navigateur Playwright facultatifs lorsque DUNGEON_PLAYWRIGHT_PATH est défini. La documentation décrit les règles pilotes et les conclusions des tests de jeu. Elle indique que le problème difficile restant est le jugement sémantique et ne garantit pas un comportement de MJ parfait ni la qualité de jeu des fournisseurs.