Módulo de Foundry VTT · daria-foundry

Daria para Foundry VTT

Daria graba el audio de tu sesión y lo convierte en una transcripción. Este módulo añade lo que el micrófono no puede oír: los dados, los conjuros, los objetos y los estados que tu grupo fue recogiendo por el camino — colocados en la misma línea de tiempo que las palabras dichas.

Qué captura

• Tiradas de dados, incluido el tipo de tirada, los críticos y las pifias
• Lanzamientos de conjuros, incluido el nivel de espacio realmente gastado — y conjuros mostrados en el chat sin ser lanzados, separados de los que sí lo fueron
• Usos de objetos, y objetos mostrados en el chat sin ser usados
• Estados y efectos activos ganados o perdidos — Derribado recibido, Bendición perdida
• Quién habla en una conversación, cuando el módulo Conversation HUD está activo — la apertura o el cierre de una conversación, y qué participante marca el DM como hablante, junto con su facción cuando se muestra. Daria los usa como pistas para atribuir al PNJ correcto las réplicas que el DM interpreta en la transcripción.

En el sistema dnd5e llegan enriquecidos, con los nombres de los objetivos en las tiradas de ataque y de daño. Los demás sistemas de juego siguen teniendo la captura simple de tiradas y efectos.

Qué sale de tu mundo

Solo eventos de juego, y solo mientras hay una grabación de Daria en marcha. En concreto:

• El módulo se ejecuta solo en el cliente del DM. Los clientes de los jugadores no envían nada.
• Las tiradas ocultas siguen ocultas. Las tiradas susurradas, ciegas y privadas se filtran dentro de Foundry y no se transmiten nunca.
• Los efectos solo se capturan para actores visibles que pertenezcan a los jugadores. Lo que tengas escondido detrás de la pantalla se queda ahí.
• Las conversaciones solo se capturan mientras se muestran a los jugadores. Una conversación invisible es preparación no revelada, y sus participantes no salen nunca de Foundry. Un participante cuyo nombre ocultes se informa como personaje sin revelar — el nombre en sí no se envía nunca.
• Los mensajes de chat no se envían nunca. Ni descripciones, ni narración. El texto de ambientación de una tirada sí viaja con ella (limitado a 500 caracteres), y cada evento lleva el nombre visible del jugador de Foundry junto al nombre del personaje.
• El módulo se presenta al cargarse. Le dice al servidor qué versión del módulo, qué versión de Foundry y qué sistema de juego está usando — ningún dato de mundo, campaña o jugador — y el servidor responde si tu token se acepta, si hay una grabación en marcha y si tu módulo necesita actualizarse. Esa respuesta es lo que ves en el aviso de la parte superior de la ventana cuando abres tu mundo.
• Los eventos se envían al servidor con una cadencia regular siempre que haya un token configurado. Fuera de una grabación activa el servidor rechaza el lote y no guarda nada, así que los eventos quedan en un búfer local y se reintentan — un corte de red no pierde datos, y cada evento conserva el momento en que ocurrió, así que una entrega tardía sigue aterrizando en el punto correcto de tu sesión y no allá donde estuviera la grabación cuando llegó.

Los eventos se envían a https://hooks.daria.gg, autenticados con el token de API de tu campaña. Daria almacena todos los datos en la UE.

Requisitos

• Foundry VTT v12, v13 o v14
• Una campaña de Daria en tu servidor de Discord
• Un token de API, emitido desde la página de tu campaña en la aplicación web de Daria

Instalación

En Foundry, abre Módulos complementarios → Instalar módulo, pega esta URL de manifiesto en el campo de abajo y pulsa Instalar:

Configuración

Abre Configurar ajustes → Daria — Game Event Capture. Solo el DM los ve.

• Token de API de Daria — se guarda en tu propio cliente y solo para este mundo, nunca se sincroniza con los jugadores. Pega aquí el token de tu campaña; la captura empieza en cuanto está puesto.
• Capturar tiradas de dados / lanzamientos de conjuros / usos de objetos / cambios de estados y efectos / quién habla en conversaciones — cinco interruptores independientes, compartidos por todo el mundo de juego. Todos activados por defecto.
• Registro de depuración — registra cada evento capturado en la consola del navegador (F12). Desactivado por defecto; actívalo si vas a informar de un problema.

No hay nada más que configurar — el módulo habla siempre con el servicio alojado de Daria.

Soporte

Informa de un problema o pregunta lo que quieras en el foro #help de nuestro Discord. Incluye tu versión del módulo, la versión de Foundry, el sistema de juego y todo lo que haya impreso la consola del navegador.

Licencia

El módulo daria-foundry es libre de instalar, usar y redistribuir junto con el servicio Daria, tanto para partidas personales como comerciales. Se ofrece tal cual, sin garantía de ningún tipo. Esta licencia cubre únicamente el módulo: no otorga ningún derecho sobre el servicio Daria, su nombre o sus ilustraciones.

Registro de cambios

0.10.0

• Ahora también se capturan los objetos o conjuros publicados en el chat por sí solos — la opción «Display in Chat» de dnd5e, o hacer clic en un objeto que no tiene tiradas. Hasta ahora solo se registraban los usos reales, así que un conjuro que alguien ponía delante de la mesa para leerlo no dejaba rastro en la transcripción.
• Esas tarjetas se registran como mostradas en lugar de usadas, así que tu transcripción dice «muestra Bola de fuego» y no «lanza Bola de fuego», y no se contabiliza espacio de conjuro para un conjuro que nadie lanzó.

0.9.0

• Tu token de API ahora se recuerda por mundo y no por navegador. Si llevas más de una campaña desde la misma instalación de Foundry, cada mundo conserva su propio token: antes compartían uno solo, así que un segundo mundo mandaba sus tiradas a la primera campaña o, si allí no había ninguna grabación en marcha, a ninguna parte. Al actualizar no tienes que hacer nada: un mundo que ya tenía token lo conserva, y solo hace falta pegar uno en los mundos que pertenezcan a otra campaña.
• El aviso que aparece al cargar tu mundo ahora nombra la campaña a la que estás conectado, así que ves de un vistazo que ese mundo alimenta la correcta.

0.8.0

• El módulo ahora se presenta a Daria cuando carga tu mundo y te dice lo que ha encontrado: si tu token de API se acepta, si el servidor está accesible, si hay una grabación en marcha — y, como novedad, si tu versión del módulo está desactualizada o es demasiado antigua para el servidor. Antes, un token ausente o rechazado pasaba en silencio, y lo descubrías después de la sesión al no encontrar ningún dado en la transcripción. El veredicto aparece como un aviso en la parte superior de la ventana de Foundry — la propia notificación de Foundry — y desaparece solo. A partir de ahí el módulo no dice nada en absoluto — ninguna notificación durante la partida, pase lo que pase — así que nunca puede interrumpir una escena. Si el servidor deja de responder a mitad de sesión, las capturas se guardan en un búfer y se envían en cuanto vuelve a contestar; el búfer aguanta una sesión entera — doce horas de juego continuado — de modo que ni un corte que dure toda la velada cuesta nada.
• Pegar o cambiar tu token de API vuelve a lanzar esa comprobación al momento: averiguas si funciona sin salir del diálogo de ajustes.
• Esa presentación informa de tu versión del módulo, la versión de Foundry y el sistema de juego, para que el soporte pueda responder sin pedirte que abras una consola. No se incluye ningún dato de mundo ni de campaña.

0.7.0

• Captura de Conversation HUD: inicio y fin de conversación, y el participante que el DM marca como hablante — usados como pistas de locutor en las transcripciones de sesión. Requiere el módulo Conversation HUD; las conversaciones invisibles no se envían nunca, los nombres de participantes ocultos se informan como personaje sin revelar, y la facción del hablante se incluye cuando se muestra.

0.6.0

• Publicada la documentación del módulo y el canal de soporte; sin cambios de juego.

0.5.0

• Captura de estados y efectos para actores visibles que pertenezcan a los jugadores.
• Enriquecimiento de dnd5e: tipo de tirada, críticos y pifias, niveles de espacio de conjuro, nombres de los objetivos.
• Búfer local con envíos por lotes, para no perder nada en caso de corte.