Ir al contenido principal

Módulo de Foundry VTT

Instalar y configurar el módulo JDR Ninja en Foundry VTT

Prepare la instalación, vincule su cuenta JDR Ninja y active las funciones útiles para su partida. La sincronización con Atlas también requiere una conexión con el mundo correspondiente.

Antes de empezar

Compruebe las versiones de Foundry y del sistema de juego en los ajustes del mundo. El módulo requiere Foundry 14 como mínimo; los generadores de D&D admiten exactamente Foundry V14 y D&D5e 5.3.3. La sincronización con Atlas acepta los sistemas indicados en la página del módulo.

Entre como director de juego para usar generadores, sincronización con Atlas y comandos de tablas desde Twitch. Los jugadores pueden configurar el envío de sus tiradas públicas. No necesita Stream Deck para las demás funciones.

Módulo de Foundry VTT

Instalar y activar el módulo

El módulo JDR Ninja está publicado en Foundry VTT. En la pantalla de configuración de Foundry, abra la pestaña de módulos, haga clic en el botón de instalación y busque « JDR Ninja ». Si el módulo no aparece en la búsqueda, pegue la dirección de su manifiesto en la ventana de instalación:

https://github.com/JDR-Ninja/fvtt-jdr-ninja/releases/latest/download/module.json

El módulo requiere Foundry VTT versión 14 o posterior, y ningún otro módulo. Abra después su mundo y active JDR Ninja en la gestión de módulos.

En los ajustes de Foundry, la sección JDR Ninja ofrece el botón « Configurar las conexiones ». Abre la ventana « Conexiones de JDR Ninja »: su cuenta de JDR Ninja arriba y, debajo, una tarjeta por función, Stream Deck y VTT Overlay, además de Generadores D&D y Sincronización Atlas para el director de juego.

Vincular su cuenta JDR Ninja

  1. En la ventana « Conexiones de JDR Ninja », haga clic en « Conectar mi cuenta » y luego en « Abrir JDR Ninja », e inicie sesión en el sitio si es necesario. Si los generadores de D&D ya están activados en este navegador, su acceso se solicita en la misma autorización.
  2. Compruebe el código y el nombre del dispositivo. Si desea usar los generadores de D&D, autorice explícitamente esa función antes de aprobar la conexión.
  3. Vuelva a Foundry y espere la confirmación de la cuenta. El acceso se comprueba por separado para cada función. Si la solicitud caducó o se rechazó, inicie una nueva conexión.

También puede generar un token manual en la página de dispositivos Foundry, introducirlo en « Opciones avanzadas » y hacer clic en « Verificar y guardar ». Solo se muestra una vez. Si la tarjeta « Generadores D&D » indica « Autorización necesaria », haga clic en « Autorizar en JDR Ninja » para añadir su acceso.

Gestionar mis dispositivos Foundry
Ventana de conexiones del módulo JDR Ninja en Foundry VTT
Vista del módulo local: conexión de la cuenta y ajustes del overlay y de Stream Deck en Foundry.

Activar las funciones elegidas

Conectar la cuenta no activa ninguna función. En la ventana « Conexiones de JDR Ninja », cada tarjeta tiene su interruptor « Activar », desactivado al principio. Los de Stream Deck, el overlay y los generadores solo valen para este navegador; el de la sincronización con Atlas vale para todos los directores de juego del mundo.

  • Generadores de D&D (director de juego): la tarjeta indica primero si su mundo es compatible y después el acceso que da su suscripción. Cuando los generadores estén activados y disponibles, abra « Monstruos D&D » o « PNJ D&D » desde el directorio de actores o los ajustes de JDR Ninja.
  • Overlay: prepare la fuente OBS en la configuración del overlay del sitio y active la tarjeta « VTT Overlay ». Su botón « Configurar VTT Overlay » abre una ventana que comprueba el overlay al abrirse y ofrece « Enviar tirada de prueba »; esta prueba requiere la misma suscripción que las tiradas.
  • Stream Deck: instale primero el plugin e inicie la conexión local. En Foundry, el botón « Configurar Stream Deck » de su tarjeta abre la ventana donde se introducen la dirección y la clave de vinculación; « Guardar y activar » termina la configuración. La guía específica explica la clave y la elección de la sesión.

Conectar su mundo Atlas

  1. En el sitio, abra sus conexiones Foundry y cree una conexión de sincronización para el mundo Atlas correspondiente. Copie el token que se muestra una sola vez. También puede crear la conexión desde los ajustes de ese mundo.
  2. En Foundry, introduzca ese token en la tarjeta « Sincronización Atlas » de la ventana « Conexiones de JDR Ninja » y haga clic en « Verificar y guardar ». Compruebe el nombre del mundo y el acceso a la sincronización. Este token es distinto de la conexión de la cuenta y de la clave Stream Deck.
  3. Active la tarjeta « Sincronización Atlas » para este mundo Foundry, abra su ventana con el botón « Atlas » del directorio de actores y elija la campaña. Vincule un actor con un personaje existente o cree el personaje en Atlas e inicie la sincronización. Compruebe la ficha en Atlas.
Gestionar mis conexiones Atlas

Preparar valores y listas

El módulo puede guardar valores para reutilizarlos: un contador, un bonificador, un actor o una página elegidos. Abra « Variables y listas (avanzado) » en los ajustes del módulo, o « Variables y listas » en la ventana « Stream Deck » del módulo. La pestaña « Variables » contiene los valores; la pestaña « Listas de valores » contiene documentos ordenados como usted decida, por ejemplo sus PNJ o sus pistas. Estos ajustes no requieren Stream Deck ni suscripción.

Elija « Personal » para sus propios valores: cada usuario modifica los suyos. Un valor « Mundo » es compartido por todos los usuarios del mundo, pero solo el director de juego indicado en « Director responsable de las variables del mundo » puede modificarlo.

Una variable tiene un « Valor predeterminado » y un « Valor actual ». La lista de variables muestra el valor actual de cada una, y « Cambiar el valor actual » permite modificarlo a mano o restablecer el valor predeterminado. Una « Selección de una lista » empieza sin valor actual: después de guardarla, aplique « Restablecer el valor predeterminado ». Un « Valor calculado » se deduce de otras variables y no se modifica directamente.

En el campo « Expresión de cálculo », escriba una variable con la forma @{Nombre}. Después de una variable de documento, añada la ruta de un dato como en un efecto activo: si « Héroe destacado » corresponde a un personaje, @{Héroe destacado}.system.attributes.inspiration indica si tiene inspiración. La ruta depende del sistema de juego, y el dato solo se lee si puede ver el documento.

Para pasar valores a una macro de script, declare sus argumentos en « Macros compatibles (avanzado) ». Esta ventana no modifica el script: la macro debe leer esos argumentos y confirmar que ha terminado su ejecución.

Ver los ejemplos de Stream Deck

Comprobar el primer uso

Una vez activada una función, haga una primera prueba completa antes de la partida.

Crear una primera criatura

Abra Monstruos desde los ajustes de JDR Ninja o el directorio de actores, elija un perfil sencillo e inicie una generación. Revise la vista previa, cree el actor y abra después su ficha en Foundry para comprobar el resultado. Cada generación nueva cuenta para los límites de su cuenta.

Actualizar un personaje en Atlas

Modifique un personaje vinculado en Foundry y envíe después su ficha desde la ventana de Atlas. Abra su ficha en Atlas para comprobar el cambio antes de enviar toda la lista. Los cambios hechos en Atlas no vuelven a Foundry.

Ver una tirada pública en OBS

Haga en Foundry una tirada pública con dados y compare el resultado en el chat y en la fuente de OBS. Las tiradas privadas, ciegas y susurradas nunca se transmiten.

Probar una tecla de Stream Deck

Empiece con una tecla que abra una ficha y prepare después las teclas de una escena: activación, ambiente sonoro y oscuridad, cada comando en su propia tecla. La guía de Stream Deck ofrece a continuación ejemplos para la partida.

Preparar las teclas de una escena

Si usa los módulos anteriores

Desactive Atlas Character Sync o el módulo VTT Overlay anterior: mientras siga activo, la integración correspondiente del módulo JDR Ninja no está disponible. Cuando un director de juego abre el mundo, el módulo recupera el token, la dirección y la campaña de Atlas Character Sync; active después la sincronización con Atlas en la ventana « Conexiones de JDR Ninja ». No se recupera nada del módulo overlay anterior: vincule de nuevo su cuenta.

Una sincronización correcta con Atlas puede recuperar los vínculos de los actores existentes. Desconectar localmente borra el token guardado en el módulo, pero no lo revoca en el sitio. Use las páginas de gestión para revocar un dispositivo o una conexión.

En caso de problemas

La conexión caducó o se rechazó

Reinicie la conexión desde Foundry y use el nuevo código. Compruebe que autoriza el dispositivo y la cuenta correctos. Una solicitud cancelada o caducada no se puede reutilizar.

Mi cuenta está vinculada, pero una función sigue sin estar disponible

Compruebe el mensaje de esa función: autorización del dispositivo, suscripción, permisos de director de juego, compatibilidad y activación son requisitos distintos. Un token Atlas no da acceso a los generadores de D&D. Si se revocó el token, vincule el dispositivo de nuevo.

Los generadores rechazan mi versión de Foundry o D&D5e

El objetivo actual es Foundry V14 con D&D5e 5.3.3. La versión mínima para cargar el módulo y los sistemas aceptados por Atlas no cambian este requisito. Consulte la compatibilidad en la ventana del generador.

La sincronización con Atlas no se inicia

Compruebe su rol de director de juego, el interruptor Atlas del mundo, el sistema, el token del mundo correcto y el acceso a la sincronización. Desactive el módulo Atlas Character Sync anterior si sigue activo. La cuenta vinculada para el overlay no sustituye la conexión Atlas.

Los dados no aparecen en OBS

Compruebe el interruptor de la tarjeta « VTT Overlay » en este navegador, el overlay activo en el sitio, la fuente de navegador OBS y la suscripción. Haga una tirada pública con dados. Las tiradas privadas nunca se transmiten. Consulte la sección « Diagnóstico » de la ventana « VTT Overlay » y desactive el módulo overlay anterior si está activo.

Stream Deck no encuentra la sesión Foundry

Compruebe que la conexión local está iniciada en el mismo ordenador que el navegador Foundry y la aplicación Stream Deck, y que está activada en Foundry. Cuando Foundry se haya reconectado, seleccione de nuevo la sesión en las teclas afectadas. La guía de Stream Deck explica la clave de vinculación y las direcciones permitidas.