battle-forge
Battle Forge es un compañero autohospedado en tiempo real para juegos de mesa D&D 5e. Ofrece dashboard para el Director (DM), hojas de personaje móviles y tablero compartido. Utiliza Next.js, NestJS, Socket.IO y MongoDB con Docker. Diseñado para control manual rápido durante la partida.
Ficha actualizada 27 sept 2026, 11:06 · upstream 27 sept 2026, 10:42 · release sin release detectada
Qué es battle-forge
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Battle Forge es una herramienta autohospedada diseñada para facilitar encuentros de D&D 5e en mesa, priorizando el control manual del Director sobre la automatización completa. Integra un escritorio para el DM con gestión de escenas, criaturas y recursos, junto con hojas de personaje móviles y un tablero compartido para visualización grupal. La arquitectura se basa en Next.js, NestJS y Socket.IO para sincronización en tiempo real, almacenando datos persistentes en MongoDB local sin depender de servicios externos.
La aplicación gestiona el estado del combate, incluyendo turnos, iniciativa, efectos de estado y recursos como slots de hechizos o puntos de furia. Permite a los jugadores realizar cálculos de daño manuales mientras la herramienta rastrea la salud, estados knockout y salvaciones de muerte. Incluye un espacio de trabajo para traducir contenido desde Open5E y guardar bibliotecas locales de criaturas, objetos y hechizos.
El despliegue es sencillo mediante Docker Compose, utilizando MongoDB como base de datos local. La sincronización entre el tablero compartido y las hojas de jugador ocurre a través de BroadcastChannel en el mismo dispositivo, manteniendo las imágenes de historia en memoria del navegador para evitar almacenamiento externo.
- Gestión de combate y turnos en tiempo real para grupos locales
- Visualización compartida de tablero de batalla y escenas narrativas
- Biblioteca local de criaturas, objetos y traducciones de Open5E
- Hojas de personaje móviles con gestión de recursos y hechizos
- Presentación de historia con imágenes locales y guion Markdown
- Arquitectura autohospedada sin dependencia de servicios externos
- Sincronización real-time vía Socket.IO y BroadcastChannel
- Gestión manual de combate para preservar la experiencia de juego
- Biblioteca persistente en MongoDB local con Docker Compose
- Soporte nativo para traducción e importación desde Open5E
- Sincronización limitada a dispositivos del mismo origen o red local
- Cálculo de slots multiclase no automatizado en la versión alpha
- Imágenes de historia se recargan tras un reload completo del navegador
- Requiere acceso a internet para búsquedas iniciales en Open5E
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar con Docker Compose. Puerto 8080 expuesto. Requiere 2 núcleos CPU y 2GB RAM mínimo según análisis técnico. Persistir datos de MongoDB en volumen local. Asegurar que el navegador del DM y los jugadores estén en la misma red para sincronización vía BroadcastChannel.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.