Zum Hauptinhalt springen

Stream Deck für Foundry VTT

Stream Deck mit Foundry VTT einrichten

Verbinden Sie das Stream-Deck-Plugin mit dem JDR-Ninja-Modul, testen Sie eine erste Taste und bereiten Sie dann nützliche Tasten für das Spiel vor: Szenen wechseln, Hinweise aufdecken, die Spannung verfolgen.

Was Sie vorbereiten können

Die folgenden Beispiele beschreiben konkrete Einsätze im Spiel. Wenn Ihre Installation schon funktioniert, springen Sie direkt zu dem Beispiel, das Sie interessiert.

Voraussetzungen

Bereiten Sie Foundry V14 oder neuer, das aktivierte JDR-Ninja-Modul, die Stream-Deck-Anwendung, deren JDR-Ninja-Plugin und Node.js 24 vor. Der Foundry-Server darf entfernt sein, öffnen Sie Foundry aber in einem Browser auf dem Computer, auf dem Stream Deck läuft.

Foundry-Modul installieren

Plugin installieren

Die öffentliche Verteilung wird vorbereitet. Falls Sie einen Entwicklungsbuild besitzen, installieren Sie dessen .streamDeckPlugin-Datei in der Stream-Deck-Anwendung. Um die lokale Verbindung einzurichten, öffnen Sie ein Terminal im Quellordner stream-deck und installieren Sie die Abhängigkeiten mit dem folgenden Befehl.

npm ci

Falls Sie ein .tgz-Archiv erhalten haben, entpacken Sie es, öffnen Sie ein Terminal in dessen Ordner und verwenden Sie stattdessen diesen Befehl. Node.js 24 muss separat installiert werden.

npm install --omit=dev --ignore-scripts

Die lokale Verbindung bleibt aktiv, solange dieses Terminal geöffnet ist, und startet nicht von selbst. Lassen Sie das Fenster während des Spiels geöffnet.

Lokale Verbindung vorbereiten

Starten Sie die Initialisierung mit dem ersten Befehl. Geben Sie die genaue Adresse von Foundry so an, wie sie im Browser angezeigt wird, etwa http://localhost:30000 oder https://foundry.example.net, ohne Pfad und ohne abschließenden Schrägstrich. Kopieren Sie den erzeugten Kopplungsschlüssel: Sie tragen ihn in Foundry und im Plugin ein. Starten Sie dann die lokale Verbindung mit dem zweiten Befehl.

npm run companion:init
npm run companion

Die Konfiguration wird in Ihrem Benutzerprofil an einem der folgenden Pfade gespeichert. Die Initialisierung überschreibt keine vorhandene Datei. Um die Foundry-Adresse, den Port oder den Schlüssel zu ändern, beenden Sie die lokale Verbindung mit Ctrl+C, bearbeiten Sie die Konfigurationsdatei und starten Sie die Verbindung neu. Ändert sich der Schlüssel, tragen Sie den neuen Schlüssel in Foundry und im Plugin ein.

  • Windows : %LOCALAPPDATA%\JDR Ninja\companion.json
  • macOS / Linux : ~/.config/jdr-ninja/companion.json

Foundry verbinden

Öffnen Sie in Foundry das Fenster « JDR Ninja Verbindungen » und klicken Sie auf der Stream-Deck-Karte auf « Stream Deck konfigurieren ». Tragen Sie die folgende Adresse und den Kopplungsschlüssel ein und klicken Sie dann auf « Speichern und aktivieren »: Diese Schaltfläche speichert die Verbindung und aktiviert Stream Deck in diesem Browser. Die Karte zeigt « Bereit », sobald die lokale Verbindung hergestellt ist.

ws://127.0.0.1:19114/jdr-ninja

Stream-Deck-Plugin verbinden

Fügen Sie einer Taste die Aktion « Foundry steuern » hinzu. Tragen Sie im Inspektor die folgende Adresse unter « Verbindungsadresse » ein, fügen Sie denselben « Kopplungsschlüssel » ein und wählen Sie « Verbinden ». Diese Verbindungseinstellungen gelten für alle Tasten. Das Schlüsselfeld wird nach dem Speichern geleert.

ws://127.0.0.1:19114/stream-deck

Dieser Schlüssel dient nur der lokalen Verbindung zwischen Stream Deck und Foundry. Er unterscheidet sich vom Atlas-Verbindungstoken und den Zugangsdaten Ihres JDR-Ninja-Kontos. Tragen Sie keine dieser anderen Zugangsdaten in das Feld « Kopplungsschlüssel » ein.

Foundry-Sitzung wählen

Wählen Sie unter « Foundry-Welt und Browser » die gewünschte Welt, den Benutzer und Browser. Warten Sie auf « Bereit » und die erlaubten Befehle und Dokumente. Jede Taste speichert ihre eigene Sitzung, ihren Befehl und ihre Parameter und wechselt das Ziel nie automatisch.

Ersten Befehl erstellen und testen

Wählen Sie unter « Befehl » die Option « Akteur öffnen » und einen zugänglichen Akteur. Drücken Sie die Taste einmal. Prüfen Sie den geöffneten Bogen in Foundry und « Abgeschlossen. » im Inspektor. Ein angenommener Befehl kann noch auf seine Ausführung warten.

Bei einem unbestätigten Ergebnis kann die Taste kurz « ? » anzeigen. Prüfen Sie in Foundry, was passiert ist, bevor Sie erneut drücken. Der nächste Abschnitt zeigt, wie Sie nützliche Tasten für das Spiel vorbereiten.

Tasten während des Spiels wiederverwenden

Diese Beispiele beginnen mit festen Tasten und führen dann nacheinander je ein neues Konzept ein: eine Liste zur Auswahl unter mehreren Dokumenten, eine Variable zum Speichern eines Werts, einen kombinierten Befehl, der einen Wert ändert, bevor in Foundry gehandelt wird, Argumente für Ihre Makros und die direkte Änderung eines Felds im Charakterbogen. Die letzten beiden Beispiele verbinden diese Änderung mit Variablen: Journalseiten endgültig aufdecken und den Spielern die Spannung anzeigen. Nur das Makro-Beispiel erfordert ein Skript. Variablen und Listen legen Sie in Foundry an; die Befehle, die sie verwenden, erscheinen in der Liste « Befehl » mit vorangestelltem « Erweitert · », ebenso « Dokument aktualisieren ».

Die Befehle für Ihre nächste Szene vorbereiten

Ihre Spieler verlassen das Gasthaus und gehen in die Krypta. Bereiten Sie drei Tasten für diesen Ortswechsel vor: Die erste aktiviert die Szene, die zweite startet ihre Klangkulisse und die dritte dunkelt die Beleuchtung ab.

Bevor Sie beginnen

Melden Sie sich als Spielleitung an: Diese drei Befehle sind ihr vorbehalten. Die Welt enthält bereits die Szene und eine Playlist mit dem gewünschten Klang.

In Foundry

Es ist keine Moduleinstellung nötig: Diese Befehle verwenden feste Werte, die direkt im Inspektor gewählt werden.

Auf Stream Deck

Die Befehle für Ihre nächste Szene vorbereiten
Taste Befehl Einstellungen
Zur Krypta Szene aktivieren « Dokument »: die Szene der Krypta.
Klangkulisse der Krypta Ton abspielen oder stoppen « Dokument »: der Klang. « Ton abspielen »: Ja (vorgeschlagen ist Nein, was den Klang stoppt).
Abdunkeln Dunkelheit einstellen « Dokument »: die Szene der Krypta. « Wert »: eine Zahl von 0 (volles Tageslicht) bis 1 (völlige Dunkelheit), zum Beispiel 0,7.

Ausprobieren und zurücksetzen

Drücken Sie die drei Tasten der Reihe nach: Die Szene der Krypta erscheint bei den Spielern, der Klang startet und die Beleuchtung wird dunkler. Die Dunkelheitstaste zeigt in Prozent die Dunkelheit der Szene an, die in Ihrem Browser geöffnet ist. Um zum Ausgangszustand zurückzukehren, fügen Sie eine Taste « Ton abspielen oder stoppen » mit « Ton abspielen » auf Nein hinzu und eine Dunkelheitstaste auf 0.

Gut zu wissen

« Szene aktivieren » zeigt die Szene allen Spielern. « Szene ansehen » ändert nur Ihre eigene Ansicht: So können Sie das Nächste vorbereiten, ohne dass die Spieler es sehen. Die drei Aktionen bleiben getrennt: Um sie mit derselben Taste hintereinander auszulösen, benötigen Sie ein Makro, das sie enthält.

Mit denselben Tasten durch Ihre NSC blättern

Im Gasthaus befragen Ihre Spieler mehrere NSC. Zwei Tasten wechseln von einem NSC zum nächsten, eine dritte öffnet den Bogen des gewählten NSC. Die Öffnen-Taste gilt für die ganze Liste: Das Hinzufügen oder Umordnen von NSC erfordert keine Änderung an Stream Deck.

Bevor Sie beginnen

Jeder Benutzer kann dieses Beispiel mit seinen persönlichen Variablen nachvollziehen. Die Welt enthält bereits drei Akteure, deren Bogen Sie öffnen können.

In Foundry

  1. Öffnen Sie in den Moduleinstellungen « Variablen und Listen (erweitert) » und wählen Sie « Persönlich ». Legen Sie auf dem Tab « Wertelisten » die Liste « NSC im Gasthaus » vom Typ « Akteur » an. Klicken Sie für jeden NSC auf « Eintrag hinzufügen », geben Sie eine « Bezeichnung » ein und wählen Sie den Akteur aus den Vorschlägen des Felds « Dokument-UUID (bestimmtes Dokument) ». Speichern Sie.
  2. Legen Sie auf dem Tab « Variablen » die Variable « Gewählter NSC » an: « Werttyp » auf « Akteur », « Definition » auf « Listenauswahl », « Verknüpfte Liste » auf « NSC im Gasthaus » und den ersten NSC als « Standardwert ». Aktivieren Sie « Nach dem letzten Eintrag zum Anfang springen », wenn die Liste nach dem letzten NSC von vorn beginnen soll. Speichern Sie.
  3. Eine neue Listenauswahl hat noch keinen aktuellen Wert. Wählen Sie unter « Aktuellen Wert ändern » die Option « Standardwert wiederherstellen » und dann « Anwenden ».

Auf Stream Deck

Mit denselben Tasten durch Ihre NSC blättern
Taste Befehl Einstellungen
Vorheriger NSC Vorheriger Listeneintrag « Variable (erweitert) »: Gewählter NSC.
Nächster NSC Nächster Listeneintrag « Variable (erweitert) »: Gewählter NSC.
NSC öffnen Akteur öffnen « Akteur »: « Wertquelle » auf « Variable (erweitert) », dann die Variable Gewählter NSC.

Ausprobieren und zurücksetzen

Drücken Sie « NSC öffnen »: Der Bogen des ersten NSC öffnet sich. Drücken Sie « Nächster NSC » und danach erneut « NSC öffnen »: Jetzt öffnet sich der Bogen des zweiten. Der gewählte NSC erscheint im Fenster « Variablen und Listen (erweitert) » und im Inspektor unter « Aktuelle Vorschau ». Um zum ersten NSC zurückzukehren, fügen Sie eine Taste « Variable zurücksetzen » für dieselbe Variable hinzu.

Gut zu wissen

Die Tasten zeigen weder das Porträt noch den Namen des gewählten NSC: Prüfen Sie die Auswahl in Foundry oder im Inspektor. Ohne Rückkehr zum Anfang ändert « Nächster Listeneintrag » beim letzten NSC nichts.

Hinweise der Reihe nach aufdecken

Ihre Spieler ermitteln in der Krypta, und Sie möchten ihnen drei Hinweise in der vorgesehenen Reihenfolge zeigen. Nach dem ersten Hinweis genügt eine Taste, um zum nächsten Hinweis zu wechseln und ihn Ihren Spielern zu zeigen, ganz ohne Makro.

Bevor Sie beginnen

Melden Sie sich als Spielleitung an: Das Zeigen einer Seite ist der Spielleitung vorbehalten, die die Seite auch besitzen muss. Bereiten Sie drei Journalseiten vor, eine pro Hinweis, und geben Sie den Spielern auf jeder mindestens die Berechtigung Beobachter. Die Spieler müssen angemeldet sein, um die Seite zu erhalten.

In Foundry

  1. Wählen Sie in « Variablen und Listen (erweitert) » die Option « Persönlich »: Das genügt für Ihre eigenen Tasten. Legen Sie die Liste « Hinweise aus der Krypta » vom Typ « Journalseite » an und fügen Sie die drei Seiten in der Reihenfolge hinzu, in der Sie sie zeigen möchten.
  2. Legen Sie die Variable « Aktueller Hinweis » an: « Werttyp » auf « Journalseite », « Definition » auf « Listenauswahl », diese Liste als « Verknüpfte Liste » und die erste Seite als « Standardwert ». Lassen Sie « Nach dem letzten Eintrag zum Anfang springen » deaktiviert.
  3. Speichern Sie und wenden Sie dann unter « Aktuellen Wert ändern » die Option « Standardwert wiederherstellen » an.

Auf Stream Deck

Hinweise der Reihe nach aufdecken
Taste Befehl Einstellungen
Vorheriger Hinweis Vorheriger Listeneintrag « Variable (erweitert) »: Aktueller Hinweis.
Nächster Hinweis Nächster Listeneintrag « Variable (erweitert) »: Aktueller Hinweis.
Hinweis zeigen Journalseite teilen « Dokument »: « Wertquelle » auf « Variable (erweitert) », dann die Variable Aktueller Hinweis. « Zielgruppe »: Spieler.
Nächsten Hinweis zeigen Variablen ändern und Befehl ausführen « Variablenänderung hinzufügen »: « Operation » auf « Nächster Listeneintrag » (vorgeschlagen ist « Variable umschalten »), « Variable (erweitert) » auf Aktueller Hinweis. « Foundry-Befehl »: « Journalseite teilen » mit denselben Einstellungen wie « Hinweis zeigen ».

Ausprobieren und zurücksetzen

Probieren Sie zuerst die ersten drei Tasten einzeln aus, um Auswahl und Zielgruppe zu prüfen. Zeigen Sie im Spiel den ersten Hinweis mit « Hinweis zeigen » und verwenden Sie dann « Nächsten Hinweis zeigen »: Bei jedem Druck wird die nächste Seite gewählt und den angemeldeten Spielern gezeigt. Würden Sie mit der kombinierten Taste beginnen, würde der erste Hinweis übersprungen. Um die Ermittlung erneut zu spielen, wenden Sie « Standardwert wiederherstellen » an: Der aktuelle Hinweis ist dann wieder der erste, aber bereits gezeigte Seiten werden den Spielern nicht entzogen und ihre Berechtigungen ändern sich nicht.

Gut zu wissen

Nach dem letzten Hinweis wechselt die kombinierte Taste die Seite nicht mehr und zeigt erneut die letzte. Fehlt einem Spieler die Berechtigung Beobachter, wird der Befehl abgelehnt und der aktuelle Hinweis ändert sich nicht. Die Option « Ohne Änderung der Berechtigungen anzeigen » zeigt die Seite einmal, ohne diese Berechtigungen zu ändern.

Den Spannungsgrad ansagen

In einem Horrorspiel lassen Sie die Spannung steigen, wenn sich die Lage verschlechtert. Eine Taste addiert 1 zum Zähler und sagt den neuen Stand im Chat an, zum Beispiel « Spannung: 3 / 6 ». Sie entscheiden, wann Sie drücken: Kein Ereignis im Spiel lässt den Zähler von selbst steigen.

Bevor Sie beginnen

Jeder Benutzer kann diese persönliche Variable anlegen und in den Chat schreiben. Es ist kein Dokument nötig.

In Foundry

Legen Sie in « Variablen und Listen (erweitert) » unter « Persönlich » die Variable « Spannung » an: « Werttyp » auf « Zahl », « Definition » auf « Gespeicherter Wert », « Minimum » 0, « Maximum » 6, « Standardwert » und « Aktueller Wert » 0. Aktivieren Sie « Erhöhen und Verringern auf Grenzen beschränken ». Speichern Sie.

Auf Stream Deck

Den Spannungsgrad ansagen
Taste Befehl Einstellungen
Spannung erhöhen Variable erhöhen « Variable (erweitert) »: Spannung. « Änderung »: 1 (vorgeschlagen ist 0, was nichts ändert).
Spannung senken Variable verringern « Variable (erweitert) »: Spannung. « Änderung »: 1.
Auf null zurücksetzen Variable zurücksetzen « Variable (erweitert) »: Spannung.
Erhöhen und ansagen Variablen ändern und Befehl ausführen Eine Änderung « Variable erhöhen » auf Spannung, « Änderung » 1. « Foundry-Befehl »: « Chatnachricht senden ». « Chatnachricht »: « Wertquelle » auf « Text zusammensetzen (erweitert) », dann drei Abschnitte in dieser Reihenfolge: der Text « Spannung: » mit einem Leerzeichen am Ende, die Variable Spannung und der Text « / 6 » mit einem Leerzeichen am Anfang.

Ausprobieren und zurücksetzen

Prüfen Sie zuerst die ersten drei Tasten: Der Wert von Spannung ändert sich im Fenster « Variablen und Listen (erweitert) ». Drücken Sie dann bei einem Zähler auf 2 « Erhöhen und ansagen »: Der Zähler springt auf 3 und der Chat zeigt « Spannung: 3 / 6 ». Die Nachricht ist öffentlich und wird unter Ihrem Namen gesendet. « Auf null zurücksetzen » setzt den Zähler auf 0 zurück, ohne bereits gesendete Nachrichten zu entfernen.

Gut zu wissen

Am Maximum bleibt der Zähler bei 6, die Nachricht wird trotzdem gesendet. Scheitert das Senden der Nachricht, kann der neue Wert trotzdem gespeichert bleiben, und die Taste zeigt « ! »: Prüfen Sie Zähler und Chat in Foundry, bevor Sie erneut drücken.

Mit variablem Bonus würfeln

Ein Verbündeter unterstützt den Charakter oder eine erhöhte Position erleichtert seinen Schuss: Der Bonus ändert sich von Szene zu Szene. Speichern Sie diesen Bonus in einer Variablen: Eine einzige Taste würfelt dann 1d20 plus den aktuellen Bonus. Jeder Druck verwendet den jeweils aktuellen Wert.

Bevor Sie beginnen

Jeder Benutzer kann würfeln und seine persönlichen Variablen anlegen. Es ist kein Dokument nötig.

In Foundry

Legen Sie unter « Persönlich » die Variable « Situationsbonus » an: « Werttyp » auf « Zahl », « Definition » auf « Gespeicherter Wert », « Minimum » 0, « Maximum » 5, « Standardwert » und « Aktueller Wert » 0. Aktivieren Sie « Erhöhen und Verringern auf Grenzen beschränken ». Speichern Sie.

Auf Stream Deck

Mit variablem Bonus würfeln
Taste Befehl Einstellungen
Bonus erhöhen Variable erhöhen « Variable (erweitert) »: Situationsbonus. « Änderung »: 1.
Bonus verringern Variable verringern « Variable (erweitert) »: Situationsbonus. « Änderung »: 1.
Bonus auf null Variable zurücksetzen « Variable (erweitert) »: Situationsbonus.
Wurf mit Bonus Würfeln « Würfelausdruck »: « Wertquelle » auf « Text zusammensetzen (erweitert) », dann der Text « 1d20 + » und die Variable Situationsbonus. « Sichtbarkeit »: « Nur ich » zum Üben.

Ausprobieren und zurücksetzen

Wählen Sie den Befehl « Würfeln » in der Aktion « Foundry steuern »: Die gleichnamige Stream-Deck-Aktion ist eine andere Aktion und gehört zum overlay. Drücken Sie « Wurf mit Bonus »: Das Ergebnis erscheint im Foundry-Chat, nur für Sie sichtbar. Erhöhen Sie den Bonus zweimal und drücken Sie erneut: Der Wurf verwendet 1d20 + 2. Wenn der Tisch den Wurf sehen soll, wählen Sie « Alle ». « Bonus auf null » setzt den Bonus auf 0 zurück.

Gut zu wissen

Das ist ein allgemeiner Würfelwurf: Er ersetzt nicht die Angriffs- oder Schadenswürfe Ihres Spielsystems, und die Variable folgt keiner Eigenschaft eines Akteurs. Der Ausdruck akzeptiert Würfel, Zahlen und einfache Rechenoperationen, aber keine Modifikatoren wie « kh »: Ein Wurf « 2d20kh1 » wird abgelehnt.

Werte an ein Makro übergeben

Sie haben bereits ein Skriptmakro, das je nach Menge auf einen Akteur wirkt. Statt es für jeden Fall zu kopieren, deklarieren Sie seine Argumente: Jede Taste startet dasselbe Makro mit ihrem eigenen Akteur und ihrer eigenen Menge.

Bevor Sie beginnen

Dies ist das einzige Beispiel, das ein Skript erfordert. Das Makro muss ein Skriptmakro sein, das Ihnen gehört und das Sie ausführen dürfen. Das Modul liefert kein fertiges Makro mit und ändert Ihr Skript nicht.

In Foundry

  1. Öffnen Sie « Kompatible Makros (erweitert) », wählen Sie das Makro und dann « Makro konfigurieren ». Deklarieren Sie mit « Argument hinzufügen » zum Beispiel « ziel » vom Typ « Akteur » und « menge » vom Typ « Zahl ». Ein Argumentname beginnt mit einem Buchstaben und enthält weder Akzente noch Umlaute noch Leerzeichen. Aktivieren Sie « Erforderlich », oder aktivieren Sie « Standardwert verwenden » und geben Sie den « Standardwert » an. Klicken Sie anschließend auf « Speichern ».
  2. Lesen Sie die Werte im Skript aus scope.jdrNinja.arguments. Ein Dokument wird dort als UUID übergeben; eine Zahl, ein Text oder ein Boolescher Wert wird dort unverändert übergeben.
  3. Beenden Sie das Skript mit der Bestätigungszeile, die im Fenster « Kompatible Makros (erweitert) » angezeigt wird. Ohne sie meldet die Taste ein unbestätigtes Ergebnis, selbst wenn das Makro funktioniert hat.

Auf Stream Deck

Werte an ein Makro übergeben
Taste Befehl Einstellungen
Erster Fall Makro ausführen « Dokument »: Ihr Makro. Aktivieren Sie « Makroargumente (Erweitert) », dann « ziel »: ein erster Akteur und « menge »: 2.
Zweiter Fall Makro ausführen Dasselbe Makro, mit « menge »: 5. Stellen Sie für « ziel » die « Wertquelle » auf « Variable (erweitert) » und wählen Sie die Variable Gewählter NSC: Das Makro wirkt dann auf den NSC, der im NSC-Beispiel ausgewählt ist.

Ausprobieren und zurücksetzen

Drücken Sie jede Taste und prüfen Sie in Foundry die Wirkung des Makros auf den betreffenden Akteur. Der Inspektor zeigt « Abgeschlossen. », sobald die Bestätigung eingegangen ist. Ob und wie sich der Ausgangszustand wiederherstellen lässt, hängt davon ab, was Ihr Makro tut: Das Modul macht nichts rückgängig.

Gut zu wissen

Das Deklarationsfenster erstellt kein Skript: Es beschreibt nur die erwarteten Werte. Ein Makro ohne deklarierte Argumente erhält keine, und der Inspektor fordert Sie dann auf, in Foundry ein Makro zu wählen, das kompatible Argumente deklariert.

Inspiration vergeben

Einer Ihrer Spieler hat gerade eine Glanzleistung vollbracht und verdient Inspiration. In einer Runde D&D5e schaltet eine einzige Taste die Inspiration auf dem Bogen seines Charakters ein; ein zweiter Druck schaltet sie wieder aus.

Bevor Sie beginnen

Die Spielleitung kann jedem Spieler Inspiration geben. Ein Spieler kann das nur für einen Charakter tun, dessen Eigentümer er ist: In allen anderen Fällen lehnt Foundry die Änderung ab. Die Welt verwendet das System D&D5e.

In Foundry

Weisen Sie dem Spieler seinen Charakter in der Benutzerkonfiguration von Foundry zu, falls das noch nicht geschehen ist: Die Taste wirkt auf diesen zugewiesenen Charakter. Eine weitere Moduleinstellung ist nicht nötig.

Auf Stream Deck

Inspiration vergeben
Taste Befehl Einstellungen
Inspiration Dokument aktualisieren « Dokument » auf « Zugewiesener Spielercharakter », dann « Foundry-Benutzer »: der betreffende Spieler. « Änderung hinzufügen »: « Feldpfad » system.attributes.inspiration, « Operation » auf « Wahr/Falsch umschalten ».

Ausprobieren und zurücksetzen

Öffnen Sie den Bogen des Charakters in Foundry und drücken Sie « Inspiration »: Der Bogen zeigt, dass der Charakter Inspiration hat. Drücken Sie erneut: Die Inspiration wird entfernt, und der Bogen kehrt in seinen Ausgangszustand zurück. Jeder Druck kehrt den aktuellen Zustand um: Hatte der Charakter bereits Inspiration, entfernt der erste Druck sie.

Gut zu wissen

Der Pfad system.attributes.inspiration gilt nur für D&D5e: Andere Spielsysteme verwenden andere Felder, und das Modul prüft den eingegebenen Pfad nicht. Existiert das Feld nicht, zeigt die Taste einen Warnhinweis, und der Inspektor meldet, dass ein Feld nicht den erwarteten Typ hat.

Hinweise endgültig aufdecken

In « Hinweise der Reihe nach aufdecken » zeigt die Taste eine Seite, die die Spieler bereits öffnen dürfen. Hier bleibt jede Hinweisseite in ihrem Journal verborgen, bis Sie sie aufdecken: Eine Taste deckt den aktuellen Hinweis auf, eine andere wechselt zum nächsten Hinweis und deckt ihn auf, ganz ohne Makro.

Bevor Sie beginnen

Melden Sie sich als Spielleitung an: Foundry lehnt es ab, dass ein Spieler die Berechtigung einer Seite ändert. Sie brauchen die Liste « Hinweise aus der Krypta » und die Variable « Aktueller Hinweis » aus dem Beispiel « Hinweise der Reihe nach aufdecken »: Legen Sie beide zuerst mit den dortigen Schritten unter « In Foundry » an.

In Foundry

  1. Geben Sie den Spielern die Berechtigung Beobachter auf dem Journal, das die Hinweisseiten enthält: Ohne sie erscheint dieses Journal nicht im Tab Journal der Spieler.
  2. Öffnen Sie die Berechtigungseinstellungen jeder Hinweisseite und setzen Sie die Berechtigung der Spieler ausdrücklich auf Keine: Eine neu angelegte Seite erbt die Berechtigung des Journals und wäre für die Spieler sichtbar. Diese Einstellung ersetzt die Berechtigung Beobachter, die das Beispiel « Hinweise der Reihe nach aufdecken » verlangt.

Auf Stream Deck

Hinweise endgültig aufdecken
Taste Befehl Einstellungen
Aktuellen Hinweis aufdecken Dokument aktualisieren « Dokument »: « Wertquelle » auf « Variable (erweitert) », dann die Variable Aktueller Hinweis. « Änderung hinzufügen »: « Feldpfad » ownership.default, « Operation » auf « Wert setzen », « Werttyp » auf « Zahl », dann « Wert » 2, was der Stufe Beobachter entspricht.
Nächsten Hinweis aufdecken Variablen ändern und Befehl ausführen « Variablenänderung hinzufügen »: « Operation » auf « Nächster Listeneintrag » (vorgeschlagen ist « Variable umschalten »), « Variable (erweitert) » auf Aktueller Hinweis. « Foundry-Befehl »: « Dokument aktualisieren » mit denselben Einstellungen wie « Aktuellen Hinweis aufdecken ».
Hinweis verbergen Dokument aktualisieren Optional. Dieselben Einstellungen wie « Aktuellen Hinweis aufdecken », aber mit dem Wert 0, der Keine entspricht: Die Taste verbirgt den aktuellen Hinweis. Der Wert -1 würde die Seite sichtbar machen, weil sie die Berechtigung Beobachter des Journals erbt.

Ausprobieren und zurücksetzen

Drücken Sie « Aktuellen Hinweis aufdecken »: Der erste Hinweis erscheint im Journal der Spieler, die übrigen Seiten bleiben verborgen. Drücken Sie dann « Nächsten Hinweis aufdecken »: Bei jedem Druck rückt der aktuelle Hinweis zur nächsten Seite vor, die aufgedeckt wird. Würden Sie mit der kombinierten Taste beginnen, würde der erste Hinweis übersprungen. Das Journal der Spieler und die Journalfenster, die sie geöffnet haben, aktualisieren sich sofort und ohne Neuladen, und aufgedeckte Seiten bleiben in ihrem Journal. Um die Ermittlung erneut zu spielen, setzen Sie jede Hinweisseite in Foundry wieder auf Keine und wenden Sie dann « Variable zurücksetzen » auf Aktueller Hinweis an.

Gut zu wissen

Beim letzten Hinweis ändert die kombinierte Taste nichts. « Variable zurücksetzen » setzt den aktuellen Hinweis auf den ersten zurück, verbirgt aber bereits aufgedeckte Seiten nicht wieder. Drückt ein Spieler diese Tasten, lehnt Foundry die Änderung ab. Ein kombinierter Befehl führt nur einen einzigen Foundry-Befehl aus: Eine Seite aufdecken und sie den Spielern mit « Journalseite teilen » zeigen erfordert zwei Tasten. Eine verborgene Seite ist nur in der Oberfläche der Spieler verborgen: Der Inhalt der Seite befindet sich bereits im Browser der Spieler, es ist also kein Geheimnis.

Die Spannung den Spielern anzeigen

In « Den Spannungsgrad ansagen » sagen Sie den Stand im Chat an. Hier zeigen Sie ihn im Namen eines Journals an, das die Spieler in ihrer Journalliste sehen: Eine Taste lässt die Spannung steigen und benennt das Journal um, zum Beispiel in « Spannung: 3 / 6 ». Sie entscheiden, wann Sie drücken.

Bevor Sie beginnen

Melden Sie sich als Spielleitung an: Foundry lehnt es ab, dass ein Spieler ein Journal umbenennt, das ihm nicht gehört. Sie brauchen die Variable « Spannung » aus dem Beispiel « Den Spannungsgrad ansagen »: Legen Sie sie zuerst mit dem dortigen Schritt unter « In Foundry » an.

In Foundry

Legen Sie ein Journal namens « Spannung » an und geben Sie den Spielern darauf die Berechtigung Beobachter: Ohne sie erscheint es nicht im Tab Journal der Spieler.

Auf Stream Deck

Die Spannung den Spielern anzeigen
Taste Befehl Einstellungen
Erhöhen und anzeigen Variablen ändern und Befehl ausführen Eine Änderung « Variable erhöhen » auf Spannung, « Änderung » 1. « Foundry-Befehl »: « Dokument aktualisieren ». « Dokument »: das Journal « Spannung », aus der Liste gewählt. « Änderung hinzufügen »: « Feldpfad » name, « Operation » auf « Wert setzen », « Werttyp » auf « Text zusammensetzen (erweitert) », dann drei Abschnitte in dieser Reihenfolge: der Text « Spannung: » mit einem Leerzeichen am Ende, die Variable Spannung und der Text « / 6 » mit einem Leerzeichen am Anfang.

Ausprobieren und zurücksetzen

Drücken Sie bei einem Zähler auf 2 « Erhöhen und anzeigen »: Der Zähler springt auf 3, das Journal heißt nun « Spannung: 3 / 6 », und der neue Name erscheint sofort und ohne Neuladen im Tab Journal jedes Spielers. Um zum Anfang zurückzukehren, setzen Sie den Zähler mit der Taste « Auf null zurücksetzen » aus dem Beispiel « Den Spannungsgrad ansagen » zurück und benennen Sie das Journal in Foundry wieder in « Spannung » um.

Gut zu wissen

Am Maximum bleibt der Zähler bei 6, und der Name des Journals ändert sich nicht. Die Taste benennt das Journal selbst um, nicht eine seiner Seiten: Die Journalliste zeigt die Namen der Journale, der Name einer Seite erscheint nur im geöffneten Journal.

Variablen und Listen in Foundry anlegen

Nach einer erneuten Verbindung

Wenn sich der Foundry-Browser neu verbindet, erscheint er als neue Sitzung. Wählen Sie sie auf jeder betroffenen Taste erneut aus, auch nach einem Neustart der lokalen Verbindung. Verbindet sich nur das Plugin neu, kann es eine weiterhin verbundene Foundry-Sitzung wiederfinden. Drücken Sie Ctrl+C im Terminal, wird die lokale Verbindung beendet und die laufenden Sitzungen werden unterbrochen.

Fehlerbehebung

  • Keine Verbindung: Prüfen Sie, ob das Terminalfenster noch geöffnet ist, ob die eingegebenen Adressen mit den in dieser Anleitung genannten übereinstimmen und ob Foundry und das Plugin denselben Schlüssel verwenden.
  • Foundry fehlt oder wird abgelehnt: Prüfen Sie den exakten erlaubten Ursprung in companion.json und den Schalter der Stream-Deck-Karte in diesem Browser. Eine andere Serveradresse ändert den Ursprung.
  • Foundry über HTTPS: Der Browser kann wss und ein vertrauenswürdiges lokales Zertifikat verlangen. Setzen Sie tlsCert und tlsKey auf absolute Pfade zu PEM-Dateien und nutzen Sie dann wss in Foundry und im Plugin. Das Zertifikat muss zur lokalen Adresse passen und vom Foundry-Browser und von Stream Deck als vertrauenswürdig akzeptiert werden. Es wird nicht automatisch installiert.
  • Fehlende oder synchronisierende Sitzung: Warten Sie auf Bereitschaft und wählen Sie Welt, Benutzer und Browser auf der Taste erneut.
  • Abgelehnter Befehl oder fehlendes Dokument: Prüfen Sie Foundry-Rechte und Zieldokument. Die Sitzungswahl verleiht keine zusätzlichen Rechte.
  • Overlay-Test nicht verfügbar: Prüfen Sie JDR-Ninja-Kontoverbindung, Overlay-Aktivierung und Premium-Prüfung in Foundry. Der lokale Schlüssel bestätigt diesen Zugang nicht.
  • Unbestätigtes oder teilweises Ergebnis: Prüfen Sie betroffene Bögen, Szenen, Variablen oder Kämpfe in Foundry vor erneutem Drücken. Eine Unterbrechung kann nach der Ausführung auftreten. Das Plugin wiederholt Befehle nicht automatisch.

Häufige Fragen

Warum verschwindet der Schlüssel aus dem Feld?

Das Plugin leert das Feld nach dem Speichern, damit der gespeicherte Schlüssel nicht angezeigt wird. Die Verbindung wird dadurch nicht entfernt.

Warum muss die Sitzung erneut gewählt werden?

Eine Foundry-Neuverbindung erzeugt eine neue Identität. Tasten behalten die vorherige Auswahl, damit Befehle nicht an andere Welten, Benutzer oder Browser gehen.

Darf ich einen Befehl mit unbestätigtem Ergebnis wiederholen?

Prüfen Sie zuerst Foundry. Der Befehl kann trotz Verbindungsunterbrechung bereits ausgeführt worden sein. Jeder neue Tastendruck ist ein neuer Befehl.

Kann eine Taste den Wert einer Variablen anzeigen?

Nein. Die Tasten zeigen den Pausenzustand, die Dunkelheitsstufe, die Ressourcenleiste eines Tokens oder kurz das Ergebnis eines Befehls. Den Wert einer Variablen oder den gewählten NSC sehen Sie in Foundry oder im Inspektor.

Stream Deck für Foundry VTT Das JDR-Ninja-Modul für Foundry