Zum Hauptinhalt springen

Foundry-VTT-Modul

Das JDR-Ninja-Modul in Foundry VTT installieren und einrichten

Bereiten Sie die Installation vor, verbinden Sie Ihr JDR-Ninja-Konto und aktivieren Sie die passenden Funktionen. Die Atlas-Synchronisierung benötigt zusätzlich eine Verbindung zur jeweiligen Welt.

Bevor Sie beginnen

Prüfen Sie Foundry- und Spielsystemversion in den Welteinstellungen. Das Modul benötigt mindestens Foundry 14; die D&D-Generatoren setzen genau Foundry V14 und D&D5e 5.3.3 voraus. Atlas unterstützt die auf der Modulseite genannten Systeme.

Melden Sie sich als Spielleitung an, um Generatoren, Atlas-Synchronisierung und Twitch-Tabellenbefehle zu nutzen. Spieler können ihre öffentlichen Würfe weiterleiten. Die anderen Funktionen benötigen kein Stream Deck.

Foundry-VTT-Modul

Das Modul installieren und aktivieren

Das JDR-Ninja-Modul ist auf Foundry VTT veröffentlicht. Öffnen Sie im Einrichtungsbildschirm von Foundry den Reiter für Module, klicken Sie auf die Installationsschaltfläche und suchen Sie nach « JDR Ninja ». Wenn das Modul in der Suche nicht erscheint, fügen Sie die Adresse seines Manifests im Installationsfenster ein:

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

Das Modul benötigt Foundry VTT ab Version 14 und kein weiteres Modul. Öffnen Sie danach Ihre Welt und aktivieren Sie JDR Ninja in der Modulverwaltung.

In den Foundry-Einstellungen bietet der Bereich JDR Ninja die Schaltfläche « Verbindungen einrichten ». Sie öffnet das Fenster « JDR Ninja Verbindungen »: oben Ihr JDR-Ninja-Konto, darunter je eine Karte pro Funktion, Stream Deck und VTT Overlay, dazu D&D-Generatoren und Atlas-Synchronisierung für die Spielleitung.

Ihr JDR-Ninja-Konto verbinden

  1. Klicken Sie im Fenster « JDR Ninja Verbindungen » auf « Mein Konto verbinden » und dann auf « JDR Ninja öffnen », und melden Sie sich bei Bedarf auf der Website an. Sind die D&D-Generatoren in diesem Browser bereits aktiviert, wird ihr Zugriff in derselben Autorisierung angefragt.
  2. Prüfen Sie Code und Gerätename. Wenn Sie die D&D-Generatoren nutzen möchten, erlauben Sie diese Funktion ausdrücklich, bevor Sie die Verbindung freigeben.
  3. Kehren Sie zu Foundry zurück und warten Sie auf die Kontobestätigung. Der Zugriff wird je Funktion geprüft. Bei einer abgelaufenen oder abgelehnten Anfrage starten Sie eine neue Verbindung.

Sie können auch auf der Foundry-Geräteseite einen manuellen Token erzeugen, ihn unter « Erweiterte Optionen » eingeben und auf « Prüfen und speichern » klicken. Er wird nur einmal angezeigt. Zeigt die Karte « D&D-Generatoren » « Autorisierung erforderlich », klicken Sie auf « Auf JDR Ninja autorisieren », um den Zugriff hinzuzufügen.

Meine Foundry-Geräte verwalten
Verbindungsfenster des JDR-Ninja-Moduls in Foundry VTT
Vorschau des lokalen Moduls: Kontoverbindung und Einstellungen für overlay und Stream Deck in Foundry.

Die gewünschten Funktionen aktivieren

Die Kontoverbindung aktiviert keine Funktion. Im Fenster « JDR Ninja Verbindungen » hat jede Karte ihren eigenen Schalter « Aktivieren », zunächst ausgeschaltet. Die Schalter von Stream Deck, overlay und Generatoren gelten nur für diesen Browser; der Schalter der Atlas-Synchronisierung gilt für alle Spielleitungen der Welt.

  • D&D-Generatoren (Spielleitung): Die Karte zeigt zuerst, ob Ihre Welt kompatibel ist, und dann den Zugriff, den Ihr Abonnement gibt. Sind die Generatoren aktiviert und verfügbar, öffnen Sie « D&D-Monster » oder « D&D-NSC » im Actor-Verzeichnis oder in den JDR-Ninja-Einstellungen.
  • overlay: Richten Sie die OBS-Quelle in der overlay-Konfiguration der Website ein und aktivieren Sie dann die Karte « VTT Overlay ». Ihre Schaltfläche « VTT Overlay konfigurieren » öffnet ein Fenster, das das overlay beim Öffnen prüft und « Testwurf senden » anbietet; dieser Test erfordert dasselbe Abonnement wie Würfe.
  • Stream Deck: Installieren Sie zuerst das Plugin und starten Sie die lokale Verbindung. In Foundry öffnet die Schaltfläche « Stream Deck konfigurieren » auf seiner Karte das Fenster, in dem Sie Adresse und Kopplungsschlüssel eintragen; « Speichern und aktivieren » schließt die Einrichtung ab. Die eigene Anleitung erklärt den Schlüssel und die Wahl der Sitzung.

Ihre Atlas-Welt verbinden

  1. Öffnen Sie auf der Website Ihre Foundry-Verbindungen und erstellen Sie eine Synchronisierungsverbindung für die betreffende Atlas-Welt. Kopieren Sie den nur einmal angezeigten Token. Sie können die Verbindung auch in den Einstellungen dieser Welt erstellen.
  2. Geben Sie diesen Token in Foundry auf der Karte « Atlas-Synchronisierung » des Fensters « JDR Ninja Verbindungen » ein und klicken Sie auf « Prüfen und speichern ». Prüfen Sie Weltname und Synchronisierungszugriff. Dieser Token ist unabhängig von der Kontoverbindung und dem Stream-Deck-Schlüssel.
  3. Aktivieren Sie die Karte « Atlas-Synchronisierung » für diese Foundry-Welt, öffnen Sie ihr Fenster mit der Schaltfläche « Atlas » im Actor-Verzeichnis und wählen Sie die Kampagne. Verknüpfen Sie einen Actor mit einem bestehenden Charakter oder erstellen Sie ihn in Atlas. Starten Sie dann die Synchronisierung und prüfen Sie den Bogen in Atlas.
Meine Atlas-Verbindungen verwalten

Werte und Listen vorbereiten

Das Modul kann Werte speichern, die Sie wiederverwenden: einen Zähler, einen Bonus, einen gewählten Akteur oder eine gewählte Seite. Öffnen Sie « Variablen und Listen (erweitert) » in den Moduleinstellungen oder « Variablen und Listen » im Fenster « Stream Deck » des Moduls. Der Tab « Variablen » enthält die Werte; der Tab « Wertelisten » enthält Dokumente in einer Reihenfolge Ihrer Wahl, zum Beispiel Ihre NSC oder Ihre Hinweise. Für diese Einstellungen brauchen Sie weder Stream Deck noch ein Abonnement.

Wählen Sie « Persönlich » für Ihre eigenen Werte: Jeder Benutzer ändert seine eigenen. Ein Wert im Bereich « Welt » wird von allen Benutzern der Welt geteilt, aber nur die im Feld « SL für Weltvariablen » angegebene Spielleitung kann ihn ändern.

Eine Variable hat die Felder « Standardwert » und « Aktueller Wert ». Die Variablenliste zeigt den aktuellen Wert jeder Variablen, und mit « Aktuellen Wert ändern » können Sie ihn von Hand ändern oder den Standardwert wiederherstellen. Eine « Listenauswahl » beginnt ohne aktuellen Wert: Wenden Sie nach dem Speichern « Standardwert wiederherstellen » an. Ein « Berechneter Wert » wird aus anderen Variablen abgeleitet und lässt sich nicht direkt ändern.

Schreiben Sie im Feld « Berechnungsausdruck » eine Variable in der Form @{Name}. Hängen Sie an eine Dokumentvariable den Pfad eines Werts an, wie bei einem aktiven Effekt: Verweist « Held im Rampenlicht » auf einen Charakter, gibt @{Held im Rampenlicht}.system.attributes.inspiration an, ob er Inspiration hat. Der Pfad hängt vom Spielsystem ab, und der Wert wird nur gelesen, wenn Sie das Dokument sehen dürfen.

Um Werte an ein Skriptmakro zu übergeben, deklarieren Sie seine Argumente unter « Kompatible Makros (erweitert) ». Dieses Fenster ändert das Skript nicht: Das Makro muss diese Argumente lesen und das Ende seiner Ausführung bestätigen.

Stream-Deck-Beispiele ansehen

Den ersten Einsatz prüfen

Machen Sie nach der Aktivierung einer Funktion vor dem Spiel einen ersten vollständigen Test.

Eine erste Kreatur erstellen

Öffnen Sie Monster über die JDR-Ninja-Einstellungen oder das Actor-Verzeichnis, wählen Sie ein einfaches Profil und starten Sie eine Generierung. Prüfen Sie die Vorschau, erstellen Sie den Actor und öffnen Sie dann seinen Bogen in Foundry, um das Ergebnis zu prüfen. Jede neue Generierung zählt zu den Limits Ihres Kontos.

Einen Charakter in Atlas aktualisieren

Ändern Sie in Foundry einen verknüpften Charakter und senden Sie dann seinen Bogen über das Atlas-Fenster. Öffnen Sie seinen Bogen in Atlas, um die Änderung zu prüfen, bevor Sie die ganze Liste senden. Änderungen in Atlas werden nicht zurück zu Foundry übertragen.

Einen öffentlichen Wurf in OBS sehen

Führen Sie in Foundry einen öffentlichen Wurf mit Würfeln aus und vergleichen Sie das Ergebnis im Chat und in der OBS-Quelle. Private, verdeckte und geflüsterte Würfe werden nie weitergegeben.

Eine Stream-Deck-Taste testen

Beginnen Sie mit einer Taste, die einen Bogen öffnet, und bereiten Sie dann die Tasten einer Szene vor: Aktivierung, Klangkulisse und Dunkelheit, jeder Befehl auf einer eigenen Taste. Die Stream-Deck-Anleitung bietet anschließend Beispiele für das Spiel.

Die Tasten einer Szene vorbereiten

Wenn Sie die alten Module nutzen

Deaktivieren Sie Atlas Character Sync oder das alte VTT-Overlay-Modul: Solange es aktiv ist, bleibt die entsprechende Integration des JDR-Ninja-Moduls nicht verfügbar. Öffnet eine Spielleitung die Welt, übernimmt das Modul Token, Adresse und Kampagne von Atlas Character Sync; aktivieren Sie danach die Atlas-Synchronisierung im Fenster « JDR Ninja Verbindungen ». Vom alten overlay-Modul wird nichts übernommen: Verbinden Sie Ihr Konto erneut.

Eine erfolgreiche Atlas-Synchronisierung kann bestehende Actor-Verknüpfungen übernehmen. Lokales Trennen entfernt den im Modul gespeicherten Token, widerruft ihn aber nicht auf der Website. Widerrufen Sie Geräte oder Verbindungen auf den Verwaltungsseiten.

Bei Problemen

Die Verbindung ist abgelaufen oder wurde abgelehnt

Starten Sie die Verbindung in Foundry erneut und verwenden Sie den neuen Code. Prüfen Sie Gerät und Konto. Eine abgebrochene oder abgelaufene Anfrage lässt sich nicht erneut verwenden.

Mein Konto ist verbunden, aber eine Funktion bleibt gesperrt

Prüfen Sie die Meldung der Funktion: Gerätefreigabe, Abonnement, SL-Rechte, Kompatibilität und Aktivierung sind getrennte Voraussetzungen. Ein Atlas-Token gewährt keinen D&D-Generatorzugriff. Bei einem widerrufenen Token verbinden Sie das Gerät erneut.

Die Generatoren lehnen meine Foundry- oder D&D5e-Version ab

Aktuell erforderlich sind Foundry V14 und D&D5e 5.3.3. Die Mindestversion des Moduls und die von Atlas akzeptierten Systeme ändern diese Voraussetzung nicht. Prüfen Sie die Kompatibilitätsanzeige im Generatorfenster.

Die Atlas-Synchronisierung startet nicht

Prüfen Sie SL-Rolle, Atlas-Schalter der Welt, Spielsystem, Token der richtigen Welt und Synchronisierungszugriff. Deaktivieren Sie das alte Atlas-Character-Sync-Modul, falls es noch aktiv ist. Das overlay-Konto ersetzt keine Atlas-Verbindung.

Die Würfel erscheinen nicht in OBS

Prüfen Sie den Schalter der Karte « VTT Overlay » in diesem Browser, das aktive Website-overlay, die OBS-Browserquelle und das Abonnement. Würfeln Sie öffentlich mit Würfeln. Private Würfe werden nie übertragen. Prüfen Sie den Bereich « Diagnose » im Fenster « VTT Overlay » und deaktivieren Sie ein aktives altes overlay-Modul.

Stream Deck findet die Foundry-Sitzung nicht

Prüfen Sie, ob die lokale Verbindung auf demselben Computer wie Foundry-Browser und Stream-Deck-App gestartet ist und in Foundry aktiviert wurde. Hat sich Foundry neu verbunden, wählen Sie die Sitzung auf den betroffenen Tasten erneut aus. Die Stream-Deck-Anleitung erklärt den Kopplungsschlüssel und die erlaubten Adressen.