Ir al contenido principal

El módulo JDR Ninja para Foundry

Controle Foundry VTT con Stream Deck

Controle sus fichas de personaje desde su Stream Deck.

Active una escena, muestre una pista, haga una tirada o modifique directamente la ficha de un personaje desde Stream Deck. El plugin JDR Ninja envía sus comandos a Foundry VTT, y las variables le permiten reutilizar las mismas teclas durante toda la partida.

Modificar sus fichas de personaje

Una tecla puede cambiar cualquier campo que Foundry le permita modificar: la inspiración de un personaje, sus puntos de vida, su moneda, las cargas de un objeto, el nombre de una página de diario. Hasta 16 campos cambian en una sola actualización.

  • Cinco operaciones: asignar un valor, aumentar, reducir, invertir verdadero/falso, quitar un campo.
  • El objetivo que usted elija: un documento concreto, el personaje asignado a un jugador, la ficha seleccionada o su actor, o un documento indicado por una variable.
  • Valores fijos o tomados de sus variables: un bonificador, un contador, un texto compuesto.
  • Se aplican sus permisos de Foundry: el director de juego puede modificarlo todo, un jugador solo lo que le pertenece.
  • Los campos dependen del sistema de juego: usted indica su ruta, por ejemplo system.attributes.inspiration en D&D5e. El módulo no comprueba esa ruta.

Ejemplos para su próxima partida

Cada ejemplo indica lo que utiliza y remite a su configuración paso a paso en la guía.

Comandos de Foundry

Cambiar de lugar con tres teclas

Active la escena siguiente, inicie su ambiente sonoro y ajuste su oscuridad, cada comando en su propia tecla.

Ver el ejemplo paso a paso

Variables: lista y comando combinado

Revelar las pistas en orden

Una lista de páginas y un comando combinado: pase a la pista siguiente y muéstrela a sus jugadores conectados, sin macro.

Ver el ejemplo paso a paso

Variables: contador y texto compuesto

Anunciar el nivel de tensión

Un contador de 0 a 6 guardado en una variable: súbalo y anuncie su nuevo valor en el chat.

Ver el ejemplo paso a paso

Actualización de documentos

Dar la inspiración

Active o retire la inspiración en la ficha del personaje de un jugador, sin abrirla.

Ver el ejemplo paso a paso

Los comandos

El plugin ofrece 40 comandos: 31 para Foundry VTT, incluida la actualización de documentos, y 9 para las variables. Cada comando respeta los permisos del usuario Foundry conectado, y los comandos marcados DJ están reservados al director de juego.

Variables y listas

Una lista de PNJ o de pistas, un contador, un bonificador: con las variables y las listas creadas en Foundry, unas pocas teclas bastan para toda la partida. Un comando combinado modifica un valor y después ejecuta una acción, por ejemplo pasar a la pista siguiente y mostrarla. Los valores y los permisos se comprueban en cada pulsación.

Asignar variable
Asigna un nuevo valor a la variable.
Elegir entrada de lista
Elige una entrada concreta de la lista asociada.
Entrada siguiente
Avanza una entrada en la lista y puede volver al principio después de la última.
Entrada anterior
Retrocede una entrada en la lista.
Aumentar variable
Suma una cantidad al número, dentro de los límites fijados.
Reducir variable
Resta una cantidad del número, dentro de los límites fijados.
Invertir variable
Cambia sí por no, o no por sí.
Restablecer variable
Devuelve a la variable su valor predeterminado.
Cambiar variables y ejecutar comando
Aplica hasta 16 cambios y después ejecuta un comando de Foundry.
  • Tres formas de definir una variable: un valor guardado, una selección de una lista o un valor calculado. Un cálculo puede usar otras variables y los campos de un documento, como la inspiración de un personaje.
  • Trece tipos de valor: número, texto, sí o no, actor, ficha, escena, diario, página de diario, macro, lista de reproducción, pista de audio, tabla aleatoria y combate.
  • Variables personales para sus propias teclas, o comunes a toda la mesa y gestionadas por el director de juego.
  • En cada campo de un comando, el valor puede proceder de una variable, de un texto compuesto por partes fijas y variables, del personaje asignado a un jugador o de la ficha seleccionada.
  • Argumentos para sus macros de script: hasta 16 valores declarados por macro, con un valor distinto en cada tecla.

Las variables se guardan en los ajustes de Foundry, no en el navegador.

game.settings flags.jdr-ninja.arguments

Ver los ejemplos

Los comandos de Foundry VTT

Cada comando llama a una función de Foundry VTT, indicada bajo su nombre: es Foundry quien actúa, con sus propias reglas y los permisos de su usuario.

Actores y macros

  • Abrir actor

    Actor#sheet.render()
  • Ejecutar macro

    Macro#execute()

Escenas

  • Ver escena

    Scene#view()
  • Activar escena DJ

    Scene#activate()
  • Precargar escena DJ

    game.scenes.preload()
  • Ajustar oscuridad DJ

    Scene#update({ darknessLevel })

Diarios

  • Abrir página del diario

    JournalEntry#sheet.render()
  • Compartir página del diario DJ

    Journal.show()

Música y sonidos

  • Reproducir o detener sonido DJ

    Playlist#playSound() / stopSound()
  • Cambiar pista DJ

    Playlist#playNext()
  • Detener música DJ

    Playlist#stopAll()
  • Ajustar volumen DJ

    PlaylistSound#update({ volume })

Partida e interfaz

  • Pausar o continuar DJ

    game.togglePause()
  • Abrir pestaña

    ui.sidebar.changeTab()
  • Elegir herramienta

    ui.controls.activate()

Dados, tablas y chat

  • Tirar dados

    Roll#toMessage()
  • Sacar de tabla

    RollTable#draw()
  • Enviar mensaje al chat

    ChatMessage.create()

Fichas y estados

  • Seleccionar ficha

    Token#control()
  • Apuntar a ficha

    Token#setTarget()
  • Ocultar o mostrar ficha DJ

    TokenDocument#update({ hidden })
  • Modificar recurso de ficha

    Actor#modifyTokenAttribute()
  • Aplicar o quitar estado

    Actor#toggleStatusEffect()

Combate

  • Iniciar combate DJ

    Combat#startCombat()
  • Terminar combate DJ

    DialogV2.confirm() + Combat#delete()
  • Siguiente turno DJ

    Combat#nextTurn()
  • Turno anterior DJ

    Combat#previousTurn()
  • Siguiente ronda DJ

    Combat#nextRound()
  • Tirar iniciativa DJ

    Combat#rollAll()

Overlay

  • Probar overlay

    Servidor de JDR Ninja, acceso Premium

« Modificar recurso de ficha » solo cambia la barra de recurso de la ficha: no gestiona el daño ni la curación según las reglas de cada sistema. « Terminar combate » pide una confirmación en Foundry.

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 la ventana « Stream Deck » del módulo, introduzca la dirección de conexión y la clave de vinculación y haga clic en « Guardar y activar ».

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 comunica Stream Deck con Foundry

  1. Plugin Stream Deck
  2. Módulo JDR Ninja en el navegador Foundry

El plugin Stream Deck envía sus comandos al módulo JDR Ninja mediante una conexión local, en el navegador Foundry que haya elegido. Foundry ejecuta los comandos y comprueba los permisos del usuario conectado. Ese navegador debe permanecer abierto en el mismo ordenador que Stream Deck, pero el servidor Foundry puede estar alojado en otro lugar. La conexión local usa su propia clave de vinculación: no requiere ningún token de cuenta JDR Ninja y no sustituye ningún permiso de Foundry.

Cada tecla permanece vinculada al mundo, al usuario y al navegador que haya elegido. El plugin distingue un comando completado de uno rechazado o de resultado incierto. Si el resultado es incierto, compruebe Foundry antes de pulsar de nuevo.

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 la conexión local. Cada tecla debe apuntar a una sesión elegida explícitamente.

Instalar el módulo Foundry

Permisos y condiciones de acceso

Common.Free

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é sirven las variables?

Guardan un valor en Foundry: el PNJ elegido, la pista actual, un contador o un bonificador. Una tecla usa el valor del momento, y el comando « Cambiar variables y ejecutar comando » lo modifica y después actúa en Foundry.

¿Puede estar el servidor Foundry en otro lugar?

Sí. Sin embargo, el navegador que abre la partida debe ejecutarse en el mismo ordenador que Stream Deck.

¿Funcionan las teclas si cierro Foundry?

No. Solo funcionan si hay un navegador Foundry abierto, conectado a la partida y listo para recibir comandos. Si cierra ese navegador, la sesión se interrumpe.

¿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.

¿Puedo modificar cualquier campo de una ficha de personaje?

Sí, si Foundry le permite modificar ese documento: el director de juego puede modificarlo todo, un jugador solo lo que le pertenece. La ruta del campo depende del sistema de juego y el módulo no la comprueba. Foundry ignora un campo que no existe, y un aumento o una inversión sobre ese campo se señala en la tecla.

Preparar su primer comando

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

El módulo JDR Ninja para Foundry