D&D multijugador con GM IA
App web de D&D 5e (reglas SRD 5.1, en español) para hasta 4 jugadores. El GM puede ser Claude, con distintas personalidades, o una persona que prepara la campaña en un editor de diagrama de flujo.
El plan completo está en el doc del proyecto: https://claude.ai/artifact/7mcCXFRDdebxh9u4XVm1Mb
Estado
Fase 1, arranque. Hecho:
- Motor de dados (
src/rules/dice.ts): notación 1d20+5, 4d6kh3, ventaja y desventaja, críticos.
- Esquema de la base de datos para Neon (
db/schema.sql).
Falta: servidor con WebSockets, pantallas, login por link, motor de combate, mapa táctico y editor de campañas.
Cómo entran los jugadores
Abren el link, escriben el código de la sesión y eligen su personaje. No hay cuentas.
Desarrollo
Requiere Node 22.18 o superior.
cp .env.example .env # y rellena DATABASE_URL y ANTHROPIC_API_KEY
npm test
El tope de gasto del GM IA es 5 USD al mes (AI_MONTHLY_BUDGET_USD).
Imágenes y almacenamiento
Las imágenes (retratos, monstruos, escenas, PNJ y fondos de mapa) se suben en /imagenes o al crear un personaje. Se registran en la tabla imagenes (pertenece_a: criatura:goblin, nodo:<campaña>:<nodo>, pnj:<campaña>:<nombre>, fondo:<campaña>:<nombre>, personaje:<id>) y los archivos van al almacén definido en src/server/almacen.ts.
Hoy el almacén es la carpeta local uploads/ (ignorada por git). Para desplegar con R2 o S3, crea otra clase que implemente la interfaz Almacen (guardar, leer, borrar) y úsala en src/server/main.ts en lugar de AlmacenDisco; las rutas guardadas en la base no cambian. Los archivos se sirven en /uploads/<uuid>.<ext> con X-Content-Type-Options: nosniff y Content-Security-Policy: default-src 'none'; sandbox, y el tipo se valida por la cabecera del archivo, no por la extensión.
Aventuras incluidas
Seis aventuras SRD 5.1 en español, en db/seed/campanas/: El Molino Silencioso, La Cripta del Cuervo y Feria de los Espejos (cortas, nivel 1-2), y El Rey Sin Corona, Las Minas de Ceniza y El Mar de Sal (largas, 3-5 sesiones). Se cargan una a una en la base:
npm run seed # lista las aventuras
npm run seed -- cripta # carga una (si ya existe con ese nombre, no hace nada)
npm run seed -- cripta --imagenes # imágenes que pide, sin tocar la base
La lista de imágenes de cada aventura está en db/seed/campanas/IMAGENES.md; también aparece como checklist en /imagenes al elegir la campaña.
Rutas
/: los jugadores se unen con el código de sala y eligen personaje (y pueden crear uno en /personaje)./gm: crear sala (GM humano o IA), volver a una sala como GM con su token, y enlaces al editor, las imágenes y los perfiles. Se puede cambiar con GM_RUTA en .env (p. ej. GM_RUTA=/mi-mesa). Es solo discreción: la autenticación del GM sigue siendo el token de la sala.
Despliegue (Railway)
Vercel no sirve: solo publica public/ como estáticos (por eso /gm y /api/* dan 404) y sus funciones
no mantienen WebSockets, salas en memoria ni disco. Este servidor necesita un proceso Node siempre encendido.
- En railway.com: New Project → Deploy from GitHub repo →
laucho-lurus/laucho-dd. Usa el Dockerfile y railway.json.
- En el servicio → Variables:
DATABASE_URL, ANTHROPIC_API_KEY, AI_MONTHLY_BUDGET_USD (p. ej. 5) y, si quieres, GM_RUTA.
PORT y DATA_DIR=/data ya vienen en la imagen.
- En el servicio → Volumes → New Volume, montado en
/data (gasto de la IA, perfiles locales e imágenes subidas).
- Settings → Networking → Generate Domain. La mesa queda en
https://<dominio>/ y el GM en /gm.
- Una sola réplica: las salas viven en la memoria del proceso.
