llm-dungeon

Dungeon é um RPG de aventura de texto para um jogador, local, servido a partir de uma aplicação Node.js. Requer Node.js 22.13 ou posterior e nenhuma instalação de pacotes; depois de copiar .env.example para .env e preencher uma chave de provedor, npm start serve o jogo em http://127.0.0.1:4317. A interface e o texto da campanha podem ser definidos de forma independente em inglês ou russo. Os jogadores iniciam uma nova campanha a partir de modelos de aventura integrados ou personalizados, com conteúdo separado de cenário, situação, personagem e, opcionalmente, segredos exclusivos do Mestre. Modelos personalizados são armazenados em data/adventure-templates.json, podem ser editados ou copiados sem revelar instruções ocultas, e os modelos integrados podem ser redefinidos. Um visualizador de testes pode revelar segredos autorais do Mestre e fatos ocultos estabelecidos do mundo somente após uma confirmação de spoiler, sem alterar a campanha. A configuração de modelos está disponível em uma página de Configurações. Ela oferece suporte a conexões com os provedores Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek e xAI, IDs de modelo personalizados e listas de modelos obtidas das APIs oficiais dos provedores sem inferência paga; as listas são armazenadas em cache por uma hora. O padrão solicitado é Gemini gemini-3.8-flash. Uma chave opcional da API Artificial Analysis permite referências de preços, armazenadas em cache por seis horas, com fallback para o OpenRouter. Todas as chamadas de modelo compartilham um registro local de gastos, e o aplicativo apenas estima os gastos locais, em vez de servir como fatura do provedor para toda a conta. A jogabilidade usa um único personagem do jogador. O Mestre inventa detalhes dentro do cenário e do histórico estabelecido. Testes significativos apresentam dificuldade base, modificadores rotulados, total antes do limite, chance de sucesso e um resultado real de d100; ações com chance calculada de 0 ou 100 por cento são garantidas e não usam dado. Os jogadores podem fazer perguntas fora do jogo, apelar de decisões ou solicitar correções/desfazimentos, inspecionar conhecimento referenciado do personagem e do mundo e pesquisar o diário. Salvar e recarregar são automáticos. Os dados da campanha são armazenados em data/campaigns.sqlite, os gastos em data/spend-ledger.json e os resultados privados do provedor em data/provider-results. O repositório inclui validação com npm test e npm run check usando provedores simulados, com testes de navegador Playwright opcionais quando DUNGEON_PLAYWRIGHT_PATH está definido. A documentação descreve regras do piloto e descobertas de playtest. Ela afirma que o problema difícil restante é o julgamento semântico e não garante comportamento perfeito do Mestre nem qualidade de jogo do provedor.