Zum Hauptinhalt springen

Das JDR-Ninja-Modul für Foundry

Foundry VTT mit Stream Deck steuern

Führen Sie Makros aus, wechseln Sie Szenen und steuern Sie Musik über Stream Deck. Das JDR-Ninja-Plugin sendet Befehle über einen lokalen Companion an Foundry VTT.

Auf einen Blick

Drei Komponenten verbinden Ihre Tasten mit dem gewählten Foundry-Browser: Stream-Deck-Plugin, lokaler Companion und JDR-Ninja-Modul. Foundry führt Befehle aus und prüft die Rechte des angemeldeten Benutzers. Der Browser muss auf demselben Computer wie der Companion geöffnet bleiben.

Befehle schnell erreichbar

Belegen Sie eine Taste mit einem Makro, einer Szene oder einem Klang aus Ihrer Welt.

Die passende Sitzung wählen

Jede Taste behält die ausdrücklich gewählte Welt, den Benutzer und den Browser.

Ausführung nachvollziehen

Das Plugin unterscheidet abgeschlossene und abgelehnte Befehle sowie unbestätigte Ergebnisse.

So sieht es aus

Die Bilder zeigen Moduleinstellungen in einem echten Foundry-Browser und den Entwicklungsinspektor des Plugins. Sie erläutern die lokale Einrichtung und bestätigen keine Hardwareprüfung. Der temporäre Port in den Bildern unterscheidet sich vom Standardport 19114 der Anleitung.

Verbindung in Foundry aktivieren

Speichern Sie in den Moduleinstellungen Companion-Adresse und lokalen Schlüssel. Aktivieren Sie danach Stream Deck ausdrücklich in diesem Foundry-Browser.

Stream-Deck-Einstellungen des JDR-Ninja-Moduls in Foundry: aktive lokale Verbindung, französische Oberfläche.

Eine Taste einrichten

Befehl und Eingabefelder richten sich nach der gewählten Sitzung und den Rechten des Foundry-Benutzers.

JDR-Ninja-Entwicklungsinspektor: Foundry-Befehl und Konfigurationsfelder, französische Oberfläche.

So sind die Komponenten verbunden

  1. Stream-Deck-Plugin
  2. Lokaler Companion
  3. JDR-Ninja-Modul im Foundry-Browser

Der Companion vermittelt Befehle zwischen den beiden Clients auf Ihrem Computer. Der Foundry-Server darf anderswo gehostet sein. Der lokale Kopplungsschlüssel benötigt kein JDR-Ninja-Kontotoken und verleiht keine zusätzlichen Foundry-Rechte.

Befehle der aktuellen Version

Makros, Szenen und Pause

Führen Sie erlaubte Makros aus, betrachten oder aktivieren Sie Szenen, ändern Sie die Dunkelheit und pausieren Sie das Spiel.

Musik und Dokumente

Spielen oder stoppen Sie Klänge, wechseln Sie Titel und ändern Sie die Lautstärke. Öffnen Sie Akteurbögen oder Journalseiten, teilen Sie Seiten mit gewählten Empfängern und würfeln Sie auf Tabellen.

Token und Kampf

Wählen, markieren oder verbergen Sie Token, ändern Sie native Ressourcenleisten und wechseln Sie Kampfzüge entsprechend Ihren Rechten. Die Leisten bilden keine systemspezifischen Schadens- oder Heilungsregeln ab.

Voraussetzungen

Sie benötigen Foundry V14 oder neuer mit aktiviertem JDR-Ninja-Modul, die Stream-Deck-Anwendung mit JDR-Ninja-Plugin und Node.js 24 für den Companion. Browser und Companion müssen auf dem Stream-Deck-Computer laufen. Jede Taste benötigt eine ausdrücklich gewählte Sitzung.

Foundry-Modul installieren

Variablen, Listen und Makroargumente

Normale Befehle verwenden feste Werte. Erweiterte Optionen ermöglichen kompatible Variablen, Listen und Argumente für Makros, die diese in Foundry deklarieren. Werte und Rechte werden bei jedem Tastendruck geprüft.

Erweiterte Optionen lesen

Berechtigungen und Zugang

Befehle beachten die Foundry-Rechte der gewählten Sitzung. Der Overlay-Test ist als Premium gekennzeichnet und benötigt Kontoverbindung, aktiviertes Overlay und serverseitige Zugangsprüfung. Andere Modulfunktionen haben eigene Bedingungen. Für lokale Befehle ist keine allgemeine Abonnementstufe angekündigt.

Häufige Fragen

Wozu dient der Companion?

Er vermittelt Befehle zwischen dem Stream-Deck-Plugin und autorisierten Foundry-Browsern auf Ihrem Computer. Foundry führt Aktionen aus und prüft Rechte.

Darf der Foundry-Server entfernt gehostet sein?

Ja. Der Browser für das Spiel muss dennoch auf demselben Computer wie Companion und Stream Deck laufen.

Funktionieren Tasten nach dem Schließen von Foundry?

Befehle benötigen einen offenen, verbundenen und bereiten Foundry-Browser. Wird er geschlossen, endet seine Sitzung.

Was passiert nach einer erneuten Foundry-Verbindung?

Wählen Sie die Sitzung auf Ihren Tasten erneut. Jede neue Foundry-Verbindung erhält eine neue Identität. Verbindet sich nur das Plugin neu, kann es eine weiterhin verbundene Foundry-Sitzung wiederfinden.

Können Spieler diese Befehle nutzen?

Verfügbare Aktionen hängen von den Rechten des angemeldeten Foundry-Benutzers ab. Eine Taste verleiht keine zusätzlichen Rechte und wechselt den Benutzer nie automatisch.

Ist ein JDR-Ninja-Abonnement erforderlich?

Der Overlay-Test benötigt in Foundry bestätigten Premium-Zugang. Für lokale Befehle ist kein allgemeines Abonnement angekündigt. Generatoren und andere Modulfunktionen haben eigene Zugangsbedingungen.

Welche Geräte und Plattformen sind geprüft?

Entwicklungstests nutzen einen echten Foundry-Browser und einen simulierten Elgato-Host. Stream-Deck-Hardware, Windows/macOS-Installation und wss mit vertrauenswürdigem Zertifikat müssen noch geprüft werden. Allgemeine Hardwarekompatibilität ist nicht bestätigt.

Die erste Taste vorbereiten

Folgen Sie der Anleitung, um die drei Komponenten zu verbinden und einen einfachen Befehl zu testen.

Das JDR-Ninja-Modul für Foundry