モジュール作成者
例: ダイス トレイとアクション ドック
Module Lab でライブ ホスト ランタイム、インタラクティブなコントラクト プレビュー、および代表的なホストの展示を比較します。
ダイス トレイ: コンクリート足場とホスト ランタイム
CLI スキャフォールドは、具体的な Dice & Chat パッケージです。 Fabled のファーストパーティ Dice Tray は同じモデルを使用します。アカウント ターゲットはチャット コンポーザ パネルとグローバル コマンドを提供し、dice.roll.self をリクエストし、オプションで chat.post.self をリクエストし、レビューされたアクション/フレーム/ロケール アセットをポイントします。
- このパッケージには、サイコロ式、可視性の選択、サイコロ ボタン、プリセット、ローカライズされたラベルが含まれています。
- ホワイトリストに登録された fabled.dice-tray.v1 レンダラーは Fabled に属します。このモジュールには任意の React UI は同梱されていません。
- ホストは正確なアクション記述子をチェックし、ネイティブ ロールを実行し、結果と 3D プレゼンテーションを所有し、視聴者ルールを適用します。
- Module Lab は、開発中の Fabled のリポジトリにバンドルされた正規の Dice Tray フィクスチャをプレビューします。任意のプロジェクト パスをロードしたり、パッケージをインストール、アクティブ化、承認、公開したりすることはできません。
アクション ドック: インタラクティブな契約プレビュー
fabled-labs.token-action-hud パッケージは vtt をターゲットにし、制御されたトークンのコンパクトな選択オーバーレイをプレビューします。これは userCampaign コンパクトモード設定に貢献し、実稼働 VTT レンダラー契約が承認されるまで他のアセットと同様に不活性のままであるレビュー済みの Action Dock 記述子を使用します。
| 機能 | プレビューでそれが要求される理由 | 同意 |
|---|---|---|
| tokens.read.controlled | ユーザーが制御するトークンのセーフ ビューを読む | キャンペーンとユーザー |
| フレームワーク.invoke.controlled | レビュー済みの制御トークン アクションを呼び出します | キャンペーンとユーザー |
| events.observe.declared | 宣言された選択とターンステートの変更を観察する | キャンペーン |
| dice.roll.self (オプション) | レビュー済みのアクションをユーザーが呼び出したときのロール | ユーザー |
プレビューでは、Fabled がアクション権限を保持しながら、パーミッションでフィルターされたコンテキスト、古い状態の拒否、べき等コマンドのディスパッチ、ローカリゼーション、およびスコープ設定を示します。スキーマが有効なマニフェストはパッケージの境界にすぎません。プロダクションレンダラ契約が利用できないため、ラボ外への入場は依然として停止されています。
ウェルカム コマンドとキャラクター シート: ホストの展示
Module Lab には、完全なパッケージのデモではなく、2 つの代表的なホスト展示も含まれています。 Welcome コマンドは、Spotlight コマンドが通常のチャット結果を生成し、無効にすると消える、オーナー管理のキャンペーン モジュールを反映しています。 Character Sheet は、Fabled の正規 FramePreview へのマーカーのみレビューされた貢献を反映しており、VIEW 拒否とセーフモードのティアダウンによりキャラクター データがホスト内に保持されます。
呪文エフェクト：ソース版CLI候補
npm run modules:cli -- module init arcane-arsenal --template spell-effects --publisher-id my-studio --publisher-name "My Studio"テンプレートには6つの例が含まれます：arcane_bolt、dragon_fire、frost_breath、toxic_breath、sword_swing、melee_hit。対応するソース版ホストは、lightning_arc、meteor_strike、frost_nova、void_vortex、radiant_sigil、thorn_burstを加えた合計12種類のプリセットに対応します。レシピは同じ7キーのfabled.vtt-effect.v1契約を通じて、固定色、強度、300–2200 msの持続時間を指定します。視覚効果のみを提供し、任意のシェーダー、レイヤー、ダメージ、回復、リソース消費、インポートされた呪文ルールは含みません。
レビューと正確なリリースのインストール後、キャンペーン所有者が「キャンペーン → モジュール」で有効にします。VTTでは権限のあるGMがターゲットツールで既存のトークンを1–8個選択し、別の発動元トークンのコンテキストメニューからArcane Arsenalを開き、レシピを選びます。Fabledが発動を検証し、確定したエフェクトを配信します。無効にするとメニューが消え、新しい発動はできなくなります。すでに許可されたエフェクトは2200 ms以内に終了します。
再利用可能なパターン
- マニフェストと正確な JSON アセットで意図を宣言します。
- 最小限の機能と同意範囲を尋ねます。
- Fabled にレンダラー、コンテキスト フィルタリング、権限のあるミューテーション、および結果を独自に持たせます。
- ローカルで検証および検査し、不変の証拠を審査のために提出します。
- コントリビューションを完全に破棄するには、無効化、置換、取り消し、およびセーフ モードを期待します。