Modulersteller
Beispiele: Würfeltablett und Aktionsdock
Vergleichen Sie die Live-Host-Laufzeit, die interaktive Vertragsvorschau und repräsentative Host-Exponate im Module Lab.
Würfeltablett: Betongerüst und Host-Laufzeit
Das CLI-Gerüst ist das konkrete Dice & Chat-Paket. Fableds Erstanbieter-Dice-Tray verwendet dasselbe Modell: Ein Kontoziel steuert ein Chat-Composer-Panel und einen globalen Befehl bei, fordert dice.roll.self an, fordert optional chat.post.self an und verweist auf überprüfte Aktions-/Frame-/Gebietsschema-Assets.
- Das Paket stellt einen Würfelausdruck, eine Sichtbarkeitsauswahl, Würfelschaltflächen, Voreinstellungen und lokalisierte Beschriftungen bereit.
- Der Renderer fabled.dice-tray.v1 auf der Zulassungsliste gehört zu Fabled; Das Modul liefert keine beliebige React-Benutzeroberfläche.
- Der Host überprüft den genauen Aktionsdeskriptor, führt den nativen Wurf aus, ist Eigentümer des Ergebnisses und der 3D-Präsentation und wendet Zielgruppenregeln an.
- Module Lab gibt eine Vorschau auf Fableds im Repository gebündeltes kanonisches Dice Tray-Gerät, das sich in der Entwicklung befindet. Es kann kein beliebiger Projektpfad geladen oder ein Paket installiert, aktiviert, genehmigt oder veröffentlicht werden.
Action Dock: interaktive Vertragsvorschau
Das Paket „fabled-labs.token-action-hud“ zielt auf vtt ab und zeigt eine Vorschau einer kompakten Auswahlüberlagerung für das kontrollierte Token an. Es trägt eine userCampaign-Kompaktmodus-Einstellung bei und verwendet überprüfte Action-Dock-Deskriptoren, die wie andere Assets inaktiv bleiben, bis der Produktions-VTT-Renderer-Vertrag zugelassen wird.
| Fähigkeit | Warum die Vorschau danach fragt | Einwilligung |
|---|---|---|
| tokens.read.controlled | Lesen Sie die sichere Ansicht des vom Benutzer kontrollierten Tokens | Kampagne und Benutzer |
| Framework.invoke.Controlled | Rufen Sie eine überprüfte Aktion mit kontrolliertem Token auf | Kampagne und Benutzer |
| events.observe.declared | Deklarierte Auswahl- und Turn-State-Änderungen beobachten | Kampagne |
| dice.roll.self (optional) | Rollen Sie für eine überprüfte Aktion, wenn der Benutzer sie aufruft | Benutzer |
Die Vorschau zeigt berechtigungsgefilterten Kontext, Ablehnung veralteter Zustände, idempotente Befehlsverteilung, Lokalisierung und bereichsbezogene Einstellungen, während Fabled die Aktionsautorität behält. Ein schemagültiges Manifest ist nur die Paketgrenze; Der nicht verfügbare Produktions-Renderer-Vertrag verhindert weiterhin den Zutritt außerhalb des Labors.
Willkommenskommando und Charakterblatt: Gastgeberausstellungen
Module Lab umfasst außerdem zwei repräsentative Host-Exponate, keine Demos des vollständigen Pakets. Welcome Command spiegelt ein vom Eigentümer verwaltetes Kampagnenmodul wider, dessen Spotlight-Befehl ein normales Chat-Ergebnis erzeugt und nach der Deaktivierung verschwindet. Das Charakterblatt spiegelt einen nur durch Marker überprüften Beitrag zu Fableds kanonischem FramePreview wider, wobei die VIEW-Verweigerung und das Teardown im abgesicherten Modus die Charakterdaten im Host behalten.
Zaubereffekte: CLI-Kandidat aus dem Quellcode
npm run modules:cli -- module init arcane-arsenal --template spell-effects --publisher-id my-studio --publisher-name "My Studio"Die Vorlage enthält sechs Beispiele: arcane_bolt, dragon_fire, frost_breath, toxic_breath, sword_swing und melee_hit. Der passende Host aus dem Quellstand akzeptiert insgesamt 12 Voreinstellungen, zusätzlich lightning_arc, meteor_strike, frost_nova, void_vortex, radiant_sigil und thorn_burst. Rezepte bestimmen feste Farben, Intensität und eine Dauer von 300–2200 ms über denselben fabled.vtt-effect.v1-Vertrag mit sieben Schlüsseln. Sie liefern ausschließlich visuelle Effekte: keine beliebigen Shader, Ebenen, Schäden, Heilung, Ressourcenkosten oder importierten Zauberregeln.
Nach Prüfung und Installation der genauen Version aktiviert der Kampagnenbesitzer das Modul unter Kampagne → Module. Im VTT wählt ein berechtigter Spielleiter mit dem Zielwerkzeug 1–8 vorhandene Token aus, öffnet das Kontextmenü eines anderen Quell-Tokens, erweitert Arcane Arsenal und wählt ein Rezept. Fabled prüft den Vorgang und überträgt den maßgeblichen Effekt. Deaktivieren entfernt das Menü und verhindert neue Effekte; bereits zugelassene Effekte enden innerhalb von 2200 ms.
Das wiederverwendbare Muster
- Deklarieren Sie die Absicht im Manifest und geben Sie die genauen JSON-Assets an.
- Fragen Sie nach den Mindestfunktionen und Einwilligungsbereichen.
- Lassen Sie Fabled eigene Renderer, Kontextfilter, maßgebliche Mutationen und Ergebnisse besitzen.
- Validieren und prüfen Sie lokal und reichen Sie dann unveränderliche Beweise zur Überprüfung ein.
- Erwarten Sie Deaktivierung, Ersetzung, Widerruf und abgesicherten Modus, um Beiträge sauber zu löschen.