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.
• Las imágenes que muestras a la mesa con «Show Players», reducidas en tu navegador cuando puede decodificarlas y siempre recodificadas en el servidor de Daria antes de guardarlas — nunca sale de tu navegador más de 1 MB
• El retrato de los PNJ y monstruos nombrados que controlas — o el arte de su token si no tienen retrato —, una vez que el combate ha empezado — al comenzar y al unirse a uno ya en marcha

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.
• Se transmiten dos tipos de imagen. Cada una se reduce en tu navegador cuando puede decodificar el origen, siempre se recodifica a 1024 px como máximo en su lado más largo en el servidor de Daria antes de guardarla, y nunca sale de tu navegador más de 1 MB: las imágenes que compartes deliberadamente con «Show Players» — desde el visor de imágenes o desde una página de imagen de un diario —, con el título que le pone Foundry, y el retrato de los combatientes nombrados que controla el DM (o el arte de su token si no tienen retrato), una vez que el combate ha empezado — al comenzar y al unirse a uno ya en marcha. Nunca los fondos de escena, el texto de los diarios, ni las imágenes abiertas solo para ti; nunca tokens o combatientes ocultos hasta que los revelas; nunca los tokens de tus jugadores; nunca copias sin vincular como «Goblin 3». Cada tipo tiene su propio ajuste para desactivarlo.
• 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.
• El módulo informa de sus propios errores. Si falla el código del propio módulo, envía el error al mismo servidor — su tipo, su mensaje y dónde ocurrió dentro del módulo, junto con las versiones del módulo, de Foundry y del sistema de juego — para que podamos solucionarlo. La dirección de tu servidor de Foundry se elimina primero y no se añade nada de tu mundo. Los errores de Foundry en sí o de tus otros módulos nunca se envían, y como máximo se envían veinte cada vez que se carga 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 está alojada 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 / imágenes mostradas a los jugadores / arte de los tokens de combatientes — siete 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.13.0

• Ahora se capturan las imágenes que muestras desde un diario. Hasta ahora, «Show Players» en una página de imagen de un diario — tanto si abre la página como si muestra solo la imagen — se pasaba por alto, así que un material de apoyo mostrado de esa forma nunca llegaba a tu transcripción; solo se detectaba el botón del visor de imágenes. Las páginas de texto y las entradas de diario completas siguen sin enviarse nunca.
• Ahora un combatiente se captura con su retrato completo en lugar del arte de su token, que a menudo está recortado para encajar en el anillo del token. El arte del token se sigue usando para un PNJ o monstruo que no tiene retrato propio.
• Un PNJ o monstruo nombrado que estaba oculto al empezar el combate — en el registro de combate o en el mapa — ahora se captura en cuanto lo revelas, en lugar de nunca. Se sigue enviando una sola vez, y solo una vez que el combate ha empezado.

0.12.0

• Cuando algo sale mal dentro del propio módulo, ahora informa del error a Daria para que podamos solucionarlo — incluyendo un fallo durante la carga de tu mundo, que hasta ahora parecía exactamente que Foundry no estaba abierto. Los informes se envían al mismo servidor que tus eventos, nunca incluyen contenido de mundo, campaña o jugador ni la dirección de tu servidor de Foundry, y nunca incluyen errores de Foundry en sí o de tus otros módulos.

0.11.0

• Las imágenes que muestras a la mesa con el «Show Players» del visor de imágenes ahora se capturan. Cada una llega a la transcripción de la sesión en el momento en que la mostraste, así que un material que enseñas a la mesa o un retrato que nadie describió en voz alta ya no falta en el registro.
• Cuando un PNJ o monstruo nombrado que controlas se une a un combate una vez que este ha empezado — al comenzar o al unirse a uno ya en marcha —, también se captura el arte de su token, y la transcripción registra quién se unió al combate en ese momento. Nunca tokens o combatientes ocultos, nunca los tokens de tus jugadores, y nunca copias sin vincular como «Goblin 3».
• Solo se capturan los compartidos explícitos y los combatientes una vez que el combate ha empezado: nunca los fondos de escena, las páginas de diario, ni las imágenes que abres para ti. Las imágenes se reducen en tu navegador cuando puede decodificarlas y siempre se recodifican en el servidor de Daria antes de guardarlas, sin que salga de tu navegador más de 1 MB, y dos ajustes nuevos — «Capture images shown to players» y «Capture combatant token art» — desactivan cada uno.

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.