Aller au contenu principal

Module Foundry VTT

Installer et configurer le module JDR Ninja dans Foundry VTT

Préparez l’installation, reliez votre compte JDR Ninja, puis activez les fonctions utiles à votre partie. La synchronisation Atlas demande aussi une connexion au monde concerné.

Avant de commencer

Vérifiez la version de Foundry et celle du système de jeu dans l’onglet Paramètres. Le module demande Foundry 14 au minimum ; les générateurs D&D ciblent précisément Foundry V14 et D&D5e 5.3.3. La synchronisation Atlas accepte les systèmes indiqués sur la page du module.

Connectez-vous comme MJ pour les générateurs, la synchronisation Atlas et les commandes de tables Twitch. Les joueurs peuvent configurer le relais de leurs jets publics. Vous n’avez pas besoin de Stream Deck pour utiliser les autres fonctions.

Module Foundry VTT

Installer et activer le module

Le module JDR Ninja est publié sur Foundry VTT. Dans l’écran de configuration de Foundry, ouvrez l’onglet des modules, cliquez sur le bouton d’installation et cherchez « JDR Ninja ». Si le module n’apparaît pas dans la recherche, collez l’adresse de son manifeste dans la fenêtre d’installation :

https://github.com/JDR-Ninja/fvtt-jdr-ninja/releases/latest/download/module.json

Le module ne dépend d’aucun autre module. Ouvrez ensuite votre monde et activez JDR Ninja dans la gestion des modules.

Dans les paramètres de Foundry, la section JDR Ninja propose le bouton « Configurer les connexions ». Il ouvre la fenêtre « Connexions JDR Ninja », qui affiche votre compte JDR Ninja en haut, puis une carte par fonction : « Stream Deck » et « Overlay VTT », et, pour le MJ, « Générateurs D&D » et « Synchronisation Atlas ».

Relier votre compte JDR Ninja

  1. Dans la fenêtre « Connexions JDR Ninja », cliquez sur « Connecter mon compte », puis sur « Ouvrir JDR Ninja », et connectez-vous au site si nécessaire. Si les générateurs D&D sont déjà activés dans ce navigateur, la même demande d’autorisation inclut l’accès aux générateurs.
  2. Vérifiez le code et le nom de l’appareil. Si vous souhaitez utiliser les générateurs D&D, autorisez explicitement cette fonction avant d’approuver la connexion.
  3. Revenez dans Foundry et attendez la confirmation du compte. L’accès à chaque fonction est vérifié séparément. Si la demande a expiré ou a été refusée, démarrez une nouvelle connexion.

Vous pouvez aussi générer un jeton manuel sur la page de vos appareils Foundry (il n’est affiché qu’une fois), le saisir dans « Options avancées » et cliquer sur « Vérifier et enregistrer ». Si la carte « Générateurs D&D » indique « Autorisation requise », cliquez sur « Autoriser sur JDR Ninja » pour ajouter l’accès aux générateurs.

Gérer mes appareils Foundry
Fenêtre des connexions du module JDR Ninja dans Foundry VTT
Aperçu du module local : connexion du compte et réglages de l’overlay et de Stream Deck dans Foundry.

Activer les fonctions choisies

La connexion du compte n’active aucune fonction. Dans la fenêtre « Connexions JDR Ninja », chaque carte a sa case « Activer », décochée au départ. Celles de Stream Deck, de l’overlay et des générateurs ne valent que pour ce navigateur ; celle de la synchronisation Atlas vaut pour tous les MJ du monde.

  • Générateurs D&D (MJ) : la carte indique d’abord si votre monde est compatible, puis l’accès que donne votre abonnement. Une fois les générateurs activés et disponibles, ouvrez « Monstres D&D » ou « PNJ D&D » depuis l’onglet Acteurs ou les paramètres JDR Ninja.
  • Overlay : préparez votre source OBS dans la configuration de l’overlay sur le site, puis cochez « Activer » sur la carte « Overlay VTT ». Son engrenage « Configurer l’overlay VTT » ouvre une fenêtre où l’overlay est vérifié automatiquement, avec le bouton « Envoyer un jet de test » ; ce test est réservé aux abonnés, comme le relais des jets.
  • Stream Deck : installez d’abord le plugin et démarrez la connexion locale. Dans Foundry, l’engrenage « Configurer Stream Deck » de sa carte ouvre la fenêtre où saisir l’adresse et la clé de jumelage ; « Enregistrer et activer » termine la configuration. Le guide dédié détaille la clé et le choix de la session.

Connecter votre monde Atlas

  1. Sur le site, ouvrez vos connexions Foundry et créez une connexion de synchronisation pour le monde Atlas concerné. Copiez le jeton affiché une seule fois. Vous pouvez aussi utiliser les paramètres de ce monde pour créer sa connexion.
  2. Dans Foundry, saisissez ce jeton sur la carte « Synchronisation Atlas » de la fenêtre « Connexions JDR Ninja », puis cliquez sur « Vérifier et enregistrer ». Vérifiez le nom du monde et l’accès à la synchronisation. Ce jeton est distinct de la connexion du compte et de la clé Stream Deck.
  3. Cochez « Activer » sur la carte « Synchronisation Atlas » pour ce monde Foundry, ouvrez sa fenêtre avec le bouton « Atlas » de l’onglet Acteurs et choisissez la campagne. Reliez un acteur à un personnage existant ou créez le personnage dans Atlas, puis lancez la synchronisation. Vérifiez la fiche dans Atlas.
Gérer mes connexions Atlas

Préparer des valeurs et des listes

Le module peut enregistrer des valeurs à réutiliser : un compteur, un bonus, un acteur ou une page choisis. Ouvrez « Variables et listes (avancé) » dans les paramètres du module, ou « Variables et listes » dans la fenêtre « Stream Deck ». L’onglet « Variables » contient les valeurs ; l’onglet « Listes de valeurs » contient des documents classés dans l’ordre de votre choix, par exemple vos PNJ ou vos indices. Ces réglages ne demandent ni Stream Deck ni abonnement.

Choisissez « Personnel » pour vos propres valeurs : chaque utilisateur modifie les siennes. Une valeur « Monde » est partagée par tous les utilisateurs du monde, mais seul le MJ indiqué dans « MJ responsable des variables du monde » peut la modifier.

Une variable a une « Valeur par défaut » et une « Valeur actuelle ». La liste des variables affiche la valeur actuelle de chacune, et « Modifier la valeur actuelle » permet de la changer à la main ou de rétablir la valeur par défaut. Une « Sélection dans une liste » commence sans valeur actuelle : après l’avoir enregistrée, appliquez « Rétablir la valeur par défaut ». Une « Valeur calculée » se déduit d’autres variables et ne se modifie pas directement.

Dans le champ « Expression de calcul », écrivez une variable sous la forme @{Nom}. Après une variable de document, ajoutez le chemin d’une donnée comme dans un effet actif : si « Héros en vedette » désigne un personnage, @{Héros en vedette}.system.attributes.inspiration indique s’il a l’inspiration. Le chemin dépend du système de jeu, et la donnée n’est lue que si vous pouvez voir le document.

Pour transmettre des valeurs à une macro de script, déclarez ses arguments dans « Macros compatibles (avancé) ». Cette fenêtre ne modifie pas le script : la macro doit lire ces arguments et confirmer la fin de son exécution.

Voir les exemples Stream Deck

Vérifier la première utilisation

Une fois une fonction activée, faites un premier essai complet avant la partie.

Créer une première créature

Ouvrez Monstres depuis les paramètres JDR Ninja ou l’onglet Acteurs, choisissez un profil simple et lancez une génération. Examinez l’aperçu, créez l’acteur, puis ouvrez sa fiche dans Foundry pour vérifier le résultat. Chaque nouvelle génération compte dans les limites de votre compte.

Mettre à jour un personnage dans Atlas

Modifiez un personnage relié dans Foundry, puis envoyez sa fiche depuis la fenêtre Atlas. Ouvrez sa fiche dans Atlas pour vérifier le changement avant d’envoyer toute la liste. Les modifications faites dans Atlas ne reviennent pas dans Foundry.

Voir un jet public dans OBS

Lancez dans Foundry un jet public contenant des dés et comparez le résultat dans le chat et dans la source OBS. Les jets privés, aveugles et envoyés en aparté ne sont jamais transmis.

Tester une touche Stream Deck

Commencez par une touche qui ouvre une fiche, puis préparez les touches d’une scène : activation, ambiance sonore et obscurité, chaque commande sur sa touche. Le guide Stream Deck propose ensuite des exemples pour la partie.

Préparer les touches d’une scène

Si vous utilisez les anciens modules

Désactivez Atlas Character Sync et l’ancien module VTT Overlay s’ils sont installés : tant qu’un ancien module est actif, l’intégration correspondante du module JDR Ninja reste indisponible. Quand un MJ ouvre le monde, le module reprend le jeton, l’adresse et la campagne d’Atlas Character Sync ; activez ensuite la synchronisation Atlas dans la fenêtre « Connexions JDR Ninja ». Rien n’est repris de l’ancien module VTT Overlay : reliez à nouveau votre compte.

Une synchronisation Atlas réussie peut reprendre les liens des acteurs existants. Une déconnexion locale efface le jeton enregistré dans le module, mais ne le révoque pas sur le site. Utilisez les pages de gestion pour révoquer un appareil ou une connexion.

En cas de problème

La connexion a expiré ou a été refusée

Relancez la connexion depuis Foundry et utilisez le nouveau code. Vérifiez que vous approuvez le bon appareil et le bon compte. Une demande annulée ou expirée ne peut pas être réutilisée.

Mon compte est relié, mais une fonction reste inaccessible

Vérifiez le message affiché pour cette fonction : autorisation de l’appareil, abonnement, permissions MJ, compatibilité et activation sont des conditions distinctes. Un jeton Atlas ne donne pas accès aux générateurs D&D. Si le jeton a été révoqué, reliez l’appareil à nouveau.

Les générateurs refusent ma version de Foundry ou de D&D5e

La cible actuelle est Foundry V14 avec D&D5e 5.3.3. Le minimum de chargement du module et les systèmes acceptés par Atlas ne modifient pas cette condition. Consultez la compatibilité affichée dans la fenêtre du générateur.

La synchronisation Atlas ne démarre pas

Vérifiez votre rôle MJ, l’interrupteur Atlas du monde, le système de jeu, le jeton du bon monde et l’accès à la synchronisation. Désactivez l’ancien module Atlas Character Sync s’il est encore actif. Le compte relié pour l’overlay ne remplace pas la connexion Atlas.

Les dés ne s’affichent pas dans OBS

Vérifiez que « Activer » est coché sur la carte « Overlay VTT » dans ce navigateur, puis l’overlay actif sur le site, la source navigateur OBS et l’abonnement. Lancez un jet public contenant des dés. Les jets privés ne sont jamais transmis. Consultez la section « Diagnostic » de la fenêtre « Overlay VTT » et désactivez l’ancien module overlay s’il est actif.

Stream Deck ne trouve pas la session Foundry

Vérifiez que la connexion locale est démarrée sur le même ordinateur que le navigateur Foundry et l’application Stream Deck, et qu’elle est activée dans Foundry. Quand Foundry s’est reconnecté, sélectionnez à nouveau la session sur les touches concernées. Le guide Stream Deck détaille la clé de jumelage et les adresses autorisées.