Ir al contenido principal

El módulo JDR Ninja para Foundry

Controle Foundry VTT con Stream Deck

Ejecute macros, cambie de escena y controle la música desde Stream Deck. El plugin JDR Ninja envía los comandos a Foundry VTT mediante un programa complementario en su ordenador.

En pocas palabras

Tres componentes conectan las teclas al navegador Foundry elegido: el plugin Stream Deck, el programa complementario local y el módulo JDR Ninja. Foundry ejecuta los comandos y comprueba los permisos del usuario conectado. El navegador debe permanecer abierto en el mismo ordenador que el programa complementario.

Comandos a mano

Asocie una tecla a una macro, escena o sonido que ya exista en su mundo.

La sesión y el usuario adecuados

Cada tecla conserva el mundo, usuario y navegador que haya elegido.

Compruebe el resultado

El plugin distingue los comandos completados de los rechazados y de los resultados inciertos.

Cómo se presenta

Estas capturas muestran los ajustes del módulo en un navegador Foundry real y el inspector de desarrollo del plugin. Ilustran la configuración local y no certifican hardware Stream Deck. El puerto temporal difiere del puerto predeterminado 19114 de la guía.

Activar la conexión en Foundry

En los ajustes del módulo, guarde la dirección del programa complementario y la clave local, luego active explícitamente Stream Deck en este navegador Foundry.

Ajustes Stream Deck del módulo JDR Ninja en Foundry: conexión local activa, interfaz francesa.

Configurar una tecla

El comando y sus campos dependen de la sesión elegida y los permisos del usuario Foundry.

Inspector de desarrollo JDR Ninja: comando Foundry y campos de configuración, interfaz francesa.

Cómo se conectan los componentes

  1. Plugin Stream Deck
  2. Programa complementario local
  3. Módulo JDR Ninja en el navegador Foundry

El programa complementario transmite los comandos entre ambos clientes en su ordenador. El servidor Foundry puede estar alojado en otro lugar. La clave local no requiere un token de cuenta JDR Ninja ni concede permisos adicionales en Foundry.

Comandos de la versión actual

Macros, escenas y pausa

Ejecute una macro autorizada, vea o active una escena, ajuste la oscuridad y pause la partida.

Música y documentos

Reproduzca o detenga un sonido, cambie de pista y ajuste el volumen. Abra una ficha de actor o página del diario, compártala con los destinatarios elegidos y saque un resultado de una tabla.

Fichas y combate

Seleccione, apunte u oculte fichas, ajuste sus barras nativas y avance los turnos de combate según sus permisos. Estas barras no aplican reglas de daño o curación específicas de cada sistema.

Requisitos

Necesita Foundry V14 o posterior con el módulo JDR Ninja activado, la aplicación Stream Deck con el plugin JDR Ninja y Node.js 24 para el programa complementario. Mantenga el navegador Foundry y el programa abiertos en el ordenador de Stream Deck. Cada tecla debe apuntar a una sesión elegida explícitamente.

Instalar el módulo Foundry

Variables, listas y argumentos de macro

Los comandos ordinarios usan valores fijos. Las opciones avanzadas permiten elegir una variable compatible, recorrer una lista y aportar argumentos a una macro que los declare en Foundry. Los valores y permisos se comprueban en cada pulsación.

Consultar las opciones avanzadas

Permisos y condiciones de acceso

Los comandos respetan los permisos Foundry de la sesión elegida. La prueba del overlay indica Premium y requiere conectar la cuenta, activar el overlay y verificar el acceso en el servidor. Las demás funciones tienen condiciones propias. No se ha anunciado un nivel general de suscripción para los comandos locales.

Preguntas frecuentes

¿Para qué sirve el programa complementario?

Transmite los comandos entre el plugin Stream Deck y los navegadores Foundry autorizados de su ordenador. Foundry ejecuta las acciones y comprueba los permisos.

¿Puede estar el servidor Foundry en otro lugar?

Sí. El navegador que abre la partida debe ejecutarse en el mismo ordenador que el programa complementario y Stream Deck.

¿Funcionan las teclas si cierro Foundry?

Los comandos necesitan un navegador Foundry abierto, conectado al programa complementario y listo. Al cerrarlo se termina su sesión.

¿Qué hago cuando Foundry vuelve a conectarse?

Seleccione de nuevo la sesión en sus teclas. Cada nueva conexión Foundry recibe una identidad nueva. Si solo se reconecta el plugin, puede recuperar una sesión Foundry que siga conectada.

¿Puede un jugador usar estos comandos?

Las acciones disponibles dependen de los permisos del usuario Foundry conectado. Una tecla no concede derechos adicionales ni cambia de usuario automáticamente.

¿Se necesita una suscripción JDR Ninja?

La prueba del overlay requiere acceso Premium verificado en Foundry. No se ha anunciado una suscripción general para los comandos locales. Los generadores y otras funciones tienen sus propias condiciones.

¿Qué dispositivos y plataformas se han validado?

Los ensayos de desarrollo usan un navegador Foundry real y un host Elgato simulado. Quedan pendientes el hardware Stream Deck, la instalación Windows/macOS y la conexión wss con certificado de confianza. No se anuncia compatibilidad general de hardware.

Preparar su primera tecla

Siga la guía para conectar los tres componentes y probar un comando sencillo.

El módulo JDR Ninja para Foundry