Module Foundry VTT · daria-foundry

Daria pour Foundry VTT

Daria enregistre l’audio de votre session et en tire une transcription. Ce module y ajoute ce que le micro ne peut pas entendre : les dés, les sorts, les objets et les états dont votre groupe a hérité en chemin — le tout placé sur la même chronologie que les paroles.

Ce qu’il capte

• Les jets de dés : leur type, les critiques et les échecs critiques
• Les sorts lancés, avec le niveau d’emplacement réellement dépensé — ainsi que les sorts simplement affichés dans le chat, sans être lancés, que le module distingue des autres
• L’utilisation des objets, ainsi que les objets affichés dans le chat sans être utilisés
• Les états et effets actifs gagnés ou perdus — un personnage À terre, une Bénédiction qui prend fin
• Les prises de parole en conversation, si le module Conversation HUD est actif : l’ouverture ou la fermeture d’une conversation, et le participant que le MJ désigne comme celui qui parle, avec sa faction quand elle est affichée. Daria s’en sert comme d’indices pour attribuer au bon PNJ, dans la transcription, les répliques que le MJ prononce en jeu.
• Les images que vous montrez à la table avec « Show Players » : réduites dans votre navigateur quand il sait les décoder, toujours réencodées côté Daria avant d’être conservées — et jamais plus d’1 Mo ne quitte votre navigateur
• Le portrait des PNJ et monstres nommés que vous contrôlez — ou l’illustration de leur jeton s’ils n’en ont pas —, une fois le combat lancé — au moment où il commence, ou quand ils rejoignent un combat déjà en cours

Avec le système dnd5e, ces événements arrivent enrichis : le nom des jetons ciblés accompagne les jets d’attaque et de dégâts. Les autres systèmes de jeu bénéficient tout de même de la capture simple des jets et des effets.

Ce qui sort de votre monde

Uniquement des événements de jeu, et seulement pendant un enregistrement Daria. Dans le détail :

• Le module ne s’exécute que sur le client du MJ. Ceux des joueurs n’envoient rien.
• Les jets cachés le restent. Les jets privés, aveugles et personnels sont filtrés dans Foundry même et ne sont jamais transmis.
• Les effets ne sont capturés que sur les acteurs visibles appartenant aux joueurs. Ce que vous cachez derrière l’écran y reste.
• Une conversation n’est capturée que lorsqu’elle est montrée aux joueurs. Une conversation invisible relève de la préparation, pas encore révélée : ses participants ne quittent jamais Foundry. Si vous masquez le nom d’un participant, il est signalé comme un personnage non révélé — son nom, lui, n’est jamais envoyé.
• Deux sortes d’images sont transmises. Chacune est réduite dans votre navigateur quand celui-ci sait décoder la source, toujours réencodée côté Daria à 1024 px au plus sur son grand côté avant d’être conservée, et jamais plus d’1 Mo ne quitte votre navigateur. Il s’agit d’une part des images que vous partagez volontairement avec « Show Players », depuis la visionneuse d’images ou depuis une page d’image d’un journal, accompagnées du titre que Foundry leur associe ; d’autre part du portrait des combattants nommés contrôlés par le MJ (ou de l’illustration de leur jeton s’ils n’ont pas de portrait), une fois le combat lancé — au moment où il commence, ou quand ils rejoignent un combat déjà en cours. Jamais les fonds de scène, le texte des journaux ni les images ouvertes sur votre seul écran ; jamais les jetons ou combattants cachés tant que vous ne les révélez pas ; jamais les jetons de vos joueurs ; jamais les copies non liées comme « Gobelin 3 ». Chaque sorte d’image a son propre réglage pour la désactiver.
• Les messages du chat ne sont jamais envoyés. Ni les descriptions, ni la narration. Le texte d’ambiance d’un jet (le « flavor ») voyage en revanche avec lui, dans la limite de 500 caractères, et chaque événement indique le nom d’affichage du joueur Foundry à côté de celui du personnage.
• Le module se manifeste à son chargement. Il indique au serveur sa propre version, celle de Foundry et le système de jeu utilisé — aucune donnée de monde, de campagne ou de joueur. Le serveur lui répond si votre jeton d’API est accepté, si un enregistrement est en cours et si le module doit être mis à jour. C’est cette réponse qui s’affiche dans le bandeau en haut de la fenêtre quand vous ouvrez votre monde.
• Le module signale ses propres erreurs. Si son propre code échoue, le module envoie l’erreur au même serveur — son type, son message et l’endroit du module où elle s’est produite, avec les versions du module, de Foundry et du système de jeu — pour que nous puissions la corriger. L’adresse de votre serveur Foundry est retirée au préalable, et rien de votre monde n’y est ajouté. Les erreurs de Foundry lui-même ou de vos autres modules ne sont jamais envoyées, et vingt erreurs au plus partent à chaque chargement de votre monde.
• Dès qu’un jeton d’API est configuré, les événements partent vers le serveur à intervalles réguliers. Hors enregistrement, le serveur refuse le lot et ne stocke rien : les événements restent alors en mémoire tampon localement et sont renvoyés plus tard. Une coupure réseau ne fait donc rien perdre, et chaque événement garde l’instant où il s’est produit : même livré en retard, il se place au bon moment de votre session, et non là où en était l’enregistrement à son arrivée.

Les événements sont envoyés à https://hooks.daria.gg, authentifiés par le jeton d’API de votre campagne. Daria est hébergée dans l’UE.

Prérequis

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

Installation

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

Configuration

Ouvrez Configurer les paramètres → Daria — Game Event Capture. Ces réglages ne sont visibles que du MJ.

• Jeton d’API Daria — stocké sur votre propre client, mémorisé pour ce seul monde et jamais synchronisé vers les joueurs. Collez ici le jeton de votre campagne ; la capture commence dès qu’il est renseigné.
• Capturer les jets de dés / les sorts lancés / l’utilisation des objets / les changements d’états et d’effets / les prises de parole / les images montrées aux joueurs / l’illustration des jetons de combattants — sept interrupteurs indépendants, valables pour l’ensemble du monde de jeu. Tous activés par défaut.
• Journalisation de débogage — consigne dans la console du navigateur (F12) chaque événement capturé et chaque envoi. Désactivée par défaut ; activez-la si vous signalez un problème.

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

Assistance

Pour signaler un problème ou poser une question, rendez-vous sur le forum #help de notre Discord. Précisez la version du module, celle de Foundry, votre système de jeu, ainsi que tout ce que la console du navigateur a affiché.

Licence

Le module daria-foundry peut être librement installé, utilisé et redistribué avec le service Daria, pour des parties personnelles comme commerciales. Il est fourni en l’état, sans aucune garantie. Cette licence ne porte que sur le module : elle ne confère aucun droit sur le service Daria, son nom ou ses illustrations.

Historique des versions

0.13.0

• Les images que vous montrez depuis un journal sont désormais capturées. Jusqu’ici, « Show Players » sur une page d’image de journal — qu’il ouvre la page ou n’affiche que l’image — passait inaperçu : une aide de jeu montrée de cette façon n’arrivait jamais dans votre transcription, seul le bouton de la visionneuse d’images était pris en compte. Les pages de texte et les entrées de journal complètes ne sont toujours jamais envoyées.
• Un combattant est désormais capturé avec son portrait complet plutôt qu’avec l’illustration de son jeton, souvent recadrée pour tenir dans l’anneau du jeton. L’illustration du jeton reste utilisée pour un PNJ ou un monstre qui n’a pas de portrait.
• Un PNJ ou monstre nommé caché au lancement du combat — dans le suivi de combat ou sur la carte — est désormais capturé au moment où vous le révélez, alors qu’il ne l’était jamais. Il n’est toujours envoyé qu’une fois, et seulement une fois le combat lancé.

0.12.0

• Quand une erreur survient dans le module lui-même, il la signale désormais à Daria pour que nous puissions la corriger — y compris un échec au chargement de votre monde, qui jusqu’ici ressemblait en tout point à un Foundry tout simplement fermé. Ces rapports partent vers le même serveur que vos événements ; ils ne contiennent jamais de contenu de monde, de campagne ou de joueur, ni l’adresse de votre serveur Foundry, et n’incluent jamais les erreurs de Foundry lui-même ni celles de vos autres modules.

0.11.0

• Les images que vous montrez à la table avec l’option « Show Players » de la visionneuse d’images sont désormais capturées. Chacune s’insère dans la transcription de la session au moment où vous l’avez montrée : une aide de jeu ou un portrait que personne n’a décrit à voix haute ne manque plus au compte rendu.
• Quand un PNJ ou un monstre nommé que vous contrôlez prend part à un combat — au moment où celui-ci commence, ou en le rejoignant alors qu’il est déjà en cours —, l’illustration de son jeton est capturée elle aussi, et la transcription note à quel moment il est entré dans la bataille. Jamais les jetons ou combattants cachés, jamais les jetons de vos joueurs, jamais les copies non liées comme « Gobelin 3 ».
• Seuls les partages explicites, et les combattants une fois le combat lancé, sont capturés : jamais les fonds de scène, les pages de journal ni les images que vous ouvrez sur votre seul écran. Les images sont réduites dans votre navigateur quand il sait les décoder, toujours réencodées côté Daria avant d’être conservées, et jamais plus d’1 Mo ne quitte votre navigateur. Deux nouveaux réglages, « Capture images shown to players » et « Capture combatant token art », permettent de désactiver chacune de ces captures.

0.10.0

• Un objet ou un sort affiché seul dans le chat — via « Display in Chat » dans dnd5e, ou en cliquant sur un objet qui n’a aucun jet à faire — est désormais capturé lui aussi. Jusqu’ici, seules les utilisations réelles l’étaient : un sort qu’un joueur présentait à la table pour le lire à voix haute ne laissait aucune trace dans la transcription.
• Ces cartes sont enregistrées comme montrées, et non comme utilisées : votre transcription indique « montre Boule de feu » et non « lance Boule de feu », et aucun emplacement de sort n’est rapporté pour un sort que personne n’a lancé.

0.9.0

• Votre jeton d’API est désormais mémorisé par monde, et non plus par navigateur. Si vous menez plusieurs campagnes sur la même installation de Foundry, chaque monde garde son propre jeton. Avant, ils se partageaient le même : un deuxième monde envoyait ses jets à la première campagne, ou nulle part si celle-ci n’avait aucun enregistrement en cours. Rien à faire lors de la mise à jour : un monde qui avait déjà un jeton le conserve, et vous n’avez à coller un jeton que dans un monde rattaché à une autre campagne.
• Le bandeau affiché au chargement de votre monde indique désormais la campagne à laquelle vous êtes connecté : vous vérifiez d’emblée que ce monde alimente la bonne.

0.8.0

• Au chargement de votre monde, le module prend désormais contact avec Daria et vous dit ce qu’il a constaté : si votre jeton d’API est accepté, si le serveur répond, si un enregistrement est en cours — et, nouveauté, si votre version du module est dépassée ou trop ancienne pour le serveur. Avant, un jeton manquant ou refusé passait inaperçu : on ne s’en rendait compte qu’après la session, en ne trouvant aucun dé dans la transcription. Le verdict s’affiche dans un bandeau en haut de la fenêtre de Foundry — la notification propre à Foundry — puis disparaît tout seul. Après cela, le module se tait complètement — aucune notification en cours de partie, quoi qu’il arrive — et ne peut donc jamais interrompre une scène. Si le serveur disparaît en pleine session, les captures sont gardées en mémoire tampon et envoyées dès qu’il répond de nouveau ; cette mémoire peut contenir une session entière, soit douze heures de jeu soutenu, si bien que même une panne qui dure 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 avant même d’avoir quitté la fenêtre des réglages.
• Lors de cette prise de contact, le module indique sa version, celle de Foundry et le système de jeu, pour que l’assistance puisse répondre sans vous demander d’ouvrir une console. Aucune donnée de monde ou de campagne n’est incluse.

0.7.0

• Capture de Conversation HUD : l’ouverture et la fermeture des conversations, et le participant que le MJ désigne comme celui qui parle — utilisés comme indices pour identifier les locuteurs dans les transcriptions de session. Nécessite le module Conversation HUD ; les conversations invisibles ne sont jamais envoyées, un participant au nom masqué est signalé comme personnage non révélé, et la faction de celui qui parle est incluse lorsqu’elle est affichée.

0.6.0

• Documentation du module et canal d’assistance publiés ; aucun changement côté jeu.

0.5.0

• Capture des états et des effets pour les acteurs visibles appartenant aux joueurs.
• Enrichissement dnd5e : type de jet, critiques et échecs critiques, niveaux d’emplacement de sort, noms des jetons ciblés.
• Mise en mémoire tampon locale et envoi par lots : une courte coupure ne fait perdre aucun événement.