llm-dungeon

Dungeon es un RPG de aventura de texto local para un jugador servido desde una aplicación Node.js. Requiere Node.js 22.13 o posterior y no necesita instalación de paquetes; después de copiar .env.example a .env y completar una clave de proveedor, npm start sirve el juego en http://127.0.0.1:4317. La interfaz y el texto de la campaña se pueden configurar de forma independiente en inglés o ruso. Los jugadores inician una nueva campaña a partir de plantillas de aventura integradas o personalizadas, con contenido separado de ambientación, escenario, personaje y, opcionalmente, contenido secreto solo para el DM. Las plantillas personalizadas se almacenan en data/adventure-templates.json, se pueden editar o copiar sin revelar instrucciones ocultas, y las plantillas integradas se pueden restablecer. Un visor de pruebas puede revelar secretos del DM creados y hechos ocultos establecidos del mundo solo después de una confirmación de spoiler, sin cambiar la campaña. La configuración del modelo está disponible a través de una página de Configuración. Admite conexiones a proveedores Gemini, OpenRouter, OpenAI, Anthropic, DeepSeek y xAI, identificadores de modelo personalizados y listados de modelos obtenidos de las API oficiales de los proveedores sin inferencia de pago; los listados se almacenan en caché durante una hora. El valor predeterminado solicitado es Gemini gemini-3.8-flash. Una clave opcional de Artificial Analysis API permite referencias de precios, almacenadas en caché durante seis horas, con respaldo de OpenRouter. Todas las llamadas al modelo comparten un registro local de gastos, y la aplicación solo estima el gasto local en lugar de servir como factura del proveedor para toda la cuenta. La jugabilidad utiliza un único personaje jugador. El DM inventa detalles dentro de la ambientación y la historia establecida. Las pruebas significativas presentan dificultad base, modificadores etiquetados, total antes de limitar, probabilidad de éxito y un resultado real de d100; las acciones con probabilidad calculada de 0 o 100 por ciento están garantizadas y no usan dado. Los jugadores pueden hacer preguntas fuera del juego, apelar resoluciones o solicitar correcciones/deshacer, inspeccionar el conocimiento documentado del personaje y del mundo, y buscar en el diario. El guardado y la recarga son automáticos. Los datos de la campaña se almacenan en data/campaigns.sqlite, los gastos en data/spend-ledger.json y los resultados privados del proveedor en data/provider-results. El repositorio incluye npm test y npm run check para validación con proveedores simulados, con pruebas opcionales de navegador Playwright cuando se establece DUNGEON_PLAYWRIGHT_PATH. La documentación describe las reglas del piloto y los hallazgos de las pruebas de juego. Afirma que el problema difícil restante es el juicio semántico y no garantiza un comportamiento perfecto del DM ni la calidad de juego del proveedor.