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.
El módulo JDR Ninja para Foundry
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.
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.
Con las variables, una tecla también puede:
Cada ejemplo indica lo que utiliza y remite a su configuración paso a paso en la guía.
Comandos de Foundry
Active la escena siguiente, inicie su ambiente sonoro y ajuste su oscuridad, cada comando en su propia tecla.
Variables: lista y comando combinado
Una lista de páginas y un comando combinado: pase a la pista siguiente y muéstrela a sus jugadores conectados, sin macro.
Variables: contador y texto compuesto
Un contador de 0 a 6 guardado en una variable: súbalo y anuncie su nuevo valor en el chat.
Actualización de documentos
Active o retire la inspiración en la ficha del personaje de un jugador, sin abrirla.
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.
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.
Las variables se guardan en los ajustes de Foundry, no en el navegador.
game.settings
flags.jdr-ninja.arguments
Document#update()
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.
Abrir actor
Actor#sheet.render()
Ejecutar macro
Macro#execute()
Ver escena
Scene#view()
Activar escena DJ
Scene#activate()
Precargar escena DJ
game.scenes.preload()
Ajustar oscuridad DJ
Scene#update({ darknessLevel })
Abrir página del diario
JournalEntry#sheet.render()
Compartir página del diario DJ
Journal.show()
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 })
Pausar o continuar DJ
game.togglePause()
Abrir pestaña
ui.sidebar.changeTab()
Elegir herramienta
ui.controls.activate()
Tirar dados
Roll#toMessage()
Sacar de tabla
RollTable#draw()
Enviar mensaje al chat
ChatMessage.create()
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()
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()
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.
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.
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 ».
El comando y sus campos dependen de la sesión elegida y los permisos del usuario 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.
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.
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.
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.
Sí. Sin embargo, el navegador que abre la partida debe ejecutarse en el mismo ordenador que Stream Deck.
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.
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.
Las acciones disponibles dependen de los permisos del usuario Foundry conectado. Una tecla no concede derechos adicionales ni cambia de usuario automáticamente.
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.
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.
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.
Siga la guía para conectar los tres componentes y probar un comando sencillo.