Macros, scènes et pause
Lancez une macro autorisée, affichez ou activez une scène, réglez son obscurité et mettez la partie en pause.
Le module JDR Ninja pour Foundry
Contrôlez Foundry VTT avec Stream Deck
Lancez vos macros, changez de scène et contrôlez la musique depuis Stream Deck. Le plugin JDR Ninja transmet vos commandes à Foundry VTT par un compagnon installé sur votre ordinateur.
En bref
Trois composants relient vos touches au navigateur Foundry choisi : le plugin Stream Deck, le compagnon local et le module JDR Ninja. Foundry exécute les commandes et vérifie les permissions de l’utilisateur connecté. Son navigateur doit rester ouvert sur le même ordinateur que le compagnon.
Les commandes à portée de main
Associez une touche à une macro, une scène ou un son déjà présent dans votre monde.
La bonne partie, le bon utilisateur
Chaque touche conserve le monde, l’utilisateur et le navigateur que vous avez choisis.
Un résultat à vérifier
Le plugin distingue une commande terminée d’une commande refusée ou dont le résultat est incertain.
À quoi ça ressemble
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.
Activer la connexion dans Foundry
Dans les paramètres du module, enregistrez l’adresse du compagnon et la clé locale, puis activez explicitement Stream Deck dans ce navigateur Foundry.
Configurer une touche
La commande et ses champs dépendent de la session choisie et des permissions de l’utilisateur Foundry.
Comment les composants se relient
- Plugin Stream Deck
- Compagnon local
- Module JDR Ninja dans le navigateur Foundry
Le compagnon transmet les commandes entre les deux clients sur votre ordinateur. Le serveur Foundry peut être hébergé ailleurs. La clé de jumelage locale ne nécessite pas de jeton de compte JDR Ninja et ne remplace aucune permission Foundry.
Les commandes disponibles dans la version actuelle
Musique et documents
Lisez ou arrêtez un son, changez de piste et réglez le volume. Ouvrez une fiche d’acteur ou une page de journal, partagez une page avec les destinataires choisis et tirez dans une table.
Jetons et combat
Sélectionnez, ciblez ou masquez un jeton, modifiez ses jauges natives et avancez les tours de combat selon vos permissions. Ces jauges ne constituent pas une gestion des dégâts ou des soins propre à chaque système.
Ce qu’il vous faut
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 le compagnon. Gardez le navigateur Foundry et le compagnon ouverts sur l’ordinateur de Stream Deck. Chaque touche doit cibler une session choisie explicitement.
Variables, listes et arguments de macro
Les commandes ordinaires fonctionnent avec des valeurs fixes. Les options avancées permettent de choisir une variable compatible, de parcourir une liste et de fournir des arguments à une macro qui les déclare dans Foundry. Les valeurs et les permissions sont vérifiées à chaque appui.
Permissions et conditions d’accès
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.
Questions fréquentes
À quoi sert le compagnon ?
Il transmet les commandes entre le plugin Stream Deck et les navigateurs Foundry autorisés sur votre ordinateur. Foundry exécute les actions et vérifie les permissions.
Le serveur Foundry peut-il être distant ?
Oui. Le navigateur qui ouvre la partie doit toutefois fonctionner sur le même ordinateur que le compagnon et Stream Deck.
Les touches fonctionnent-elles si je ferme Foundry ?
Les commandes nécessitent un navigateur Foundry ouvert, connecté au compagnon et prêt à les recevoir. Fermer ce navigateur interrompt sa session.
Que faire après une reconnexion de Foundry ?
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.
Un joueur peut-il utiliser ces commandes ?
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.
Faut-il un abonnement JDR Ninja ?
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.
Quels appareils et plateformes sont déjà validé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.
Préparer votre première touche
Suivez le guide pour relier les trois composants et tester une commande simple.