Ir al contenido principal

Stream Deck para Foundry VTT

Configurar Stream Deck con Foundry VTT

Conecte el plugin Stream Deck al módulo JDR Ninja, pruebe una primera tecla y prepare después teclas útiles para la partida: cambiar de escena, revelar pistas, seguir la tensión.

Qué puede preparar

Los ejemplos siguientes describen usos concretos durante la partida. Si su instalación ya funciona, vaya directamente al que le interese.

Requisitos

Prepare Foundry V14 o posterior, el módulo JDR Ninja activado, la aplicación Stream Deck, su plugin JDR Ninja y Node.js 24. El servidor Foundry puede ser remoto, pero abra Foundry en un navegador del ordenador donde funcione Stream Deck.

Instalar el módulo Foundry

Instalar el plugin

La distribución pública está en preparación. Si dispone de una versión de desarrollo, instale el archivo .streamDeckPlugin en la aplicación Stream Deck. Para configurar la conexión local, abra un terminal en el directorio stream-deck de las fuentes e instale las dependencias con el siguiente comando.

npm ci

Si ha recibido un archivo .tgz, extráigalo, abra un terminal en su carpeta y use este comando en su lugar. Node.js 24 debe instalarse por separado.

npm install --omit=dev --ignore-scripts

La conexión local permanece activa mientras este terminal esté abierto y no se inicia sola. Mantenga esta ventana abierta durante la partida.

Preparar la conexión local

Ejecute la inicialización con el primer comando. Indique la dirección exacta de Foundry tal como aparece en el navegador, como http://localhost:30000 o https://foundry.example.net, sin ruta ni barra final. Copie la clave de vinculación generada: la introducirá en Foundry y en el plugin. Después inicie la conexión local con el segundo comando.

npm run companion:init
npm run companion

La configuración se guarda en su perfil de usuario, en una de las rutas siguientes. La inicialización no sustituye un archivo existente. Para cambiar la dirección de Foundry, el puerto o la clave, detenga la conexión local con Ctrl+C, edite el archivo de configuración y reiníciela. Si cambia la clave, introduzca la nueva clave en Foundry y en el plugin.

  • Windows : %LOCALAPPDATA%\JDR Ninja\companion.json
  • macOS / Linux : ~/.config/jdr-ninja/companion.json

Conectar Foundry

En Foundry, abra la ventana « Conexiones de JDR Ninja » y haga clic en « Configurar Stream Deck » en la tarjeta de Stream Deck. Introduzca la dirección siguiente y la clave de vinculación y haga clic en « Guardar y activar »: este botón guarda la conexión y activa Stream Deck en este navegador. La tarjeta indica « Listo » cuando la conexión local está establecida.

ws://127.0.0.1:19114/jdr-ninja

Conectar el plugin Stream Deck

Añada la acción « Controlar Foundry » a una tecla. En su inspector, rellene « Dirección de conexión » con la dirección siguiente, pegue la misma « Clave de vinculación » y elija « Conectar ». Estos ajustes de conexión son comunes a todas las teclas. El campo de clave se vacía tras guardar.

ws://127.0.0.1:19114/stream-deck

Esta clave sirve únicamente para la conexión local entre Stream Deck y Foundry. Es distinta del token de conexión Atlas y de las credenciales de su cuenta JDR Ninja. No pegue ninguna de esas otras credenciales en el campo « Clave de vinculación ».

Elegir la sesión Foundry

En « Mundo y navegador de Foundry », elija el mundo, usuario y navegador deseados. Espere a « Listo » y a que aparezcan los comandos y documentos autorizados. Cada tecla guarda su sesión, comando y parámetros; nunca cambia automáticamente de mundo, usuario o navegador.

Crear y probar el primer comando

En « Comando », elija « Abrir actor » y un actor cuya ficha pueda abrir. Pulse la tecla una vez. Compruebe la ficha en Foundry y el resultado « Completado. » en el inspector. Un comando admitido puede seguir esperando su ejecución.

Si un resultado es incierto, la tecla puede mostrar brevemente « ? ». Compruebe qué ha ocurrido en Foundry antes de pulsar de nuevo. La sección siguiente explica cómo preparar teclas útiles para la partida.

Reutilizar sus teclas durante la partida

Estos ejemplos empiezan con teclas fijas y después introducen una noción cada vez: una lista para elegir entre varios documentos, una variable para guardar un valor, un comando combinado para modificar un valor antes de actuar en Foundry, argumentos para sus macros y la modificación directa de un campo de la ficha. Los dos últimos ejemplos combinan esta modificación con las variables: revelar páginas de diario de forma definitiva y mostrar la tensión a los jugadores. Solo el ejemplo de las macros requiere un script. Las variables y las listas se crean en Foundry; los comandos que las usan aparecen en la lista « Comando » precedidos de « Avanzado · », igual que « Actualizar un documento ».

Preparar los comandos de su próxima escena

Sus jugadores salen de la posada hacia la cripta. Prepare tres teclas para este cambio de lugar: la primera activa la escena, la segunda inicia su ambiente sonoro y la tercera oscurece la iluminación.

Antes de empezar

Conéctese como director de juego: estos tres comandos le están reservados. El mundo ya contiene la escena y una lista de reproducción con la pista de audio deseada.

En Foundry

No hace falta ningún ajuste del módulo: estos comandos usan valores fijos, elegidos directamente en el inspector.

En Stream Deck

Preparar los comandos de su próxima escena
Tecla Comando Ajustes
Ir a la cripta Activar escena « Documento »: la escena de la cripta.
Ambiente de la cripta Reproducir o detener sonido « Documento »: la pista de audio. « Reproducir sonido »: Sí (el valor propuesto es No, que detiene la pista).
Oscurecer Ajustar oscuridad « Documento »: la escena de la cripta. « Valor »: un número de 0 (pleno día) a 1 (oscuridad total), por ejemplo 0,7.

Probar y volver al punto de partida

Pulse las tres teclas en orden: la escena de la cripta se muestra a los jugadores, la pista empieza a sonar y la iluminación baja. La tecla de oscuridad muestra, en porcentaje, la oscuridad de la escena abierta en su navegador. Para volver al punto de partida, añada una tecla « Reproducir o detener sonido » con « Reproducir sonido » en No, y una tecla de oscuridad con el valor 0.

Conviene saber

« Activar escena » muestra la escena a todos los jugadores. « Ver escena » solo cambia su propia vista: así puede preparar lo que sigue sin que los jugadores lo vean. Las tres acciones siguen siendo independientes: para encadenarlas en una misma tecla hace falta una macro que las contenga.

Recorrer sus PNJ con las mismas teclas

En la posada, sus jugadores interrogan a varios PNJ. Dos teclas permiten pasar de un PNJ a otro y una tercera abre la ficha del PNJ elegido. La tecla de apertura sirve para toda la lista: añadir o reordenar PNJ no exige ningún cambio en Stream Deck.

Antes de empezar

Cualquier usuario puede seguir este ejemplo con sus variables personales. El mundo ya contiene tres actores cuya ficha puede abrir.

En Foundry

  1. Abra « Variables y listas (avanzado) » en los ajustes del módulo y elija « Personal ». En la pestaña « Listas de valores », cree la lista « PNJ de la posada » de tipo « Actor ». Para cada PNJ, haga clic en « Añadir entrada », escriba una « Etiqueta » y seleccione el actor entre las sugerencias del campo « UUID del documento (referencia específica) ». Guarde.
  2. En la pestaña « Variables », cree « PNJ elegido »: « Tipo de valor » en « Actor », « Definición » en « Selección de una lista », « Lista asociada » en « PNJ de la posada » y el primer PNJ como « Valor predeterminado ». Marque « Volver al inicio tras la última entrada » si la lista debe empezar de nuevo después del último PNJ. Guarde.
  3. Una selección nueva aún no tiene valor actual. En « Cambiar el valor actual », elija « Restablecer el valor predeterminado » y después « Aplicar ».

En Stream Deck

Recorrer sus PNJ con las mismas teclas
Tecla Comando Ajustes
PNJ anterior Entrada anterior « Variable (avanzado) »: PNJ elegido.
PNJ siguiente Entrada siguiente « Variable (avanzado) »: PNJ elegido.
Abrir el PNJ Abrir actor « Actor »: « Origen del valor » en « Variable (avanzado) », y después la variable PNJ elegido.

Probar y volver al punto de partida

Pulse « Abrir el PNJ »: se abre la ficha del primer PNJ. Pulse « PNJ siguiente » y después « Abrir el PNJ » de nuevo: ahora se abre la ficha del segundo. El PNJ elegido aparece en la ventana « Variables y listas (avanzado) » y bajo « Vista del valor actual » en el inspector. Para volver al primer PNJ, añada una tecla « Restablecer variable » sobre la misma variable.

Conviene saber

Las teclas no muestran ni el retrato ni el nombre del PNJ elegido: compruebe la selección en Foundry o en el inspector. Si la lista no vuelve al inicio, « Entrada siguiente » no cambia nada en el último PNJ.

Revelar las pistas en orden

Sus jugadores investigan en la cripta y usted quiere mostrarles tres pistas en el orden previsto. Después de la primera pista, basta una tecla para pasar a la pista siguiente y mostrarla a sus jugadores, sin macro.

Antes de empezar

Conéctese como director de juego: mostrar una página está reservado al director de juego, que además debe ser su propietario. Prepare tres páginas de diario, una por pista, y dé a los jugadores al menos el permiso de Observador sobre cada una. Los jugadores deben estar conectados para recibir la página.

En Foundry

  1. En « Variables y listas (avanzado) », elija « Personal »: basta para sus propias teclas. Cree la lista « Pistas de la cripta » de tipo « Página de diario » y añada las tres páginas en el orden en que quiera mostrarlas.
  2. Cree la variable « Pista actual »: « Tipo de valor » en « Página de diario », « Definición » en « Selección de una lista », esa lista como « Lista asociada » y la primera página como « Valor predeterminado ». Deje « Volver al inicio tras la última entrada » sin marcar.
  3. Guarde y después aplique « Restablecer el valor predeterminado » en « Cambiar el valor actual ».

En Stream Deck

Revelar las pistas en orden
Tecla Comando Ajustes
Pista anterior Entrada anterior « Variable (avanzado) »: Pista actual.
Pista siguiente Entrada siguiente « Variable (avanzado) »: Pista actual.
Mostrar la pista Compartir página del diario « Documento »: « Origen del valor » en « Variable (avanzado) », y después la variable Pista actual. « Destinatarios »: Jugadores.
Pista siguiente y mostrar Cambiar variables y ejecutar comando « Añadir cambio de variable »: « Operación » en « Entrada siguiente » (el valor propuesto es « Invertir variable »), « Variable (avanzado) » en Pista actual. « Comando de Foundry »: « Compartir página del diario », con los mismos ajustes que « Mostrar la pista ».

Probar y volver al punto de partida

Pruebe primero por separado las tres primeras teclas para comprobar la selección y los destinatarios. Durante la partida, muestre la primera pista con « Mostrar la pista » y utilice después « Pista siguiente y mostrar »: en cada pulsación, la página siguiente se selecciona y se muestra a los jugadores conectados. Empezar por la tecla combinada haría saltarse la primera pista. Para repetir la investigación, aplique « Restablecer el valor predeterminado »: la pista actual vuelve a ser la primera, pero las páginas ya mostradas no se retiran a los jugadores y sus permisos no cambian.

Conviene saber

Después de la última pista, la tecla combinada ya no cambia de página y vuelve a mostrar la última. Si un jugador no tiene el permiso de Observador, el comando se rechaza y la pista actual no cambia. La opción « Mostrar sin cambiar permisos » muestra la página una vez sin modificar esos permisos.

Anunciar el nivel de tensión

En una partida de terror, usted sube la tensión cuando la situación empeora. Una tecla suma 1 al contador y anuncia el nuevo nivel en el chat, por ejemplo « Tensión: 3 / 6 ». Usted decide cuándo pulsar: ningún evento del juego sube el contador por sí solo.

Antes de empezar

Cualquier usuario puede crear esta variable personal y escribir en el chat. No hace falta ningún documento.

En Foundry

En « Variables y listas (avanzado) », en « Personal », cree la variable « Tensión »: « Tipo de valor » en « Número », « Definición » en « Valor guardado », « Mínimo » 0, « Máximo » 6, « Valor predeterminado » y « Valor actual » 0. Marque « Limitar aumentos y reducciones a los límites ». Guarde.

En Stream Deck

Anunciar el nivel de tensión
Tecla Comando Ajustes
Subir la tensión Aumentar variable « Variable (avanzado) »: Tensión. « Cambio »: 1 (el valor propuesto es 0, que no cambia nada).
Bajar la tensión Reducir variable « Variable (avanzado) »: Tensión. « Cambio »: 1.
Poner a cero Restablecer variable « Variable (avanzado) »: Tensión.
Subir y anunciar Cambiar variables y ejecutar comando Un cambio de variable « Aumentar variable » en Tensión, « Cambio » 1. « Comando de Foundry »: « Enviar mensaje al chat ». « Mensaje del chat »: « Origen del valor » en « Componer texto (avanzado) », y después tres partes en este orden: el texto « Tensión: » seguido de un espacio, la variable Tensión y el texto « / 6 » precedido de un espacio.

Probar y volver al punto de partida

Compruebe primero las tres primeras teclas: el valor de Tensión cambia en la ventana « Variables y listas (avanzado) ». Después, con el contador en 2, pulse « Subir y anunciar »: el contador pasa a 3 y el chat muestra « Tensión: 3 / 6 ». El mensaje es público y se envía en su nombre. « Poner a cero » devuelve el contador a 0 sin retirar los mensajes ya enviados.

Conviene saber

Al llegar al máximo, el contador se queda en 6, pero el mensaje se envía igualmente. Si falla el envío del mensaje, el nuevo valor puede quedar guardado y la tecla muestra « ! »: compruebe el contador y el chat en Foundry antes de pulsar de nuevo.

Hacer una tirada con un bonificador variable

Un aliado ayuda al personaje o una posición elevada facilita su disparo: el bonificador cambia de una escena a otra. Guarde ese bonificador en una variable y una sola tecla tirará entonces 1d20 más el bonificador actual. Cada pulsación usa el valor del momento.

Antes de empezar

Cualquier usuario puede tirar dados y crear sus variables personales. No hace falta ningún documento.

En Foundry

En « Personal », cree la variable « Bonificador de situación »: « Tipo de valor » en « Número », « Definición » en « Valor guardado », « Mínimo » 0, « Máximo » 5, « Valor predeterminado » y « Valor actual » 0. Marque « Limitar aumentos y reducciones a los límites ». Guarde.

En Stream Deck

Hacer una tirada con un bonificador variable
Tecla Comando Ajustes
Aumentar el bonificador Aumentar variable « Variable (avanzado) »: Bonificador de situación. « Cambio »: 1.
Reducir el bonificador Reducir variable « Variable (avanzado) »: Bonificador de situación. « Cambio »: 1.
Bonificador a cero Restablecer variable « Variable (avanzado) »: Bonificador de situación.
Tirada con bonificador Tirar dados « Expresión de dados »: « Origen del valor » en « Componer texto (avanzado) », y después el texto « 1d20 + » y la variable Bonificador de situación. « Visibilidad de la tirada »: « Solo yo » para practicar.

Probar y volver al punto de partida

Elija el comando « Tirar dados » en la acción « Controlar Foundry »: la acción de Stream Deck del mismo nombre es otra distinta, pensada para el overlay. Pulse « Tirada con bonificador »: el resultado aparece en el chat de Foundry, solo para usted. Aumente el bonificador dos veces y pulse de nuevo: la tirada usa 1d20 + 2. Cuando la mesa deba ver la tirada, elija « Todos ». « Bonificador a cero » devuelve el bonificador a 0.

Conviene saber

Es una tirada de dados genérica: no sustituye las tiradas de ataque o de daño de su sistema de juego, y la variable no sigue ninguna característica del actor. La expresión admite dados, números y operaciones simples, pero no modificadores como « kh »: una tirada « 2d20kh1 » se rechaza.

Pasar valores a una macro

Ya tiene una macro de script que actúa sobre un actor según una cantidad. En lugar de copiarla para cada caso, declare sus argumentos: cada tecla ejecuta la misma macro con su propio actor y su propia cantidad.

Antes de empezar

Es el único ejemplo que requiere un script. La macro debe ser una macro de script de la que usted sea propietario y que pueda ejecutar. El módulo no proporciona ninguna macro lista para usar y no modifica su script.

En Foundry

  1. Abra « Macros compatibles (avanzado) », elija la macro y después « Configurar macro ». Con « Añadir argumento », declare por ejemplo « objetivo » de tipo « Actor » y « cantidad » de tipo « Número ». El nombre de un argumento empieza por una letra y no contiene acentos ni espacios. Marque « Obligatorio », o bien marque « Usar un valor predeterminado » e indique el « Valor predeterminado ». Haga clic después en « Guardar ».
  2. En el script, lea los valores en scope.jdrNinja.arguments. Un documento se transmite como UUID; un número, un texto o un booleano se transmite tal cual.
  3. Termine el script con la línea de confirmación que muestra la ventana « Macros compatibles (avanzado) ». Sin ella, la tecla indica un resultado incierto, aunque la macro haya funcionado.

En Stream Deck

Pasar valores a una macro
Tecla Comando Ajustes
Primer caso Ejecutar macro « Documento »: su macro. Marque « Argumentos de macro (Avanzado) » y después « objetivo »: un primer actor y « cantidad »: 2.
Segundo caso Ejecutar macro La misma macro, con « cantidad »: 5. Para « objetivo », establezca « Origen del valor » en « Variable (avanzado) » y elija después la variable PNJ elegido: la macro actúa entonces sobre el PNJ seleccionado en el ejemplo de los PNJ.

Probar y volver al punto de partida

Pulse cada tecla y compruebe en Foundry el efecto de la macro sobre el actor correspondiente. El inspector muestra « Completado. » una vez recibida la confirmación. Volver al estado inicial depende de lo que haga su macro: el módulo no deshace nada.

Conviene saber

La ventana de declaración no crea ningún script: solo describe los valores esperados. Una macro sin argumentos declarados no los recibe, y el inspector pide entonces elegir una macro que declare argumentos compatibles en Foundry.

Dar la inspiración

Uno de sus jugadores acaba de lograr una hazaña y merece la inspiración. En una partida de D&D5e, una sola tecla activa la inspiración en la ficha de su personaje; una segunda pulsación la desactiva.

Antes de empezar

El director de juego puede dar la inspiración a cualquier jugador. Un jugador solo puede hacerlo con un personaje del que sea propietario: en los demás casos, Foundry rechaza el cambio. El mundo usa el sistema D&D5e.

En Foundry

Si aún no lo ha hecho, asigne su personaje al jugador en la configuración del usuario de Foundry: la tecla actúa sobre ese personaje asignado. No hace falta ningún otro ajuste del módulo.

En Stream Deck

Dar la inspiración
Tecla Comando Ajustes
Inspiración Actualizar un documento « Documento » en « Personaje asignado al jugador », y después « Usuario de Foundry »: el jugador en cuestión. « Añadir cambio »: « Ruta del campo » system.attributes.inspiration, « Operación » en « Invertir verdadero/falso ».

Probar y volver al punto de partida

Abra la ficha del personaje en Foundry y pulse « Inspiración »: la ficha muestra que el personaje tiene la inspiración. Pulse de nuevo: la inspiración se retira y la ficha vuelve a su estado inicial. Cada pulsación invierte el estado actual: si el personaje ya tenía la inspiración, la primera pulsación se la quita.

Conviene saber

La ruta system.attributes.inspiration es propia de D&D5e: otros sistemas de juego usan otros campos, y el módulo no comprueba la ruta introducida. Si el campo no existe, la tecla muestra una alerta y el inspector indica que un campo no tiene el tipo esperado.

Revelar las pistas de forma definitiva

En « Revelar las pistas en orden », la tecla muestra una página que los jugadores ya tienen permiso para abrir. Aquí, cada página de pista permanece oculta en su diario hasta que usted la revele: una tecla revela la pista actual y otra pasa a la pista siguiente y la revela, sin macro.

Antes de empezar

Conéctese como director de juego: Foundry rechaza que un jugador cambie el permiso de una página. Necesita la lista « Pistas de la cripta » y la variable « Pista actual » del ejemplo « Revelar las pistas en orden »: créelas primero siguiendo sus pasos « En Foundry ».

En Foundry

  1. Dé a los jugadores el permiso de Observador sobre el diario que contiene las páginas de pistas: sin este permiso, ese diario no aparece en la pestaña Diario de los jugadores.
  2. Abra la configuración de permisos de cada página de pista y ponga el permiso de los jugadores en Ninguno, de forma explícita: una página recién creada hereda el permiso del diario y sería visible para ellos. Este ajuste sustituye el permiso de Observador que pide el ejemplo « Revelar las pistas en orden ».

En Stream Deck

Revelar las pistas de forma definitiva
Tecla Comando Ajustes
Revelar la pista actual Actualizar un documento « Documento »: « Origen del valor » en « Variable (avanzado) », y después la variable Pista actual. « Añadir cambio »: « Ruta del campo » ownership.default, « Operación » en « Asignar un valor », « Tipo de valor » en « Número », y después « Valor » 2, que corresponde al nivel Observador.
Revelar la pista siguiente Cambiar variables y ejecutar comando « Añadir cambio de variable »: « Operación » en « Entrada siguiente » (el valor propuesto es « Invertir variable »), « Variable (avanzado) » en Pista actual. « Comando de Foundry »: « Actualizar un documento », con los mismos ajustes que « Revelar la pista actual ».
Ocultar la pista Actualizar un documento Opcional. Los mismos ajustes que « Revelar la pista actual », pero con el valor 0, que corresponde a Ninguno: la tecla oculta la pista actual. El valor -1 haría visible la página, porque heredaría el permiso de Observador del diario.

Probar y volver al punto de partida

Pulse « Revelar la pista actual »: la primera pista aparece en el diario de los jugadores y las demás páginas siguen ocultas. Pulse después « Revelar la pista siguiente »: en cada pulsación, la pista actual pasa a la página siguiente, que se revela. Empezar por la tecla combinada haría saltarse la primera pista. El diario de los jugadores y las ventanas de diario que tengan abiertas se actualizan al instante, sin recargar, y las páginas reveladas permanecen en su diario. Para repetir la investigación, vuelva a poner cada página de pista en Ninguno en Foundry y aplique después « Restablecer variable » a Pista actual.

Conviene saber

En la última pista, la tecla combinada no cambia nada. « Restablecer variable » devuelve la pista actual a la primera, pero no oculta las páginas ya reveladas. Si un jugador pulsa estas teclas, Foundry rechaza el cambio. Un comando combinado ejecuta un solo comando de Foundry: revelar una página y mostrarla a los jugadores con « Compartir página del diario » requiere dos teclas. Una página oculta lo está solo en la interfaz de los jugadores: su contenido ya está en su navegador, así que no es un secreto.

Mostrar la tensión a los jugadores

En « Anunciar el nivel de tensión », el nivel se anuncia en el chat. Aquí lo muestra en el nombre de un diario que los jugadores ven en su lista de diarios: una tecla sube la tensión y cambia el nombre del diario, por ejemplo « Tensión: 3 / 6 ». Usted decide cuándo pulsar.

Antes de empezar

Conéctese como director de juego: Foundry rechaza que un jugador cambie el nombre de un diario que no le pertenece. Necesita la variable « Tensión » del ejemplo « Anunciar el nivel de tensión »: créela primero con su paso « En Foundry ».

En Foundry

Cree un diario llamado « Tensión » y dé a los jugadores el permiso de Observador sobre ese diario: sin este permiso, no aparece en la pestaña Diario de los jugadores.

En Stream Deck

Mostrar la tensión a los jugadores
Tecla Comando Ajustes
Subir y mostrar Cambiar variables y ejecutar comando Un cambio de variable « Aumentar variable » en Tensión, « Cambio » 1. « Comando de Foundry »: « Actualizar un documento ». « Documento »: el diario « Tensión », elegido en la lista. « Añadir cambio »: « Ruta del campo » name, « Operación » en « Asignar un valor », « Tipo de valor » en « Componer texto (avanzado) », y después tres partes en este orden: el texto « Tensión: » seguido de un espacio, la variable Tensión y el texto « / 6 » precedido de un espacio.

Probar y volver al punto de partida

Con el contador en 2, pulse « Subir y mostrar »: el contador pasa a 3 y el diario cambia de nombre a « Tensión: 3 / 6 », y el nuevo nombre aparece al instante en la pestaña Diario de cada jugador, sin recargar. Para volver al punto de partida, ponga el contador a cero con la tecla « Poner a cero » del ejemplo « Anunciar el nivel de tensión » y cambie después el nombre del diario a « Tensión » en Foundry.

Conviene saber

Al llegar al máximo, el contador se queda en 6 y el nombre del diario no cambia. La tecla cambia el nombre del diario mismo y no el de una de sus páginas: la lista de diarios muestra el nombre de los diarios, mientras que el nombre de una página solo aparece dentro del diario abierto.

Crear variables y listas en Foundry

Después de una reconexión

Cuando el navegador Foundry se reconecta, aparece como una sesión nueva. Selecciónela de nuevo en cada tecla afectada, también tras reiniciar la conexión local. Si solo se reconecta el plugin, puede recuperar una sesión Foundry que siga conectada. Si pulsa Ctrl+C en el terminal, la conexión local se detiene y las sesiones en curso se interrumpen.

Solución de problemas

  • Sin conexión: compruebe que la ventana del terminal sigue abierta, que las direcciones introducidas son las indicadas en esta guía y que Foundry y el plugin usan la misma clave.
  • Foundry rechazado o ausente: compruebe el origen exacto permitido en companion.json y el interruptor de la tarjeta Stream Deck en este navegador. Otra dirección de servidor cambia el origen.
  • Foundry en HTTPS: el navegador puede exigir wss y un certificado local de confianza. Configure tlsCert y tlsKey con rutas absolutas a archivos PEM y use wss en Foundry y en el plugin. El certificado debe cubrir la dirección local y ser de confianza para el navegador Foundry y para Stream Deck. No se instala automáticamente.
  • Sesión ausente o sincronizando: espere a que esté lista y vuelva a seleccionar mundo, usuario y navegador en la tecla.
  • Comando rechazado o documento ausente: compruebe los permisos de la cuenta Foundry y el documento elegido. Seleccionar una sesión no concede más derechos.
  • Prueba del overlay no disponible: compruebe la conexión de la cuenta JDR Ninja, la activación del overlay y la verificación Premium. La clave local no confirma ese acceso.
  • Resultado incierto o parcial: compruebe la ficha, escena, variables o combate afectados en Foundry antes de pulsar de nuevo. Una interrupción puede ocurrir después de ejecutar. El plugin no reintenta automáticamente.

Preguntas frecuentes

¿Por qué desaparece la clave del campo?

El plugin vacía el campo tras guardar para no mostrar la clave almacenada. No significa que se haya eliminado la conexión.

¿Por qué debo volver a elegir la sesión?

La reconexión Foundry crea una identidad nueva. Las teclas conservan su elección anterior para evitar enviar comandos a otro mundo, usuario o navegador.

¿Puedo repetir un comando con resultado incierto?

Compruebe primero Foundry. El comando puede haberse ejecutado pese a la interrupción. Cada nueva pulsación es un comando nuevo.

¿Puede una tecla mostrar el valor de una variable?

No. Las teclas muestran el estado de la pausa, el nivel de oscuridad, la barra de recurso de una ficha o, brevemente, el resultado de un comando. El valor de una variable o el PNJ elegido se consultan en Foundry o en el inspector.

Stream Deck para Foundry VTT El módulo JDR Ninja para Foundry