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.
Das JDR-Ninja-Modul für Foundry
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.
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.
Mit Variablen kann eine Taste außerdem:
Jedes Beispiel nennt, was es verwendet, und führt zur schrittweisen Einrichtung in der Anleitung.
Foundry-Befehle
Aktivieren Sie die nächste Szene, starten Sie ihre Klangkulisse und stellen Sie ihre Dunkelheit ein, jeder Befehl auf einer eigenen Taste.
Variablen: Liste und kombinierter Befehl
Eine Liste von Seiten und ein kombinierter Befehl: Wechseln Sie zum nächsten Hinweis und zeigen Sie ihn Ihren angemeldeten Spielern, ganz ohne Makro.
Variablen: Zähler und zusammengesetzter Text
Ein Zähler von 0 bis 6, gespeichert in einer Variable: Lassen Sie ihn steigen und sagen Sie seinen neuen Wert im Chat an.
Dokumente aktualisieren
Schalten Sie die Inspiration auf dem Charakterbogen eines Spielers ein oder aus, ohne ihn zu öffnen.
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.
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.
Variablen werden in den Einstellungen von Foundry gespeichert, nicht im Browser.
game.settings
flags.jdr-ninja.arguments
Document#update()
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.
Akteur öffnen
Actor#sheet.render()
Makro ausführen
Macro#execute()
Szene ansehen
Scene#view()
Szene aktivieren SL
Scene#activate()
Szene vorladen SL
game.scenes.preload()
Dunkelheit einstellen SL
Scene#update({ darknessLevel })
Journalseite öffnen
JournalEntry#sheet.render()
Journalseite teilen SL
Journal.show()
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 })
Pausieren oder fortsetzen SL
game.togglePause()
Seitenleisten-Tab öffnen
ui.sidebar.changeTab()
Werkzeug wählen
ui.controls.activate()
Würfeln
Roll#toMessage()
Aus Tabelle ziehen
RollTable#draw()
Chatnachricht senden
ChatMessage.create()
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 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 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.
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.
Tragen Sie im Fenster « Stream Deck » des Moduls die Verbindungsadresse und den Kopplungsschlüssel ein und klicken Sie auf « Speichern und aktivieren ».
Befehl und Eingabefelder richten sich nach der gewählten Sitzung und den Rechten des Foundry-Benutzers.
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.
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.
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.
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.
Ja. Der Browser, der das Spiel öffnet, muss dennoch auf demselben Computer wie Stream Deck laufen.
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.
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.
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.
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.
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.
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.
Folgen Sie der Anleitung, um die drei Komponenten zu verbinden und einen einfachen Befehl zu testen.