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.

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.
• 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.
• 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 speichert alle Daten in der EU.

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 erfassen — fünf 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.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.