Zum Hauptinhalt springen

Das JDR-Ninja-Modul für Foundry

Foundry VTT mit Stream Deck steuern

Steuern Sie Ihre Charakterbögen von Ihrem Stream Deck aus.

Aktivieren Sie eine Szene, zeigen Sie einen Hinweis, würfeln Sie oder ändern Sie direkt einen Charakterbogen per Stream Deck. Das JDR-Ninja-Plugin leitet Ihre Befehle an Foundry VTT weiter, und mit Variablen können Sie dieselben Tasten während des gesamten Spiels wiederverwenden.

Ihre Charakterbögen bearbeiten

Eine Taste kann jedes Feld ändern, das Foundry Sie bearbeiten lässt: die Inspiration eines Charakters, seine Trefferpunkte, sein Geld, die Ladungen eines Gegenstands, den Namen einer Journalseite. Bis zu 16 Felder ändern sich in einer einzigen Aktualisierung.

  • Fünf Operationen: einen Wert setzen, erhöhen, verringern, Wahr/Falsch umschalten, ein Feld entfernen.
  • Das Ziel Ihrer Wahl: ein bestimmtes Dokument, der einem Spieler zugewiesene Charakter, der ausgewählte Token oder sein Akteur oder ein Dokument, das eine Variable angibt.
  • Feste Werte oder Werte aus Ihren Variablen: ein Bonus, ein Zähler, ein zusammengesetzter Text.
  • Ihre Foundry-Berechtigungen gelten: Die Spielleitung kann alles ändern, ein Spieler nur, was ihm gehört.
  • Die Felder hängen vom Spielsystem ab: Sie geben ihren Pfad an, zum Beispiel system.attributes.inspiration in D&D5e. Das Modul prüft diesen Pfad nicht.

Beispiele für Ihre nächste Spielrunde

Jedes Beispiel nennt, was es verwendet, und führt zur schrittweisen Einrichtung in der Anleitung.

Foundry-Befehle

Den Ort mit drei Tasten wechseln

Aktivieren Sie die nächste Szene, starten Sie ihre Klangkulisse und stellen Sie ihre Dunkelheit ein, jeder Befehl auf einer eigenen Taste.

Beispiel Schritt für Schritt ansehen

Variablen: Liste und kombinierter Befehl

Hinweise der Reihe nach aufdecken

Eine Liste von Seiten und ein kombinierter Befehl: Wechseln Sie zum nächsten Hinweis und zeigen Sie ihn Ihren angemeldeten Spielern, ganz ohne Makro.

Beispiel Schritt für Schritt ansehen

Variablen: Zähler und zusammengesetzter Text

Den Spannungsgrad ansagen

Ein Zähler von 0 bis 6, gespeichert in einer Variable: Lassen Sie ihn steigen und sagen Sie seinen neuen Wert im Chat an.

Beispiel Schritt für Schritt ansehen

Die Befehle

Das Plugin bietet 40 Befehle: 31 für Foundry VTT, darunter das Aktualisieren von Dokumenten, und 9 für Variablen. Jeder Befehl beachtet die Berechtigungen des angemeldeten Foundry-Benutzers, und mit SL gekennzeichnete Befehle sind der Spielleitung vorbehalten.

Variablen und Listen

Eine Liste von NSC oder Hinweisen, ein Zähler, ein Bonus: Mit den Variablen und Listen, die Sie in Foundry anlegen, genügen wenige Tasten für das ganze Spiel. Ein kombinierter Befehl ändert einen Wert und führt dann eine Aktion aus, zum Beispiel zum nächsten Hinweis wechseln und ihn zeigen. Werte und Berechtigungen werden bei jedem Tastendruck geprüft.

Variable setzen
Gibt der Variable einen neuen Wert.
Listeneintrag wählen
Wählt einen bestimmten Eintrag der verknüpften Liste.
Nächster Listeneintrag
Geht in der Liste einen Eintrag weiter und kann nach dem letzten Eintrag wieder von vorn beginnen.
Vorheriger Listeneintrag
Geht in der Liste einen Eintrag zurück.
Variable erhöhen
Addiert einen Betrag zur Zahl, innerhalb der festgelegten Grenzen.
Variable verringern
Zieht einen Betrag von der Zahl ab, innerhalb der festgelegten Grenzen.
Variable umschalten
Wechselt von Ja zu Nein oder von Nein zu Ja.
Variable zurücksetzen
Setzt die Variable auf ihren Standardwert zurück.
Variablen ändern und Befehl ausführen
Wendet bis zu 16 Änderungen an und führt dann einen Foundry-Befehl aus.
  • Drei Möglichkeiten, eine Variable zu definieren: ein gespeicherter Wert, eine Auswahl aus einer Liste oder ein berechneter Wert. Eine Berechnung kann andere Variablen und die Felder eines Dokuments verwenden, etwa die Inspiration eines Charakters.
  • Dreizehn Werttypen: Zahl, Text, Ja oder Nein, Akteur, Token, Szene, Journal, Journalseite, Makro, Wiedergabeliste, Audiotitel, Zufallstabelle und Kampf.
  • Persönliche Variablen für Ihre eigenen Tasten oder Weltvariablen, die für den ganzen Spieltisch gelten und von der Spielleitung verwaltet werden.
  • In jedem Feld eines Befehls kann der Wert aus einer Variablen stammen, aus einem Text aus festen Teilen und Variablen, aus dem einem Spieler zugewiesenen Charakter oder aus dem ausgewählten Token.
  • Argumente für Ihre Skriptmakros: bis zu 16 deklarierte Werte pro Makro, auf jeder Taste anders belegt.

Variablen werden in den Einstellungen von Foundry gespeichert, nicht im Browser.

game.settings flags.jdr-ninja.arguments

Beispiele ansehen

Die Befehle von Foundry VTT

Jeder Befehl ruft eine Funktion von Foundry VTT auf, die unter seinem Namen angegeben ist: Foundry führt die Aktion aus, mit seinen eigenen Regeln und Ihren Berechtigungen.

Akteure und Makros

  • Akteur öffnen

    Actor#sheet.render()
  • Makro ausführen

    Macro#execute()

Szenen

  • Szene ansehen

    Scene#view()
  • Szene aktivieren SL

    Scene#activate()
  • Szene vorladen SL

    game.scenes.preload()
  • Dunkelheit einstellen SL

    Scene#update({ darknessLevel })

Journale

  • Journalseite öffnen

    JournalEntry#sheet.render()
  • Journalseite teilen SL

    Journal.show()

Musik und Klänge

  • Ton abspielen oder stoppen SL

    Playlist#playSound() / stopSound()
  • Titel wechseln SL

    Playlist#playNext()
  • Musik stoppen SL

    Playlist#stopAll()
  • Lautstärke einstellen SL

    PlaylistSound#update({ volume })

Spiel und Oberfläche

  • Pausieren oder fortsetzen SL

    game.togglePause()
  • Seitenleisten-Tab öffnen

    ui.sidebar.changeTab()
  • Werkzeug wählen

    ui.controls.activate()

Würfel, Tabellen und Chat

  • Würfeln

    Roll#toMessage()
  • Aus Tabelle ziehen

    RollTable#draw()
  • Chatnachricht senden

    ChatMessage.create()

Token und Zustände

  • Token auswählen

    Token#control()
  • Token anvisieren

    Token#setTarget()
  • Token verbergen oder zeigen SL

    TokenDocument#update({ hidden })
  • Token-Ressource ändern

    Actor#modifyTokenAttribute()
  • Zustand anwenden oder entfernen

    Actor#toggleStatusEffect()

Kampf

  • Kampf starten SL

    Combat#startCombat()
  • Kampf beenden SL

    DialogV2.confirm() + Combat#delete()
  • Nächster Zug SL

    Combat#nextTurn()
  • Vorheriger Zug SL

    Combat#previousTurn()
  • Nächste Runde SL

    Combat#nextRound()
  • Initiative würfeln SL

    Combat#rollAll()

Overlay

  • Overlay testen

    JDR-Ninja-Server, Premium-Zugang

« Token-Ressource ändern » ändert nur die Leiste des Tokens: Schaden und Heilung nach den Regeln des jeweiligen Systems werden dabei nicht verwaltet. « Kampf beenden » verlangt eine Bestätigung in Foundry.

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

Tragen Sie im Fenster « Stream Deck » des Moduls die Verbindungsadresse und den Kopplungsschlüssel ein und klicken Sie auf « Speichern und aktivieren ».

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.

Wie Stream Deck mit Foundry kommuniziert

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

Das Stream-Deck-Plugin sendet Ihre Befehle über eine lokale Verbindung an das JDR-Ninja-Modul im gewählten Foundry-Browser. Foundry führt die Befehle aus und prüft die Berechtigungen des angemeldeten Benutzers. Dieser Browser muss auf demselben Computer wie Stream Deck geöffnet bleiben, der Foundry-Server darf aber anderswo gehostet sein. Die lokale Verbindung nutzt einen eigenen Kopplungsschlüssel: Sie verlangt kein JDR-Ninja-Kontotoken und ersetzt keine Foundry-Berechtigung.

Jede Taste bleibt an die von Ihnen gewählte Welt, den Benutzer und den Browser gebunden. Das Plugin unterscheidet einen abgeschlossenen Befehl von einem abgelehnten oder einem mit unbestätigtem Ergebnis. Ist das Ergebnis unbestätigt, prüfen Sie Foundry, bevor Sie erneut drücken.

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 die lokale Verbindung. Jede Taste benötigt eine ausdrücklich gewählte Sitzung.

Foundry-Modul installieren

Berechtigungen und Zugang

Common.Free

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 dienen Variablen?

Sie speichern einen Wert in Foundry: den gewählten NSC, den aktuellen Hinweis, einen Zähler oder einen Bonus. Eine Taste verwendet den jeweils aktuellen Wert, und der Befehl « Variablen ändern und Befehl ausführen » ändert ihn und handelt dann in Foundry.

Darf der Foundry-Server entfernt gehostet sein?

Ja. Der Browser, der das Spiel öffnet, muss dennoch auf demselben Computer wie Stream Deck laufen.

Funktionieren Tasten nach dem Schließen von Foundry?

Nein. Sie funktionieren nur, wenn ein Foundry-Browser geöffnet, mit dem Spiel verbunden und bereit für Befehle ist. Schließen Sie diesen Browser, endet die 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.

Kann ich jedes beliebige Feld eines Charakterbogens ändern?

Ja, wenn Foundry Ihnen erlaubt, dieses Dokument zu bearbeiten: Die Spielleitung kann alles ändern, ein Spieler nur, was ihm gehört. Der Feldpfad hängt vom Spielsystem ab, und das Modul prüft ihn nicht. Foundry ignoriert ein nicht vorhandenes Feld, und eine Erhöhung oder Umschaltung auf diesem Feld wird auf der Taste gemeldet.

Den ersten Befehl vorbereiten

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

Das JDR-Ninja-Modul für Foundry