Aller au contenu principal

Le module JDR Ninja pour Foundry

Contrôlez Foundry VTT avec Stream Deck

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.

Modifier vos fiches

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.

  • Cinq opérations : définir une valeur, augmenter, diminuer, inverser vrai/faux, retirer un champ.
  • La cible de votre choix : un document précis, le personnage attribué à un joueur, le token sélectionné ou son acteur, ou un document donné par une variable.
  • Des valeurs fixes ou tirées de vos variables : un bonus, un compteur, un texte composé.
  • Vos permissions Foundry s’appliquent : le MJ peut tout modifier, un joueur seulement ce qui lui appartient.
  • Les champs dépendent du système de jeu : vous indiquez leur chemin, par exemple system.attributes.inspiration en D&D5e. Le module ne vérifie pas ce chemin.

Des exemples pour votre prochaine partie

Chaque exemple indique ce qu’il utilise et renvoie à sa configuration pas à pas dans le guide.

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.

Voir l’exemple pas à pas

Variables : liste et commande combinée

Révéler les indices dans l’ordre

Une liste de pages et une commande combinée : passez à l’indice suivant et montrez-le à vos joueurs connectés, sans macro.

Voir l’exemple pas à pas

Variables : compteur et texte composé

Annoncer le niveau de tension

Un compteur de 0 à 6 enregistré dans une variable : faites-le monter et annoncez sa nouvelle valeur dans le chat.

Voir l’exemple pas à pas

Mise à jour de documents

Donner l’inspiration

Activez ou retirez l’inspiration sur la fiche d’un joueur, sans l’ouvrir.

Voir l’exemple pas à pas

Les commandes

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.

Variables et listes

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.

Définir une variable
Donne une nouvelle valeur à la variable.
Sélectionner une entrée
Choisit une entrée précise de la liste associée.
Passer à l’entrée suivante
Avance d’une entrée dans la liste et peut revenir au début après la dernière.
Revenir à l’entrée précédente
Recule d’une entrée dans la liste.
Augmenter une variable
Ajoute une quantité au nombre, dans les limites fixées.
Diminuer une variable
Soustrait une quantité du nombre, dans les limites fixées.
Inverser une variable
Remplace oui par non, ou non par oui.
Rétablir la valeur par défaut
Redonne à la variable sa valeur par défaut.
Modifier des variables et lancer une commande
Applique jusqu’à 16 modifications, puis lance une commande Foundry.
  • Trois façons de définir une variable : une valeur enregistrée, une sélection dans une liste ou une valeur calculée. Le calcul peut utiliser d’autres variables et les champs d’un document, comme l’inspiration d’un personnage.
  • Treize types de valeur : nombre, texte, oui ou non, acteur, token, scène, journal, page de journal, macro, playlist, piste de la playlist, table aléatoire et rencontre de combat.
  • Des variables personnelles pour vos propres touches, ou communes à toute la table et gérées par le MJ.
  • Dans chaque champ d’une commande, la valeur peut venir d’une variable, d’un texte composé de parties fixes et de variables, du personnage attribué à un joueur ou du token sélectionné.
  • Des arguments pour vos macros de script : jusqu’à 16 valeurs déclarées par macro, renseignées différemment sur chaque touche.

Les variables sont enregistrées dans les réglages de Foundry, pas dans le navigateur.

game.settings flags.jdr-ninja.arguments

Voir les exemples

Les commandes de Foundry VTT

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.

Acteurs et macros

  • Ouvrir un acteur

    Actor#sheet.render()
  • Lancer une macro

    Macro#execute()

Scènes

  • 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 })

Journaux

  • Ouvrir une page de journal

    JournalEntry#sheet.render()
  • Afficher une page de journal MJ

    Journal.show()

Musique et sons

  • 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 })

Partie et interface

  • Mettre en pause ou reprendre MJ

    game.togglePause()
  • Ouvrir un onglet

    ui.sidebar.changeTab()
  • Choisir un outil

    ui.controls.activate()

Dés, tables et chat

  • Lancer les dés

    Roll#toMessage()
  • Tirer dans une table

    RollTable#draw()
  • Envoyer un message dans le chat

    ChatMessage.create()

Tokens et états

  • 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()

Combat

  • 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()

Overlay

  • 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.

À 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 la fenêtre « Stream Deck » du module, saisissez l’adresse de connexion et la clé de jumelage, puis cliquez sur « Enregistrer et activer ».

Paramètres Stream Deck du module JDR Ninja dans Foundry : connexion locale active, interface française.

Configurer une touche

La commande et ses champs dépendent de la session choisie et des permissions de l’utilisateur Foundry.

Inspecteur de développement JDR Ninja : commande Foundry et champs de configuration, interface française.

Comment Stream Deck communique avec Foundry

  1. Plugin Stream Deck
  2. Module JDR Ninja dans le navigateur 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.

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 la connexion locale. Chaque touche doit cibler une session choisie explicitement.

Installer le module Foundry

Permissions et conditions d’accès

Common.Free

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 servent les variables ?

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.

Le serveur Foundry peut-il être distant ?

Oui. Le navigateur qui ouvre la partie doit toutefois fonctionner sur le même ordinateur que Stream Deck.

Les touches fonctionnent-elles si je ferme Foundry ?

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.

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.

Puis-je modifier n’importe quel champ d’une fiche ?

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.

Préparer votre première commande

Suivez le guide pour relier les trois composants et tester une commande simple.

Le module JDR Ninja pour Foundry