Module Foundry VTT · daria-foundry

Daria pour Foundry VTT

Daria enregistre l’audio de vos sessions et le transforme en transcription. Ce module y ajoute ce que le micro n’entend pas : les dés, les sorts, les objets et les états récoltés en chemin — placés sur la même ligne de temps que les paroles.

Ce qui est capturé

• Les jets de dés, avec leur nature, les critiques et les échecs critiques
• Les lancers de sorts, avec le niveau d’emplacement réellement dépensé — et les sorts affichés dans le chat sans être lancés, distingués de ceux qui le sont
• L’utilisation d’objets, et les objets affichés dans le chat sans être utilisés
• Les états et effets actifs gagnés ou perdus — À terre subi, Bénédiction dissipée
• Les prises de parole en conversation, quand le module Conversation HUD est actif — l’ouverture ou la fermeture d’une conversation, et le participant que le MJ marque comme prenant la parole, ainsi que sa faction lorsqu’elle est affichée. Daria s’en sert comme indices pour attribuer au bon PNJ les répliques jouées par le MJ dans la transcription.

Sur le système dnd5e, ces événements arrivent enrichis, avec le nom des cibles sur les jets d’attaque et de dégâts. Les autres systèmes de jeu bénéficient de la capture simple des jets et des effets.

Ce qui sort de votre monde

Uniquement des événements de jeu, et uniquement pendant un enregistrement Daria :

• Le module ne s’exécute que sur le client du maître du jeu. Les clients des joueurs n’envoient rien.
• Les jets cachés le restent. Les jets chuchotés, aveugles et privés sont filtrés dans Foundry et ne sont jamais transmis.
• Les effets ne sont capturés que pour les acteurs visibles appartenant aux joueurs. Ce que vous gardez derrière votre écran de MJ y reste.
• Les conversations ne sont capturées que lorsqu’elles sont montrées aux joueurs. Une conversation invisible est une préparation non révélée : ses participants ne quittent jamais Foundry. Un participant dont vous masquez le nom est signalé comme personnage non révélé — son nom n’est jamais envoyé.
• Les messages de chat ne sont jamais envoyés. Ni les descriptions, ni les narrations. Le texte de « flavor » d’un jet, lui, voyage avec ce jet (plafonné à 500 caractères), et chaque événement porte le nom d’affichage du joueur Foundry en plus du nom du personnage.
• Le module se signale au chargement. Il indique au serveur sa version, celle de Foundry et le système de jeu utilisé — aucune donnée de monde, de campagne ou de joueur — et le serveur répond si votre jeton est accepté, si un enregistrement est en cours et si votre module doit être mis à jour. C’est cette réponse qui s’affiche dans le bandeau en haut de la fenêtre à l’ouverture de votre monde.
• Les événements sont envoyés au serveur à intervalles réguliers dès qu’un jeton est configuré. En dehors d’un enregistrement actif, le serveur rejette le lot et ne stocke rien : les événements restent mis en mémoire tampon localement et sont réessayés — une coupure réseau ne fait perdre aucune donnée, et chaque événement conserve l’instant où il s’est produit : envoyé en retard, il se place quand même au bon moment de votre partie, et non là où en était l’enregistrement à son arrivée.

Les événements sont envoyés à https://hooks.daria.gg, authentifiés avec le jeton d’API de votre campagne. Daria stocke toutes les données dans l’UE.

Prérequis

• Foundry VTT v12, v13 ou v14
• Une campagne Daria sur votre serveur Discord
• Un jeton d’API, délivré depuis la page de votre campagne dans l’application web Daria

Installation

Dans Foundry, ouvrez Modules complémentaires → Installer un module, collez cette URL de manifeste dans le champ en bas, puis cliquez sur Installer :

Configuration

Ouvrez Configurer les paramètres → Daria — Game Event Capture. Seul le maître du jeu voit ces réglages.

• Jeton d’API Daria — stocké sur votre client uniquement et retenu pour ce monde seul, jamais synchronisé vers les joueurs. Collez-y le jeton de votre campagne ; la capture démarre dès qu’il est renseigné.
• Capture des jets de dés / des sorts / des objets / des états et effets / des prises de parole — cinq interrupteurs indépendants, partagés par tout le monde de jeu. Tous activés par défaut.
• Journalisation de débogage — écrit chaque événement capturé dans la console du navigateur (F12). Désactivée par défaut ; activez-la pour signaler un problème.

Il n’y a rien d’autre à configurer — le module communique toujours avec le service Daria hébergé.

Support

Signalez un problème ou posez une question dans le forum #help de notre Discord. Indiquez la version du module, celle de Foundry, votre système de jeu, et ce qu’affiche la console du navigateur.

Licence

Le module daria-foundry est libre d’installation, d’utilisation et de redistribution avec le service Daria, pour des parties personnelles comme commerciales. Il est fourni tel quel, sans garantie d’aucune sorte. Cette licence ne couvre que le module : elle n’accorde aucun droit sur le service Daria, son nom ou ses illustrations.

Journal des versions

0.10.0

• Un objet ou un sort affiché seul dans le chat — via « Display in Chat » de dnd5e, ou en cliquant sur un objet qui ne déclenche aucun jet de dés — est désormais capturé aussi. Jusqu’ici, seuls les usages réels l’étaient, si bien qu’un sort mis sous les yeux de la table pour être lu à voix haute ne laissait aucune trace dans la transcription.
• Ces cartes sont enregistrées comme affichées et non comme utilisées, si bien que votre transcription indique « montre Boule de feu » et non « lance Boule de feu », et aucun emplacement de sort n’est comptabilisé pour un sort que personne n’a lancé.

0.9.0

• Votre jeton d’API est désormais retenu par monde, et non plus par navigateur. Si vous menez plusieurs campagnes depuis la même installation Foundry, chaque monde conserve son propre jeton : auparavant ils n’en partageaient qu’un seul, si bien qu’un deuxième monde envoyait ses jets à la première campagne — ou nulle part, si aucun enregistrement n’y était en cours. Rien à faire à la mise à jour : un monde qui avait déjà un jeton le garde, et vous n’avez à en coller un que dans un monde relevant d’une autre campagne.
• La bannière affichée au chargement de votre monde nomme maintenant la campagne à laquelle vous êtes connecté : vous voyez d’un coup d’œil que ce monde alimente la bonne.

0.8.0

• Le module interroge désormais Daria au chargement de votre monde et vous dit ce qu’il a trouvé : jeton d’API accepté ou non, serveur joignable, enregistrement en cours — et, nouveauté, si votre version du module est dépassée ou trop ancienne pour le serveur. Auparavant, un jeton manquant ou refusé passait inaperçu et ne se découvrait qu’après la partie, en ne trouvant aucun jet dans la transcription. Le verdict s’affiche dans un bandeau en haut de la fenêtre Foundry — une notification Foundry standard — et disparaît de lui-même. Ensuite, le module ne dit plus rien du tout — aucune notification pendant la partie, quoi qu’il arrive — et ne peut donc jamais interrompre une scène. Si le serveur devient injoignable en cours de partie, les captures sont mises en mémoire tampon et envoyées dès qu’il répond de nouveau ; la mémoire tampon contient une partie entière — douze heures de jeu soutenu — si bien qu’une coupure durant toute la soirée ne coûte rien.
• Coller ou modifier votre jeton d’API relance aussitôt cette vérification : vous savez s’il fonctionne sans quitter la fenêtre des réglages.
• Cette prise de contact transmet la version du module, celle de Foundry et le système de jeu, afin que le support puisse répondre sans vous demander d’ouvrir une console. Aucune donnée de monde ni de campagne n’est incluse.

0.7.0

• Capture Conversation HUD : ouverture et fermeture des conversations, et participant marqué comme prenant la parole par le MJ — utilisés comme indices de locuteur dans les transcriptions. Nécessite le module Conversation HUD ; les conversations invisibles ne sont jamais envoyées, les noms masqués sont signalés comme personnage non révélé, et la faction du participant est incluse lorsqu’elle est affichée.

0.6.0

• Publication de la documentation du module et du canal de support ; aucun changement de jeu.

0.5.0

• Capture des états et effets pour les acteurs visibles appartenant aux joueurs.
• Enrichissement dnd5e : nature du jet, critiques et échecs critiques, niveaux d’emplacement, noms des cibles.
• Mise en mémoire tampon locale et envoi par lots, pour ne rien perdre en cas de coupure.