Aller au contenu principal

Stream Deck pour Foundry VTT

Configurer Stream Deck avec Foundry VTT

Connectez le plugin Stream Deck au module JDR Ninja, testez une première touche, puis préparez des touches utiles en partie : changer de scène, révéler des indices, suivre la tension.

Ce que vous pouvez préparer

Les exemples ci-dessous décrivent des usages concrets en partie. Si votre installation fonctionne déjà, passez directement à celui qui vous intéresse.

Ce qu’il vous faut

Préparez Foundry V14 ou ultérieur, le module JDR Ninja activé, l’application Stream Deck, son plugin JDR Ninja et Node.js 24. Le serveur Foundry peut être distant, mais ouvrez Foundry dans un navigateur de l’ordinateur où fonctionne Stream Deck.

Installer le module Foundry

Installer le plugin

La distribution publique est en préparation. Si vous disposez d’une version de développement, installez le fichier .streamDeckPlugin dans l’application Stream Deck. Pour mettre en place la connexion locale, ouvrez un terminal dans le dossier stream-deck des sources et installez les dépendances avec la commande suivante.

npm ci

Si vous avez reçu une archive .tgz, extrayez-la, ouvrez un terminal dans son dossier et utilisez cette commande à la place. Node.js 24 doit être installé séparément.

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

La connexion locale reste active tant que ce terminal est ouvert, et ne démarre pas toute seule. Gardez cette fenêtre ouverte pendant la partie.

Préparer la connexion locale

Lancez l’initialisation avec la première commande. Indiquez l’adresse exacte de Foundry telle qu’elle s’affiche dans le navigateur, par exemple http://localhost:30000 ou https://foundry.example.net, sans chemin ni barre oblique finale. Copiez la clé de jumelage générée : vous la saisirez dans Foundry et dans le plugin. Démarrez ensuite la connexion locale avec la seconde commande.

npm run companion:init
npm run companion

La configuration est enregistrée dans votre profil utilisateur, à l’un des emplacements ci-dessous. L’initialisation ne remplace pas un fichier existant. Pour changer l’adresse de Foundry, le port ou la clé, arrêtez la connexion locale avec Ctrl+C, modifiez le fichier de configuration puis relancez-la. Si la clé change, saisissez la nouvelle clé dans Foundry et dans le plugin.

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

Connecter Foundry

Dans Foundry, ouvrez la fenêtre « Connexions JDR Ninja » et cliquez sur l’engrenage « Configurer Stream Deck » de la carte Stream Deck. Saisissez l’adresse ci-dessous et la clé de jumelage, puis cliquez sur « Enregistrer et activer » : Stream Deck est alors activé dans ce navigateur. La carte indique « Prêt » quand la connexion locale est établie.

ws://127.0.0.1:19114/jdr-ninja

Connecter le plugin Stream Deck

Ajoutez l’action « Piloter Foundry » à une touche. Dans son inspecteur, renseignez « Adresse de connexion » avec l’adresse ci-dessous, collez la même « Clé de jumelage » et choisissez « Connecter ». Ces paramètres de connexion sont communs à toutes les touches. Le champ de clé est vidé après l’enregistrement.

ws://127.0.0.1:19114/stream-deck

Cette clé sert uniquement à la connexion locale entre Stream Deck et Foundry. Elle est différente du jeton de connexion Atlas et des identifiants de votre compte JDR Ninja. Ne collez aucun de ces autres identifiants dans le champ « Clé de jumelage ».

Choisir la session Foundry

Dans « Partie et navigateur Foundry », choisissez le monde, l’utilisateur et le navigateur voulus. Attendez l’état « Prêt » et l’apparition des commandes et documents autorisés. Chaque touche enregistre sa propre session, sa commande et ses paramètres. Elle ne bascule jamais automatiquement vers un autre monde, utilisateur ou navigateur.

Créer et tester une première commande

Dans « Commande », choisissez « Ouvrir un acteur », puis sélectionnez un acteur dont vous pouvez ouvrir la fiche. Appuyez une fois sur la touche. Vérifiez l’ouverture de la fiche dans Foundry et le résultat « Terminé. » dans l’inspecteur. Une commande acceptée peut encore attendre son exécution.

Si un résultat est incertain, la touche peut afficher brièvement « ? ». Vérifiez ce qui s’est passé dans Foundry avant un nouvel appui. La section suivante montre comment préparer des touches utiles pendant la partie.

Réutiliser vos touches pendant la partie

Ces exemples commencent par des touches fixes, puis introduisent une notion à la fois : une liste pour choisir parmi plusieurs documents, une variable pour enregistrer une valeur, une commande combinée pour modifier une valeur avant d’agir dans Foundry, des arguments pour vos macros et la modification directe d’un champ de fiche. Les deux derniers exemples combinent cette modification avec les variables : révéler des pages de journal pour de bon et afficher la tension aux joueurs. Seul l’exemple des macros demande un script. Les variables et les listes se créent dans Foundry ; les commandes qui les utilisent apparaissent dans la liste « Commande » précédées de « Avancé · », tout comme « Mettre à jour un document ».

Préparer les commandes de votre prochaine scène

Vos joueurs quittent l’auberge pour la crypte. Préparez trois touches pour ce changement de lieu : la première active la scène, la deuxième lance son ambiance sonore et la troisième assombrit l’éclairage.

Avant de commencer

Connectez-vous comme MJ : ces trois commandes lui sont réservées. Le monde contient déjà la scène et une playlist avec la piste voulue.

Dans Foundry

Aucun réglage du module n’est nécessaire : ces commandes utilisent des valeurs fixes, choisies directement dans l’inspecteur.

Sur Stream Deck

Préparer les commandes de votre prochaine scène
Touche Commande Réglages
Aller à la crypte Activer une scène « Document » : la scène de la crypte.
Ambiance de la crypte Lire ou arrêter un son « Document » : la piste de la playlist. « Lire le son » : Oui (la valeur proposée est Non, qui arrête la piste).
Assombrir Régler l’obscurité « Document » : la scène de la crypte. « Valeur » : un nombre de 0 (plein jour) à 1 (obscurité totale), par exemple 0,7.

Essayer et revenir au départ

Appuyez sur les trois touches dans l’ordre : la scène de la crypte s’affiche chez les joueurs, la piste démarre et l’éclairage baisse. La touche d’obscurité affiche en pourcentage l’obscurité de la scène ouverte dans votre navigateur. Pour revenir au départ, ajoutez une touche « Lire ou arrêter un son » avec « Lire le son » sur Non, et une touche d’obscurité à 0.

À savoir

« Activer une scène » affiche la scène à tous les joueurs. « Voir une scène » change seulement votre propre vue : vous pouvez ainsi préparer la suite sans que les joueurs la voient. Les trois actions restent séparées : pour les enchaîner sur une même touche, il faut une macro qui les contient.

Parcourir vos PNJ avec les mêmes touches

À l’auberge, vos joueurs interrogent plusieurs PNJ. Deux touches permettent de passer d’un PNJ à l’autre et une troisième ouvre la fiche du PNJ choisi. La touche d’ouverture sert pour toute la liste : ajouter ou réordonner des PNJ ne demande aucun changement sur Stream Deck.

Avant de commencer

Tout utilisateur peut suivre cet exemple avec ses variables personnelles. Le monde contient déjà trois acteurs dont vous pouvez ouvrir la fiche.

Dans Foundry

  1. Ouvrez « Variables et listes (avancé) » dans les paramètres du module et choisissez « Personnel ». Dans l’onglet « Listes de valeurs », créez la liste « PNJ de l’auberge » de type « Acteur ». Pour chaque PNJ, cliquez sur « Ajouter une entrée », saisissez un « Libellé » et sélectionnez l’acteur parmi les suggestions du champ « UUID du document (référence précise) ». Enregistrez.
  2. Dans l’onglet « Variables », créez « PNJ choisi » : « Type de valeur » sur « Acteur », « Définition » sur « Sélection dans une liste », « Liste associée » sur « PNJ de l’auberge » et le premier PNJ comme « Valeur par défaut ». Cochez « Revenir au début après la dernière entrée » si la liste doit recommencer après le dernier PNJ. Enregistrez.
  3. Une nouvelle sélection n’a pas encore de valeur actuelle. Dans « Modifier la valeur actuelle », choisissez « Rétablir la valeur par défaut », puis « Appliquer ».

Sur Stream Deck

Parcourir vos PNJ avec les mêmes touches
Touche Commande Réglages
PNJ précédent Revenir à l’entrée précédente « Variable (avancé) » : PNJ choisi.
PNJ suivant Passer à l’entrée suivante « Variable (avancé) » : PNJ choisi.
Ouvrir le PNJ Ouvrir un acteur « Acteur » : « Source de la valeur » sur « Variable (avancé) », puis la variable PNJ choisi.

Essayer et revenir au départ

Appuyez sur « Ouvrir le PNJ » : la fiche du premier PNJ s’ouvre. Appuyez sur « PNJ suivant », puis de nouveau sur « Ouvrir le PNJ » : c’est la fiche du deuxième qui s’ouvre. Le PNJ choisi apparaît dans la fenêtre « Variables et listes (avancé) » et sous « Valeur actuelle » dans l’inspecteur. Pour revenir au premier PNJ, ajoutez une touche « Rétablir la valeur par défaut » sur la même variable.

À savoir

Les touches n’affichent ni le portrait ni le nom du PNJ choisi : vérifiez la sélection dans Foundry ou dans l’inspecteur. Sans retour au début, « Passer à l’entrée suivante » ne change rien sur le dernier PNJ.

Révéler les indices dans l’ordre

Vos joueurs enquêtent dans la crypte et vous voulez leur montrer trois indices dans l’ordre prévu. Après le premier indice, une touche suffit pour passer à l’indice suivant et le montrer à vos joueurs, sans macro.

Avant de commencer

Connectez-vous comme MJ : montrer une page est réservé au MJ, qui doit aussi en être propriétaire. Préparez trois pages de journal, une par indice, et donnez aux joueurs au moins la permission Observateur sur chacune. Les joueurs doivent être connectés pour recevoir la page.

Dans Foundry

  1. Dans « Variables et listes (avancé) », choisissez « Personnel » : cela suffit pour vos propres touches. Créez la liste « Indices de la crypte » de type « Page de journal » et ajoutez les trois pages dans l’ordre où vous voulez les montrer.
  2. Créez la variable « Indice en cours » : « Type de valeur » sur « Page de journal », « Définition » sur « Sélection dans une liste », cette liste comme « Liste associée » et la première page comme « Valeur par défaut ». Laissez « Revenir au début après la dernière entrée » décochée.
  3. Enregistrez, puis appliquez « Rétablir la valeur par défaut » dans « Modifier la valeur actuelle ».

Sur Stream Deck

Révéler les indices dans l’ordre
Touche Commande Réglages
Indice précédent Revenir à l’entrée précédente « Variable (avancé) » : Indice en cours.
Indice suivant Passer à l’entrée suivante « Variable (avancé) » : Indice en cours.
Montrer l’indice Afficher une page de journal « Document » : « Source de la valeur » sur « Variable (avancé) », puis la variable Indice en cours. « Destinataires » : Joueurs.
Indice suivant et montrer Modifier des variables et lancer une commande « Ajouter une modification de variable » : « Opération » sur « Passer à l’entrée suivante » (la valeur proposée est « Inverser une variable »), « Variable (avancé) » sur Indice en cours. « Commande Foundry » : « Afficher une page de journal », avec les mêmes réglages que « Montrer l’indice ».

Essayer et revenir au départ

Essayez d’abord les trois premières touches séparément pour vérifier la sélection et les destinataires. En partie, montrez le premier indice avec « Montrer l’indice », puis utilisez « Indice suivant et montrer » : à chaque appui, la page suivante est sélectionnée et montrée aux joueurs connectés. Commencer par la touche combinée ferait sauter le premier indice. Pour rejouer l’enquête, appliquez « Rétablir la valeur par défaut » : l’indice en cours redevient le premier, mais les pages déjà montrées ne sont pas retirées aux joueurs et leurs permissions ne changent pas.

À savoir

Après le dernier indice, la touche combinée ne change plus de page et montre de nouveau la dernière. Si un joueur n’a pas la permission Observateur, la commande est refusée et l’indice en cours ne change pas. L’option « Afficher sans changer les permissions » montre la page une fois sans modifier ces permissions.

Annoncer le niveau de tension

Dans une partie d’horreur, vous faites monter la tension quand la situation se dégrade. Une touche ajoute 1 au compteur et annonce le nouveau niveau dans le chat, par exemple « Tension : 3 / 6 ». Vous décidez quand appuyer : aucun événement du jeu ne fait monter le compteur de lui-même.

Avant de commencer

Tout utilisateur peut créer cette variable personnelle et écrire dans le chat. Aucun document n’est nécessaire.

Dans Foundry

Dans « Variables et listes (avancé) », en « Personnel », créez la variable « Tension » : « Type de valeur » sur « Nombre », « Définition » sur « Valeur enregistrée », « Minimum » 0, « Maximum » 6, « Valeur par défaut » et « Valeur actuelle » 0. Cochez « Limiter les augmentations et diminutions aux bornes ». Enregistrez.

Sur Stream Deck

Annoncer le niveau de tension
Touche Commande Réglages
Monter la tension Augmenter une variable « Variable (avancé) » : Tension. « Variation » : 1 (la valeur proposée est 0, qui ne change rien).
Baisser la tension Diminuer une variable « Variable (avancé) » : Tension. « Variation » : 1.
Remettre à zéro Rétablir la valeur par défaut « Variable (avancé) » : Tension.
Monter et annoncer Modifier des variables et lancer une commande Une modification « Augmenter une variable » sur Tension, « Variation » 1. « Commande Foundry » : « Envoyer un message dans le chat ». « Message du chat » : « Source de la valeur » sur « Composer un texte (avancé) », puis trois parties dans l’ordre : le texte « Tension : » suivi d’une espace, la variable Tension et le texte « / 6 » précédé d’une espace.

Essayer et revenir au départ

Vérifiez d’abord les trois premières touches : la valeur de Tension change dans la fenêtre « Variables et listes (avancé) ». Ensuite, avec un compteur à 2, appuyez sur « Monter et annoncer » : le compteur passe à 3 et le chat affiche « Tension : 3 / 6 ». Le message est public et envoyé à votre nom. « Remettre à zéro » ramène le compteur à 0 sans retirer les messages déjà envoyés.

À savoir

Au maximum, le compteur reste à 6, mais le message est quand même envoyé. Si l’envoi du message échoue, la nouvelle valeur peut rester enregistrée et la touche affiche « ! » : vérifiez le compteur et le chat dans Foundry avant d’appuyer de nouveau.

Lancer un jet avec un bonus variable

Un allié aide le personnage ou une position en hauteur facilite son tir : le bonus change d’une scène à l’autre. Enregistrez ce bonus dans une variable : une seule touche lance alors 1d20 plus le bonus actuel. Chaque appui utilise la valeur du moment.

Avant de commencer

Tout utilisateur peut lancer des dés et créer ses variables personnelles. Aucun document n’est nécessaire.

Dans Foundry

En « Personnel », créez la variable « Bonus de situation » : « Type de valeur » sur « Nombre », « Définition » sur « Valeur enregistrée », « Minimum » 0, « Maximum » 5, « Valeur par défaut » et « Valeur actuelle » 0. Cochez « Limiter les augmentations et diminutions aux bornes ». Enregistrez.

Sur Stream Deck

Lancer un jet avec un bonus variable
Touche Commande Réglages
Augmenter le bonus Augmenter une variable « Variable (avancé) » : Bonus de situation. « Variation » : 1.
Réduire le bonus Diminuer une variable « Variable (avancé) » : Bonus de situation. « Variation » : 1.
Bonus à zéro Rétablir la valeur par défaut « Variable (avancé) » : Bonus de situation.
Jet avec bonus Lancer les dés « Expression de dés » : « Source de la valeur » sur « Composer un texte (avancé) », puis le texte « 1d20 + » et la variable Bonus de situation. « Visibilité du jet » : « Moi seulement » pour vous entraîner.

Essayer et revenir au départ

Choisissez la commande « Lancer les dés » dans l’action « Piloter Foundry » : l’action Stream Deck du même nom est une autre action, destinée à l’overlay. Appuyez sur « Jet avec bonus » : le résultat apparaît dans le chat de Foundry, pour vous seul. Augmentez le bonus deux fois et appuyez de nouveau : le jet utilise 1d20 + 2. Quand la table doit voir le jet, choisissez « Tout le monde ». « Bonus à zéro » ramène le bonus à 0.

À savoir

C’est un jet de dés générique : il ne remplace pas les jets d’attaque ou de dégâts de votre système de jeu, et la variable ne suit aucune caractéristique d’acteur. L’expression accepte les dés, les nombres et les opérations simples, mais pas les modificateurs comme « kh » : un jet « 2d20kh1 » est refusé.

Transmettre des valeurs à une macro

Vous avez déjà une macro de script qui agit sur un acteur selon une quantité. Au lieu de la copier pour chaque cas, déclarez ses arguments : chaque touche lance la même macro avec son propre acteur et sa propre quantité.

Avant de commencer

C’est le seul exemple qui demande un script. La macro doit être une macro de script dont vous êtes propriétaire et que vous pouvez exécuter. Le module ne fournit aucune macro prête à l’emploi et ne modifie pas votre script.

Dans Foundry

  1. Ouvrez « Macros compatibles (avancé) », choisissez la macro, puis « Configurer la macro ». Avec « Ajouter un argument », déclarez par exemple « cible » de type « Acteur » et « quantite » de type « Nombre ». Un nom d’argument commence par une lettre et ne contient ni accent ni espace. Cochez « Obligatoire », ou cochez « Utiliser une valeur par défaut » et indiquez la « Valeur par défaut ». Cliquez ensuite sur « Enregistrer ».
  2. Dans le script, lisez les valeurs dans scope.jdrNinja.arguments. Un document y est transmis sous forme d’UUID ; un nombre, un texte ou un booléen y est transmis tel quel.
  3. Terminez le script par la ligne d’accusé de réception affichée dans la fenêtre « Macros compatibles (avancé) ». Sans elle, la touche signale un résultat incertain, même si la macro a fonctionné.

Sur Stream Deck

Transmettre des valeurs à une macro
Touche Commande Réglages
Premier cas Lancer une macro « Document » : votre macro. Cochez « Arguments de macro (Avancé) », puis « cible » : un premier acteur et « quantite » : 2.
Second cas Lancer une macro La même macro, avec « quantite » : 5. Pour « cible », réglez « Source de la valeur » sur « Variable (avancé) », puis choisissez la variable PNJ choisi : la macro agit alors sur le PNJ sélectionné dans l’exemple des PNJ.

Essayer et revenir au départ

Appuyez sur chaque touche et vérifiez dans Foundry l’effet de la macro sur l’acteur concerné. L’inspecteur affiche « Terminé. » une fois l’accusé de réception reçu. Revenir à l’état de départ dépend de ce que fait votre macro : le module n’annule rien.

À savoir

La fenêtre de déclaration ne crée aucun script : elle décrit seulement les valeurs attendues. Une macro sans arguments déclarés n’en reçoit pas, et l’inspecteur demande alors de choisir une macro qui déclare des arguments compatibles dans Foundry.

Donner l’inspiration

L’un de vos joueurs vient de réussir un coup d’éclat et mérite l’inspiration. Dans une partie de D&D5e, une seule touche active l’inspiration sur la fiche de son personnage ; un second appui la désactive.

Avant de commencer

Le MJ peut accorder l’inspiration à n’importe quel joueur. Un joueur ne peut le faire que pour un personnage dont il est propriétaire : dans les autres cas, Foundry refuse la modification. Le monde utilise le système D&D5e.

Dans Foundry

Si ce n’est pas déjà fait, attribuez au joueur son personnage dans la « Configuration du joueur » (clic droit sur son nom dans la liste des joueurs), section « Personnage du joueur » : la touche agit sur ce personnage attribué. Aucun autre réglage du module n’est nécessaire.

Sur Stream Deck

Donner l’inspiration
Touche Commande Réglages
Inspiration Mettre à jour un document « Document » sur « Personnage attribué au joueur », puis « Utilisateur Foundry » : le joueur concerné. « Ajouter une modification » : « Chemin du champ » system.attributes.inspiration, « Opération » sur « Inverser vrai/faux ».

Essayer et revenir au départ

Ouvrez la fiche du personnage dans Foundry, puis appuyez sur « Inspiration » : la fiche montre que le personnage a l’inspiration. Appuyez de nouveau : l’inspiration est retirée et la fiche revient à son état de départ. À chaque appui, la touche inverse l’état actuel : si le personnage avait déjà l’inspiration, le premier appui la retire.

À savoir

Le chemin system.attributes.inspiration est propre à D&D5e : les autres systèmes de jeu utilisent d’autres champs, et le module ne vérifie pas le chemin saisi. Si le champ n’existe pas, la touche affiche une alerte et l’inspecteur indique qu’un champ n’a pas le type attendu.

Révéler les indices pour de bon

Dans « Révéler les indices dans l’ordre », la touche montre une page que les joueurs ont déjà la permission d’ouvrir. Ici, chaque page d’indice reste masquée dans leur journal jusqu’à ce que vous la révéliez : une touche révèle l’indice en cours, une autre passe à l’indice suivant et le révèle, sans macro.

Avant de commencer

Connectez-vous comme MJ : Foundry refuse à un joueur de changer la permission d’une page. Il vous faut la liste « Indices de la crypte » et la variable « Indice en cours » de l’exemple « Révéler les indices dans l’ordre » : créez-les d’abord en suivant ses étapes « Dans Foundry ».

Dans Foundry

  1. Faites un clic droit sur le journal qui contient les pages d’indices, choisissez « Configurer les droits » et réglez « Tous les joueurs » sur « Observateur » : sans cette permission, le journal n’apparaît pas dans l’onglet Journaux des joueurs.
  2. Pour chaque page d’indice, faites un clic droit sur la page dans la liste des pages du journal, choisissez « Configurer les droits » et réglez « Tous les joueurs » sur « Aucun » : une page nouvellement créée hérite de la permission du journal et serait donc visible pour eux. Ce réglage remplace la permission Observateur demandée dans l’exemple « Révéler les indices dans l’ordre ».

Sur Stream Deck

Révéler les indices pour de bon
Touche Commande Réglages
Révéler l’indice en cours Mettre à jour un document « Document » : « Source de la valeur » sur « Variable (avancé) », puis la variable Indice en cours. « Ajouter une modification » : « Chemin du champ » ownership.default, « Opération » sur « Définir une valeur », « Type de valeur » sur « Nombre », puis « Valeur » 2, qui correspond au niveau Observateur.
Révéler l’indice suivant Modifier des variables et lancer une commande « Ajouter une modification de variable » : « Opération » sur « Passer à l’entrée suivante » (la valeur proposée est « Inverser une variable »), « Variable (avancé) » sur Indice en cours. « Commande Foundry » : « Mettre à jour un document », avec les mêmes réglages que « Révéler l’indice en cours ».
Cacher l’indice Mettre à jour un document Facultatif. Les mêmes réglages que « Révéler l’indice en cours », mais avec la valeur 0, qui correspond à Aucun : la touche cache l’indice en cours. La valeur -1 rendrait la page visible, car elle hériterait de la permission Observateur du journal.

Essayer et revenir au départ

Appuyez sur « Révéler l’indice en cours » : le premier indice apparaît dans le journal des joueurs, les autres pages restent masquées. Appuyez ensuite sur « Révéler l’indice suivant » : à chaque appui, l’indice en cours passe à la page suivante, qui est révélée. Si vous commencez par la touche combinée, le premier indice est sauté. Le journal des joueurs et les fenêtres de journal qu’ils ont ouvertes se mettent à jour tout de suite, sans rechargement, et les pages révélées restent dans leur journal. Pour rejouer l’enquête, remettez chaque page d’indice sur Aucun dans Foundry, puis appliquez « Rétablir la valeur par défaut » à la variable Indice en cours.

À savoir

Sur le dernier indice, la touche combinée ne change rien. « Rétablir la valeur par défaut » ramène l’indice en cours au premier, mais ne cache pas les pages déjà révélées. Si un joueur appuie sur ces touches, Foundry refuse la modification. Une commande combinée ne lance qu’une seule commande Foundry : pour révéler une page puis l’afficher aux joueurs avec « Afficher une page de journal », il faut deux touches. Une page masquée l’est seulement dans l’interface des joueurs : son contenu se trouve déjà dans leur navigateur, ce n’est donc pas un secret.

Afficher la tension aux joueurs

Dans « Annoncer le niveau de tension », le niveau est annoncé dans le chat. Ici, vous l’affichez dans le nom d’un journal que les joueurs voient dans leur liste de journaux : une touche fait monter la tension et renomme le journal, par exemple « Tension : 3 / 6 ». Vous décidez quand appuyer.

Avant de commencer

Connectez-vous comme MJ : Foundry refuse à un joueur de renommer un journal qu’il ne possède pas. Il vous faut la variable « Tension » de l’exemple « Annoncer le niveau de tension » : créez-la d’abord avec son étape « Dans Foundry ».

Dans Foundry

Créez un journal nommé « Tension » puis, par un clic droit sur ce journal et « Configurer les droits », réglez « Tous les joueurs » sur « Observateur » : sans cette permission, il n’apparaît pas dans l’onglet Journaux des joueurs.

Sur Stream Deck

Afficher la tension aux joueurs
Touche Commande Réglages
Monter et afficher Modifier des variables et lancer une commande Une modification « Augmenter une variable » sur Tension, « Variation » 1. « Commande Foundry » : « Mettre à jour un document ». « Document » : le journal « Tension », choisi dans la liste. « Ajouter une modification » : « Chemin du champ » name, « Opération » sur « Définir une valeur », « Type de valeur » sur « Composer un texte (avancé) », puis trois parties dans l’ordre : le texte « Tension : » suivi d’une espace, la variable Tension et le texte « / 6 » précédé d’une espace.

Essayer et revenir au départ

Avec un compteur à 2, appuyez sur « Monter et afficher » : le compteur passe à 3 et le journal est renommé « Tension : 3 / 6 ». Ce nom s’affiche tout de suite dans l’onglet Journaux de chaque joueur, sans rechargement. Pour revenir au départ, remettez le compteur à zéro avec la touche « Remettre à zéro » de l’exemple « Annoncer le niveau de tension », puis renommez le journal « Tension » dans Foundry.

À savoir

Au maximum, le compteur reste à 6 et le nom du journal ne change pas. La touche renomme le journal lui-même et non une de ses pages : la liste des journaux affiche le nom des journaux, alors que le nom d’une page n’apparaît que dans le journal ouvert.

Créer des variables et des listes dans Foundry

Après une reconnexion

Quand le navigateur Foundry se reconnecte, il apparaît comme une nouvelle session. Sélectionnez-la à nouveau sur chaque touche concernée, y compris après un redémarrage de la connexion locale. Si seul le plugin se reconnecte, il peut retrouver une session Foundry restée connectée. Si vous appuyez sur Ctrl+C dans le terminal, la connexion locale s’arrête et les sessions en cours sont interrompues.

En cas de problème

  • Aucune connexion : vérifiez que la fenêtre du terminal est toujours ouverte, que les adresses saisies sont bien celles indiquées dans ce guide et que Foundry et le plugin utilisent la même clé.
  • Foundry refusé ou absent : vérifiez l’origine exacte autorisée dans companion.json et la case « Activer » de la carte Stream Deck dans ce navigateur. Une adresse de serveur différente change l’origine.
  • Foundry en HTTPS : le navigateur peut exiger wss et un certificat local approuvé. Configurez tlsCert et tlsKey avec des chemins absolus vers des fichiers PEM, puis utilisez wss dans Foundry et dans le plugin. Le certificat doit couvrir l’adresse locale et être approuvé par le navigateur Foundry et par Stream Deck. Il n’est pas installé automatiquement.
  • Session disparue ou en synchronisation : attendez qu’elle soit prête, puis sélectionnez à nouveau le monde, l’utilisateur et le navigateur sur la touche.
  • Commande refusée ou document absent : vérifiez les permissions du compte Foundry et le document ciblé. Le choix d’une session ne donne aucun droit supplémentaire.
  • Test de l’overlay indisponible : vérifiez la connexion du compte JDR Ninja, l’activation de l’overlay dans Foundry et le résultat de la vérification Premium. La clé locale ne confirme pas cet accès.
  • Résultat incertain ou partiel : inspectez la fiche, la scène, les variables ou le combat concernés dans Foundry avant un nouvel appui. Une interruption peut survenir après l’exécution. Le plugin ne relance pas la commande automatiquement.

Questions fréquentes

Pourquoi la clé disparaît-elle du champ ?

Le plugin vide le champ après l’enregistrement pour ne pas afficher la clé stockée. Cette disparition ne signifie pas que la connexion a été supprimée.

Pourquoi la session doit-elle être choisie à nouveau ?

Une reconnexion Foundry crée une nouvelle identité. Les touches conservent leur choix précédent pour éviter d’envoyer une commande à un autre monde, utilisateur ou navigateur.

Puis-je relancer une commande dont le résultat est incertain ?

Vérifiez d’abord Foundry. La commande peut déjà avoir été exécutée malgré l’interruption de la connexion. Chaque nouvel appui constitue une nouvelle commande.

Une touche peut-elle afficher la valeur d’une variable ?

Non. Les touches affichent l’état de la pause, le niveau d’obscurité, la jauge d’un token ou, brièvement, le résultat d’une commande. La valeur d’une variable ou le PNJ choisi se consultent dans Foundry ou dans l’inspecteur.

Stream Deck pour Foundry VTT Le module JDR Ninja pour Foundry