Commandes Foundry
Changer de lieu en trois touches
Activez la scène suivante, lancez son ambiance sonore et réglez son obscurité, chaque commande sur sa touche.
Le module JDR Ninja pour Foundry
Contrôlez vos fiches de personnage depuis votre Stream Deck.
Activez une scène, montrez un indice, lancez un jet ou modifiez directement la fiche d’un personnage depuis Stream Deck. Le plugin JDR Ninja envoie vos commandes à Foundry VTT, et les variables vous permettent de réutiliser les mêmes touches pendant toute la partie.
Une touche peut changer n’importe quel champ que Foundry vous autorise à modifier : l’inspiration d’un personnage, ses points de vie, sa monnaie, les charges d’un objet, le nom d’une page de journal. Jusqu’à 16 champs changent en une seule mise à jour.
Avec les variables, une touche peut aussi :
Chaque exemple indique ce qu’il utilise et renvoie à sa configuration pas à pas dans le guide.
Commandes Foundry
Activez la scène suivante, lancez son ambiance sonore et réglez son obscurité, chaque commande sur sa touche.
Variables : liste et commande combinée
Une liste de pages et une commande combinée : passez à l’indice suivant et montrez-le à vos joueurs connectés, sans macro.
Variables : compteur et texte composé
Un compteur de 0 à 6 enregistré dans une variable : faites-le monter et annoncez sa nouvelle valeur dans le chat.
Mise à jour de documents
Activez ou retirez l’inspiration sur la fiche d’un joueur, sans l’ouvrir.
Le plugin propose 40 commandes : 31 pour Foundry VTT, dont la mise à jour de documents, et 9 pour les variables. Chaque commande respecte les permissions de l’utilisateur Foundry connecté, et les commandes marquées MJ sont réservées au meneur de jeu.
Une liste de PNJ ou d’indices, un compteur, un bonus : avec les variables et les listes créées dans Foundry, quelques touches suffisent pour toute la partie. Une commande combinée modifie une valeur puis lance une action, par exemple passer à l’indice suivant et le montrer. Les valeurs et les permissions sont vérifiées à chaque appui.
Les variables sont enregistrées dans les réglages de Foundry, pas dans le navigateur.
game.settings
flags.jdr-ninja.arguments
Document#update()
Chaque commande appelle une fonction de Foundry VTT, indiquée sous son nom : c’est Foundry qui agit, avec ses propres règles et vos permissions.
Ouvrir un acteur
Actor#sheet.render()
Lancer une macro
Macro#execute()
Voir une scène
Scene#view()
Activer une scène MJ
Scene#activate()
Précharger une scène MJ
game.scenes.preload()
Régler l’obscurité MJ
Scene#update({ darknessLevel })
Ouvrir une page de journal
JournalEntry#sheet.render()
Afficher une page de journal MJ
Journal.show()
Lire ou arrêter un son MJ
Playlist#playSound() / stopSound()
Changer de piste MJ
Playlist#playNext()
Arrêter la musique MJ
Playlist#stopAll()
Régler le volume MJ
PlaylistSound#update({ volume })
Mettre en pause ou reprendre MJ
game.togglePause()
Ouvrir un onglet
ui.sidebar.changeTab()
Choisir un outil
ui.controls.activate()
Lancer les dés
Roll#toMessage()
Tirer dans une table
RollTable#draw()
Envoyer un message dans le chat
ChatMessage.create()
Sélectionner un token
Token#control()
Cibler un token
Token#setTarget()
Cacher ou montrer un token MJ
TokenDocument#update({ hidden })
Modifier une jauge de token
Actor#modifyTokenAttribute()
Appliquer ou retirer un état
Actor#toggleStatusEffect()
Commencer le combat MJ
Combat#startCombat()
Finir le combat MJ
DialogV2.confirm() + Combat#delete()
Passer au tour suivant MJ
Combat#nextTurn()
Revenir au tour précédent MJ
Combat#previousTurn()
Passer au round suivant MJ
Combat#nextRound()
Lancer l’initiative MJ
Combat#rollAll()
Tester l’overlay
Serveur JDR Ninja, accès Premium
« Modifier une jauge de token » change seulement la jauge du token : elle ne gère ni les dégâts ni les soins selon les règles de chaque système. « Finir le combat » demande une confirmation dans Foundry.
Ces captures montrent les paramètres du module dans un navigateur Foundry réel et l’inspecteur de développement du plugin. Elles illustrent la configuration locale et ne constituent pas une validation sur matériel Stream Deck. Le port temporaire visible dans les captures diffère du port par défaut 19114 du guide.
Dans la fenêtre « Stream Deck » du module, saisissez l’adresse de connexion et la clé de jumelage, puis cliquez sur « Enregistrer et activer ».
La commande et ses champs dépendent de la session choisie et des permissions de l’utilisateur Foundry.
Le plugin Stream Deck envoie vos commandes au module JDR Ninja par une connexion locale, dans le navigateur Foundry que vous avez choisi. Foundry exécute les commandes et vérifie les permissions de l’utilisateur connecté. Ce navigateur doit rester ouvert sur le même ordinateur que Stream Deck, mais le serveur Foundry peut être hébergé ailleurs. La connexion locale utilise sa propre clé de jumelage : elle ne demande aucun jeton de compte JDR Ninja et ne remplace aucune permission Foundry.
Chaque touche reste liée au monde, à l’utilisateur et au navigateur que vous avez choisis. Le plugin distingue une commande terminée d’une commande refusée ou dont le résultat est incertain. Si le résultat est incertain, vérifiez Foundry avant d’appuyer de nouveau.
Prévoyez Foundry V14 ou ultérieur avec le module JDR Ninja activé, l’application Stream Deck avec le plugin JDR Ninja, et Node.js 24 pour la connexion locale. Chaque touche doit cibler une session choisie explicitement.
Les commandes respectent les permissions Foundry de la session choisie. Le test de l’overlay porte une indication Premium et nécessite la connexion du compte, l’activation de l’overlay et la vérification de l’accès par le serveur. Les conditions des autres fonctions du module sont distinctes. Aucun palier d’abonnement général n’est annoncé pour les commandes locales.
Elles conservent une valeur dans Foundry : le PNJ choisi, l’indice en cours, un compteur ou un bonus. Une touche utilise la valeur du moment, et la commande « Modifier des variables et lancer une commande » la modifie puis agit dans Foundry.
Oui. Le navigateur qui ouvre la partie doit toutefois fonctionner sur le même ordinateur que Stream Deck.
Non. Elles ne fonctionnent que si un navigateur Foundry est ouvert, connecté à la partie et prêt à recevoir les commandes. Si vous fermez ce navigateur, la session est interrompue.
Sélectionnez à nouveau la session sur vos touches. Une nouvelle connexion Foundry reçoit une nouvelle identité. Une reconnexion du plugin seul peut retrouver une session Foundry restée ouverte.
Les actions disponibles dépendent des permissions de l’utilisateur Foundry connecté. Une touche ne donne aucun droit supplémentaire et ne change jamais automatiquement d’utilisateur.
Le test de l’overlay nécessite un accès Premium vérifié dans Foundry. Aucun abonnement général n’est annoncé pour les commandes locales. Les générateurs et les autres fonctions du module ont leurs propres conditions d’accès.
Des essais de développement utilisent un navigateur Foundry réel et un hôte Elgato simulé. La validation sur matériel Stream Deck, l’installation Windows/macOS et la connexion wss avec certificat approuvé restent à terminer. Aucune compatibilité matérielle générale n’est donc annoncée.
Oui, si Foundry vous autorise à modifier ce document : le MJ peut tout modifier, un joueur seulement ce qui lui appartient. Le chemin du champ dépend du système de jeu et le module ne le vérifie pas. Foundry ignore un champ inexistant, et une augmentation ou une inversion sur ce champ est signalée sur la touche.
Suivez le guide pour relier les trois composants et tester une commande simple.