正しい Folosa アカウント
クレジットと過去の生成物を所有する同じ認証済みアカウントを使います。履歴はアカウント単位です。
FOLOSA BRIDGE 操作ハンドブック
Folosa のアイデアをプレイ可能な Foundry Actor へ。
Game Master 向けの完全な手順です。モジュールの導入、安全な接続、3つの作成モード、レンダー確認、新旧タスクのインポート、問題解決までを説明します。
- Foundry
- V13 以降、V14 検証済み
- 権限
- Game Master 権限
- 入力
- Build、Prompt、Upload
- 配信
- 検証済み WebM + PNG を Actor 化
1. 開始前の確認
インストール前にアカウント、ファイル、権限、環境を確認します。
Game Master で開く
接続、課金タスク、Foundry Data への保存、Actor 作成は GM のみ実行できます。
Foundry バージョン
V13 以降を使用し、現在は V14 を検証済みです。問題調査前にモジュールを更新します。
画像の準備
PNG、JPG、WebP、300x300 px 以上、10 MB 以下。全身を中央に置き、手足、武器、翼、エフェクトの周囲に余白を取ります。
2. インストールと有効化
ZIP の手動導入、または利用可能なら manifest URL を使います。
世界をバックアップ
導入や更新の前に Foundry world のバックアップを作成します。
パッケージを導入
ZIP を取得し、manifest で導入するか folosa-bridge を Data/modules に展開します。
Foundry を再起動
アプリまたはサーバーを再起動し、スクリプトとテンプレートを読み込みます。
world で有効化
Manage Modules で Folosa Bridge を有効にして保存します。
パネルを開く
GM で Settings から Folosa Bridge を選ぶか Ctrl+B。生成中に閉じても処理は続きます。
3. 安全に接続
短時間の device code から、制限付きで取り消し可能な認証情報を発行します。Foundry にパスワードは入力しません。
接続開始
Connect Folosa で承認ページを開き、一時コードを表示します。
Folosa にログイン
ブラウザでログインし、承認前にメールアドレスを確認します。
デバイスを承認
認識できる Foundry client と world だけを承認します。コードは期限付きで一回限りです。
アカウントバー確認
Connected、メール、クレジット、プランが表示されるまで待ちます。状態は自動更新されます。
権限範囲
自分のクレジット、job、asset、checkout handoff のみ扱い、パスワードや他ユーザーのデータは読めません。
4. 3つの作成モード
Web サイトと同じ入力経路ですが、Bridge では一度に1件送信します。
Build
種族、アーキタイプ、環境、アクションを選び、全身 Token 用の構造化 prompt を作ります。
Prompt
800文字以内で、1体の対象、見える装備、動作、スタイルを明確に書きます。
Upload
使用権のある画像を選びます。必要なら画像に存在する手や武器を使った動作を追加します。
モードを混ぜない
送信されるのは有効なモードだけで、他モードの残り値は無視されます。
スタイル
Dark Fantasy、Anime、Ink を選択。Upload では参照画像が人物の基準です。
実用的な構図
手足が切れた close-up を避け、Prompt では中央の全身と明確な silhouette を指定します。
5. 品質とクレジット
品質は配信仕様とクレジット予約を決めます。
Standard VTT
1 Token 80 CRD。ライブ Scene 向けの軽量 512p 透明 WebM。
HD Pro
1 Token 200 CRD。より鮮明な 1080p 配信。
4K Master
1 Token 280 CRD。アーカイブ向けの最高解像度。
予約と確定
受理時に予約し、成功時に確定します。確認済みシステム障害は予約を解放します。数分かかっても重複送信しません。
6. 送信、待機、更新、キャンセル
タスクリストが正式な状態です。Refresh は1つで、アカウントと履歴を同時に更新します。
内容確認
モード、画像または Prompt、スタイル、品質、残高を確認します。
1回だけ作成
Create token は1回だけ。Idempotency Key が受理済み送信を保護します。
状態を読む
Queued は待機、Processing は処理中、Completed は利用可能、Partial failed は一部成功です。
別作業を続ける
パネルを閉じてもサーバー処理は継続し、Bridge は10秒ごとに確認します。
表示時のみキャンセル
Cancel は未取得の queued Bridge job のみ表示。開始後は完了を待ちます。
重要: 外部プロバイダーがタスクを取得した後は安全にキャンセルできません。まだ取得されていない queued タスクだけがキャンセル可能です。
7. 新旧の生成結果を使う
接続アカウントの最新50件を表示し、Web Forge の履歴も含みます。
作成元
Foundry は Bridge、Website は folosa.com で作成したタスクです。
自動インポート
新しい Bridge job だけ自動対象です。Web 履歴を一括で取り込みません。
手動インポート
Import はサイズと SHA-256 を検証し、Foundry Data に保存して Actor を作成します。
Actor を開く
Open Actor で既存 Actor を開き、Scene に再利用できます。
削除済み Actor の復元
Refresh 後に Import が戻り、再生成や再課金なしで復元します。
8. Actor を実際に使う
job ごとに固定フォルダーへ保存し、動画 Token と portrait を分離します。
保存場所
Data/folosa/tokens/<job-id>。Actor が参照中は移動や名称変更をしません。
Actor 確認
PNG portrait と Prototype Token の WebM を確認し、system 固有データを入力します。
Scene テスト
小さな Scene に置き、透明度、loop、scale、performance を確認します。
再利用
同じ Actor を複数 Scene で使い、能力値が異なる場合だけ複製します。
9. クレジット、決済、セキュリティ
アカウントは短時間 handoff で開き、認証情報を決済 URL に含めません。
クレジット購入
Credits からアカウントと checkout を開き、メールと商品を確認。完了後に Refresh を1回使います。
キーの更新
漏えいの可能性があれば Rotate key で旧キーを無効にして交換します。
切断
Disconnect は現在の認証を無効にしますが、job、asset、Actor は削除しません。
共有端末
利用者交代前に切断し、キーを chat、ticket、macro、screenshot に載せません。
10. トラブルシューティング
表を上から確認し、最初のタスクの受理状態が分かるまで再送しません。
| 症状 | 確認項目 | 解決方法 |
|---|---|---|
| 接続できない | 承認ページ、メール、コード期限を確認。 | 新しい接続を開始して新コードを承認します。 |
| 401 または認証無効 | ローテーション、取消、profile 間コピーを確認。 | 切断して再接続し、1 profile に1認証を使います。 |
| 残高が古い | 同じメールで checkout が完了したか確認。 | Refresh を1回使い、アカウント取引を確認します。 |
| Queued が長い | job ID と時刻を保存し、複製しない。 | 待機、または Cancel 表示時のみ取消。異常なら support。 |
| Processing が数分 | 外部 provider が処理中。 | 待機します。パネルを閉じても安全ですが再送はしません。 |
| Completed だが Import 失敗 | GM 権限、Data 書込、空き容量、console。 | 権限を直し、Refresh 後に再 Import。再課金なし。 |
| Actor はあるが動画が空 | WebM path、対応、pause、hardware。 | Actor で path を確認し、小さな未停止 Scene で Standard VTT をテスト。 |
| 古い Web job がない | 接続メールと最新50件の範囲。 | Refresh。さらに古いものは Folosa アカウント履歴から手動取得。 |
11. セッション前チェック
ライブプレイ前の短い受け入れ確認です。
アカウント
正しいメールで接続し、残高が最新。
タスク
Completed または Partial failed で、送信は1件だけ。
ファイル
Actor、PNG、WebM が正常。
Scene
プレイヤー端末で透明、scale、loop、performance を確認。
サポート
job ID、時刻、モード、品質、画像、説明を送り、認証情報は送らない。