Foundry-VTT-Modul · daria-foundry

Daria für Foundry VTT

Daria nimmt das Audio eurer Runde auf und macht ein Transkript daraus. Dieses Modul ergänzt, was das Mikrofon nicht hören kann: die Würfel, die Zauber, die Gegenstände und die Zustände, die eure Gruppe unterwegs aufgesammelt hat — eingeordnet auf derselben Zeitachse wie die gesprochenen Worte.

Was erfasst wird

• Würfelwürfe, samt Art des Wurfs, Kritischen und Patzern
• Gewirkte Zauber, samt tatsächlich verbrauchtem Zauberplatz — und Zauber, die nur im Chat angezeigt wurden, getrennt von denen, die gewirkt wurden
• Benutzte Gegenstände und Gegenstände, die nur im Chat angezeigt wurden
• Erhaltene oder verlorene Zustände und aktive Effekte — Liegend erhalten, Segnen verloren
• Wer in einem Gespräch spricht, wenn das Modul Conversation HUD aktiv ist — das Öffnen oder Schließen eines Gesprächs und welchen Teilnehmer der SL als sprechend markiert, samt dessen Fraktion, sofern sie angezeigt wird. Daria nutzt das als Hinweis, um die vom SL gespielten Repliken im Transkript dem richtigen NSC zuzuordnen.
• Bilder, die ihr der Runde mit „Show Players“ zeigt — in eurem Browser verkleinert, wo er sie dekodieren kann, und immer auf Darias Seite neu codiert, bevor sie gespeichert werden; nie mehr als 1 MB verlässt euren Browser
• Das Porträt benannter NSCs und Monster, die ihr kontrolliert — oder ihre Token-Grafik, wenn sie keines haben —, sobald ein Kampf begonnen hat — wenn er beginnt und wenn sie einem bereits laufenden beitreten

Im System dnd5e kommen diese angereichert an, mit den Namen der anvisierten Token bei Angriffs- und Schadenswürfen. Andere Spielsysteme bekommen weiterhin die einfache Erfassung von Würfen und Effekten.

Was eure Welt verlässt

Nur Spielereignisse, und nur während eine Daria-Aufnahme läuft. Im Einzelnen:

• Das Modul läuft ausschließlich auf dem Client der Spielleitung. Die Clients der Spielenden senden nichts.
• Verdeckte Würfe bleiben verdeckt. Geflüsterte, blinde und private Würfe werden innerhalb von Foundry herausgefiltert und niemals übertragen.
• Effekte werden nur für sichtbare Akteure erfasst, die Spielenden gehören. Was ihr hinter dem Schirm versteckt habt, bleibt dort.
• Gespräche werden nur erfasst, solange sie den Spielenden gezeigt werden. Ein unsichtbares Gespräch ist unenthüllte Vorbereitung, und seine Teilnehmer verlassen Foundry nie. Ein Teilnehmer, dessen Namen ihr verbergt, wird als unbekannter Charakter gemeldet — der Name selbst wird nie gesendet.
• Zwei Arten von Bildern werden übertragen. Jedes wird in eurem Browser verkleinert, wo er die Quelle dekodieren kann, auf Darias Seite immer auf höchstens 1024 px an der langen Seite neu codiert, bevor es gespeichert wird, und nie verlässt mehr als 1 MB euren Browser: Bilder, die ihr bewusst mit „Show Players“ teilt — aus dem Bildbetrachter oder von einer Bildseite im Journal —, samt dem von Foundry angehängten Titel, und das Porträt benannter, von der Spielleitung kontrollierter Kombattanten (oder ihre Token-Grafik, wenn sie keines haben), sobald ein Kampf begonnen hat — wenn er beginnt und wenn sie einem bereits laufenden beitreten. Nie Szenenhintergründe, Journaltext oder Bilder, die nur für euch geöffnet sind; nie verdeckte Token oder Kombattanten, solange ihr sie nicht aufdeckt; nie die Token eurer Spielenden; nie unverknüpfte Kopien wie „Goblin 3“. Jede Art hat eine eigene Einstellung zum Abschalten.
• Chat-Nachrichten werden nie gesendet. Weder Beschreibungen noch Erzähltext. Der Beschreibungstext eines Wurfs reist allerdings mit ihm mit (auf 500 Zeichen begrenzt), und jedes Ereignis trägt den Anzeigenamen der Foundry-Spielperson neben dem Charakternamen.
• Das Modul meldet sich beim Laden. Es teilt dem Server mit, welche Modulversion, welche Foundry-Version und welches Spielsystem es nutzt — keine Welt-, Kampagnen- oder Spielerdaten — und der Server antwortet, ob euer Token akzeptiert wird, ob eine Aufnahme läuft und ob euer Modul aktualisiert werden muss. Diese Antwort seht ihr im Hinweisbanner oben im Fenster, wenn ihr eure Welt öffnet.
• Das Modul meldet eigene Fehler. Wenn der Code des Moduls fehlschlägt, sendet es den Fehler an denselben Server — Typ, Nachricht und Stelle im Modul, dazu Modul-, Foundry- und Spielsystemversion — damit wir ihn beheben können. Die Adresse eures Foundry-Servers wird vorher entfernt, und es werden keine Daten aus eurer Welt hinzugefügt. Fehler aus Foundry selbst oder aus anderen Modulen werden nie gesendet, und es werden maximal zwanzig Fehler pro Weltstart übermittelt.
• Ereignisse werden in regelmäßigem Takt an den Server geschickt, sobald ein Token eingerichtet ist. Außerhalb einer laufenden Aufnahme weist der Server das Paket ab und speichert nichts, die Ereignisse bleiben also lokal gepuffert und werden erneut versucht — ein Netzausfall verliert keine Daten, und jedes Ereignis behält den Zeitpunkt, zu dem es passiert ist, sodass eine späte Zustellung trotzdem an der richtigen Stelle eurer Runde landet und nicht dort, wo die Aufnahme bei ihrer Ankunft gerade war.

Die Ereignisse gehen an https://hooks.daria.gg, authentifiziert mit dem API-Token eurer Kampagne. Daria wird in der EU gehostet.

Voraussetzungen

• Foundry VTT v12, v13 oder v14
• Eine Daria-Kampagne auf eurem Discord-Server
• Ein API-Token, ausgestellt auf der Seite eurer Kampagne in der Daria-Web-App

Installation

Öffnet in Foundry Zusatzmodule → Modul installieren, fügt diese Manifest-URL in das Feld ganz unten ein und klickt auf Installieren:

Einrichtung

Öffnet Einstellungen konfigurieren → Daria — Game Event Capture. Nur die Spielleitung sieht sie.

• Daria-API-Token — wird nur auf eurem eigenen Client und nur für diese Welt gespeichert und nie zu den Spielenden synchronisiert. Fügt hier das Token eurer Kampagne ein; die Erfassung startet, sobald es gesetzt ist.
• Würfelwürfe / gewirkte Zauber / benutzte Gegenstände / Zustands- und Effektänderungen / Gesprächsstimmen / den Spielenden gezeigte Bilder / Token-Grafik von Kombattanten erfassen — sieben unabhängige Schalter, die für die ganze Welt gelten. Alle standardmäßig an.
• Debug-Protokollierung — schreibt jedes erfasste Ereignis in die Browser-Konsole (F12). Standardmäßig aus; schaltet sie ein, wenn ihr ein Problem meldet.

Mehr gibt es nicht einzurichten — das Modul spricht immer mit dem gehosteten Daria-Dienst.

Support

Meldet ein Problem oder stellt eine Frage im #help-Forum auf unserem Discord. Gebt eure Modulversion, eure Foundry-Version, euer Spielsystem und alles an, was die Browser-Konsole ausgegeben hat.

Lizenz

Das Modul daria-foundry darf frei installiert, genutzt und zusammen mit dem Daria-Dienst weitergegeben werden, für private wie kommerzielle Runden gleichermaßen. Es wird ohne jede Gewährleistung bereitgestellt, so wie es ist. Diese Lizenz deckt nur das Modul ab: sie gewährt keinerlei Rechte am Daria-Dienst, seinem Namen oder seinen Bildern.

Änderungsprotokoll

0.13.0

• Bilder, die ihr aus einem Journal zeigt, werden jetzt erfasst. Bisher ging „Show Players“ auf einer Bildseite im Journal verloren — egal, ob dabei die Seite selbst oder nur das Bild geöffnet wird —, sodass ein so gezeigtes Handout nie in eurem Transkript landete; erfasst wurde nur der Button im Bildbetrachter. Textseiten und ganze Journaleinträge werden weiterhin nie gesendet.
• Kombattanten werden jetzt mit ihrem vollständigen Porträt erfasst statt mit ihrer Token-Grafik, die oft für den Token-Ring zugeschnitten ist. Hat ein NSC oder Monster kein eigenes Porträt, wird weiterhin die Token-Grafik verwendet.
• Ein benannter NSC oder ein Monster, das beim Kampfbeginn verborgen war — in der Kampfübersicht oder auf der Karte —, wird jetzt in dem Moment erfasst, in dem ihr es aufdeckt, statt gar nicht. Es wird weiterhin nur einmal gesendet, und nur, wenn der Kampf begonnen hat.

0.12.0

• Wenn im Modul selbst etwas schiefgeht, meldet es den Fehler jetzt an Daria, damit wir ihn beheben können — auch Fehler beim Laden eurer Welt, die bisher genauso aussahen wie ein nicht gestartetes Foundry. Die Meldungen gehen an denselben Server wie eure Spielereignisse, enthalten nie Inhalte aus Welt, Kampagne oder Spielern oder die Adresse eures Foundry-Servers und umfassen keine Fehler aus Foundry selbst oder anderen Modulen.

0.11.0

• Bilder, die ihr der Runde mit dem „Show Players“ des Bildbetrachters zeigt, werden jetzt erfasst. Jedes landet im Sitzungstranskript genau in dem Moment, in dem ihr es gezeigt habt, sodass ein Handout oder ein Porträt, das niemand laut beschrieben hat, nicht mehr im Protokoll fehlt.
• Wenn ein benannter NSC oder ein Monster, das ihr kontrolliert, einem Kampf beitritt, sobald dieser begonnen hat — wenn er beginnt oder wenn es einem bereits laufenden beitritt —, wird auch dessen Token-Grafik erfasst, und das Transkript vermerkt, wer zu diesem Zeitpunkt dem Kampf beigetreten ist. Nie verdeckte Token oder Kombattanten, nie die Token eurer Spielenden, und nie unverknüpfte Kopien wie „Goblin 3“.
• Erfasst werden nur ausdrückliche Freigaben und Kombattanten, sobald ein Kampf begonnen hat: nie Szenenhintergründe, Journalseiten oder Bilder, die ihr nur für euch öffnet. Bilder werden in eurem Browser verkleinert, wo er sie dekodieren kann, und immer auf Darias Seite neu codiert, bevor sie gespeichert werden — nie verlässt mehr als 1 MB euren Browser —, und zwei neue Einstellungen — „Capture images shown to players“ und „Capture combatant token art“ — schalten jede einzeln ab.

0.10.0

• Ein Gegenstand oder Zauber, der allein im Chat gepostet wird — „Display in Chat“ von dnd5e oder das Anklicken eines Gegenstands ohne Angriff, Schaden oder Rettungswurf — wird jetzt ebenfalls erfasst. Bisher wurden nur tatsächliche Anwendungen aufgenommen, sodass ein Zauber, den jemand der Runde zum Vorlesen zeigte, keine Spur im Transkript hinterließ.
• Diese Karten werden als angezeigt statt als benutzt aufgezeichnet, sodass in eurem Transkript „zeigt Feuerball“ statt „wirkt Feuerball“ steht und kein Zauberplatz für einen Zauber vermerkt wird, den niemand gewirkt hat.

0.9.0

• Euer API-Token wird jetzt pro Welt gemerkt statt pro Browser. Wenn ihr mehrere Kampagnen aus derselben Foundry-Installation leitet, behält jede Welt ihr eigenes Token — bisher teilten sie sich eines, sodass eine zweite Welt ihre Würfe an die erste Kampagne schickte oder, wenn dort keine Aufnahme lief, ins Leere. Beim Update ist nichts zu tun: Eine Welt, die schon ein Token hatte, behält es, und einfügen müsst ihr nur dort, wo eine Welt zu einer anderen Kampagne gehört.
• Das Banner beim Laden eurer Welt nennt jetzt die Kampagne, mit der ihr verbunden seid — so seht ihr auf einen Blick, dass diese Welt die richtige speist.

0.8.0

• Das Modul meldet sich jetzt beim Laden eurer Welt bei Daria und sagt euch, was es vorgefunden hat: ob euer API-Token akzeptiert wird, ob der Server erreichbar ist, ob eine Aufnahme läuft — und, neu, ob eure Modulversion veraltet oder zu alt für den Server ist. Früher blieb ein fehlendes oder abgelehntes Token stumm, und ihr habt es erst nach der Runde gemerkt, als im Transkript keine Würfel auftauchten. Das Ergebnis erscheint als Banner oben im Foundry-Fenster — Foundrys eigene Benachrichtigung — und verschwindet von selbst. Danach sagt das Modul überhaupt nichts mehr — keine Benachrichtigungen während des Spiels, was auch passiert — und kann so nie eine Szene unterbrechen. Fällt der Server mitten in der Runde aus, werden die Erfassungen gepuffert und gesendet, sobald er wieder antwortet; der Puffer fasst eine ganze Runde — zwölf Stunden durchgehendes Spiel — sodass selbst ein Ausfall über den ganzen Abend nichts kostet.
• Wenn ihr euer API-Token einfügt oder ändert, läuft diese Prüfung sofort erneut: ihr erfahrt noch im Einstellungsdialog, ob es funktioniert.
• Diese Meldung übermittelt eure Modulversion, eure Foundry-Version und euer Spielsystem, damit der Support antworten kann, ohne euch zu bitten, eine Konsole zu öffnen. Es sind keine Welt- oder Kampagnendaten enthalten.

0.7.0

• Conversation-HUD-Erfassung: Beginn und Ende eines Gesprächs und der Teilnehmer, den der SL als sprechend markiert — genutzt als Sprecherhinweise in Rundentranskripten. Erfordert das Modul Conversation HUD; unsichtbare Gespräche werden nie gesendet, verborgene Teilnehmernamen werden als unbekannter Charakter gemeldet, und die Fraktion der sprechenden Person wird mitgeschickt, sofern sie angezeigt wird.

0.6.0

• Moduldokumentation und Support-Kanal veröffentlicht; keine Änderungen am Spiel.

0.5.0

• Erfassung von Zuständen und Effekten für sichtbare Akteure, die Spielenden gehören.
• dnd5e-Anreicherung: Art des Wurfs, Kritische und Patzer, Zauberplatzstufen, Namen der anvisierten Token.
• Lokale Pufferung mit gebündelter Übertragung, damit kurze Ausfälle nichts verlieren.