Przejdź do głównej treści
Fabled

Twórca modułu

Przykłady: tacka na kości i dok akcji

Porównaj środowisko wykonawcze hosta na żywo, interaktywny podgląd kontraktu i reprezentatywne prezentacje hosta w laboratorium modułowym.

Dice Tray: betonowe rusztowanie i środowisko wykonawcze hosta

Rusztowanie CLI to konkretny pakiet Dice & Chat. Własna funkcja Dice Tray firmy Fabled wykorzystuje ten sam model: cel konta udostępnia panel kompozytora czatu i polecenia globalne, żąda dice.roll.self, opcjonalnie żąda chat.post.self i wskazuje sprawdzone zasoby akcji/ramki/ustawienia regionalne.

  • Pakiet zawiera wyraz kostki, wybór widoczności, przyciski kości, ustawienia wstępne i zlokalizowane etykiety.
  • Moduł renderujący fabled.dice-tray.v1 znajdujący się na liście dozwolonych należy do Fabled; moduł nie dostarcza dowolnego interfejsu użytkownika React.
  • Gospodarz sprawdza dokładny deskryptor akcji, wykonuje natywny rzut, jest właścicielem wyniku i prezentacji 3D oraz stosuje reguły dotyczące odbiorców.
  • Module Lab prezentuje kanoniczne urządzenie Dice Tray dołączone do repozytorium Fabled w fazie rozwoju. Nie może załadować dowolnej ścieżki projektu, ani zainstalować, aktywować, zatwierdzić ani opublikować pakietu.

Action Dock: interaktywny podgląd kontraktu

Pakiet fabled-labs.token-action-hud jest przeznaczony dla vtt i wyświetla podgląd kompaktowej nakładki wyboru dla kontrolowanego tokena. Zawiera ustawienie trybu kompaktowego userCampaign i wykorzystuje sprawdzone deskryptory Action Dock, które pozostają obojętne, podobnie jak inne zasoby, do czasu zatwierdzenia kontraktu na renderowanie produkcyjne VTT.

MożliwośćDlaczego podgląd o to pytaZgoda
tokeny.odczyt.kontrolowanePrzeczytaj bezpieczny widok tokena kontrolowanego przez użytkownikakampania i użytkownik
framework.invoke.controlWywołaj sprawdzoną akcję kontrolowanego tokenakampania i użytkownik
zdarzenia.observe.zadeklarowaneObserwuj zadeklarowane zmiany wyboru i stanu turykampania
dice.roll.self (opcjonalnie)Rzuć na sprawdzoną akcję, gdy użytkownik ją wywołaużytkownik

Podgląd przedstawia kontekst z filtrem uprawnień, odrzucenie przestarzałego stanu, idempotentne wysyłanie poleceń, lokalizację i ustawienia zakresu, podczas gdy Fabled zachowuje uprawnienia do działania. Manifest prawidłowy dla schematu stanowi jedynie granicę pakietu; niedostępna umowa na renderowanie produkcyjne nadal uniemożliwia wstęp poza laboratorium.

Polecenie powitalne i karta postaci: hostuj eksponaty

Laboratorium modułów zawiera także dwie reprezentatywne prezentacje hostów, a nie demonstracje pełnego pakietu. Polecenie Welcome odzwierciedla moduł kampanii zarządzany przez właściciela, którego polecenie Spotlight generuje zwykły wynik czatu i znika po wyłączeniu. Karta postaci odzwierciedla zweryfikowany tylko za pomocą znaczników wkład w kanoniczny podgląd FramePreview firmy Fabled, z odmową WIDOKU i porzuceniem w trybie awaryjnym, przechowującym dane postaci w hoście.

Efekty zaklęć: kandydat CLI ze źródeł

npm run modules:cli -- module init arcane-arsenal --template spell-effects --publisher-id my-studio --publisher-name "My Studio"

Szablon zawiera sześć przykładów: arcane_bolt, dragon_fire, frost_breath, toxic_breath, sword_swing i melee_hit. Host z odpowiadającej wersji źródłowej obsługuje łącznie 12 ustawień, w tym także lightning_arc, meteor_strike, frost_nova, void_vortex, radiant_sigil i thorn_burst. Receptury określają stałe kolory, intensywność i czas trwania 300–2200 ms za pomocą tego samego kontraktu fabled.vtt-effect.v1 z siedmioma kluczami. Zapewniają wyłącznie efekty wizualne: bez dowolnych shaderów, warstw, obrażeń, leczenia, kosztów zasobów ani importowanych reguł zaklęć.

Po przeglądzie i instalacji dokładnego wydania właściciel kampanii aktywuje moduł w Kampania → Moduły. W VTT uprawniony MG wybiera narzędziem celu 1–8 istniejących żetonów, otwiera menu kontekstowe innego żetonu źródłowego, rozwija Arcane Arsenal i wybiera recepturę. Fabled weryfikuje użycie i rozsyła zatwierdzony efekt. Wyłączenie usuwa menu i blokuje nowe użycia; już dopuszczone efekty kończą się w ciągu 2200 ms.

Wzór wielokrotnego użytku

  • Zadeklaruj zamiar w manifeście i dokładne zasoby JSON.
  • Zapytaj o minimalne możliwości i zakresy zgody.
  • Pozwól Fabledowi mieć własne moduły renderujące, filtrowanie kontekstu, autorytatywne mutacje i wyniki.
  • Zweryfikuj i sprawdź lokalnie, a następnie prześlij niezmienny dowód do sprawdzenia.
  • Oczekuj, że wyłączenie, wymiana, unieważnienie i tryb awaryjny pozwolą na czyste zniszczenie wkładów.