scenario-labs/blender-plugin

Scenario for Blender – Blender 内での AI 駆動コンテンツ生成

概要 – 3D オーサリング環境から直接 Scenario のクラウド AI サービスを呼び出せる Blender アドオン（Python 拡張機能）です。自然言語プロンプトや参照アセットから、画像、動画、3D メッシュ、PBR マテリアル、オーディオ、360° 環境、さらにはブロックアウトレイアウト全体を生成し、結果を現在の Blender シーンにインポートできます。

主な機能

• 画像・動画生成 – テキストプロンプトや参照画像を、テクスチャ、背景プレート、またはフルレングスの動画クリップに変換します。
• 3D メッシュの作成と編集 – AI に新しいジオメトリの作成や選択メッシュへの編集を依頼し、編集後のメッシュを Blender に取り込みます。
• マテリアル合成 – 完全な PBR テクスチャセットを生成し、マテリアルスロットに自動的に割り当てます。
• オーディオ合成 – 音声、音楽、効果音を生成し、ビデオシーケンサーに配置します。
• レンダリング支援生成 – シーンキャプチャ（静止画または動画）を視覚的な手がかりとして使用し、AI が一致するアセットを生成します。
• ブロックアウトツール – 短いシーン説明を提供すると、さらに洗練できるグレーボックスレイアウトを受け取ります。
• 環境作成 – HDRI パノラマまたは拡大された 360° 背景を生成し、ワールドに適用します。
• スタジオビューとフローティングコンポーザー – ビューポートから離れることなく上記の「レーン」を実行できる UI パネル。
• MCP エージェント – ローカルの scenario-blender サーバーがシーンを外部エージェント（例：Claude Code、Cursor）に公開し、シーンを読み取って有料の AI 作業を依頼できます。サーバーは http://127.0.0.1:9876/mcp で実行され、blender --background … --command scenario_blender を使用してヘッドレスでも使用できます。

入手方法

1. Blender でオンラインアクセスを有効にします（編集 → 環境設定 → システム → ネットワーク）。
2. 編集 → 環境設定 → 拡張機能を取得 → リモートリポジトリを追加 からリモートリポジトリ https://blender.scenario.com/repo/index.json を追加します。
3. リストから「Scenario」をインストールします。アドオンは 環境設定 → アドオン に表示されます。
4. Scenario の API キー/シークレット（Scenario ウェブコンソールから取得）をアドオンの認証情報パネルに貼り付け、接続をテストします。
5. 出力フォルダーを選択します。生成されたアセットはそこに保存され、生成パネルにも表示されます。

（GitHub リリースページから ZIP をダウンロードして手動でインストールすることもできますが、そのコピーは自動更新されません。）

一般的なワークフロー

1. Scenario サイドバーを開きます（ビューポートで N）。
2. レーン（画像、3D、オーディオなど）を選択し、プロンプトを書き、参照ファイルを添付し、コスト見積もりを確認します（Scenario は クリエイティブユニット を請求します）。
3. 生成 をクリックします – アドオンがリクエストを api.cloud.scenario.com に送信し、結果を受け取り、ローカルに保存します。
4. 提供されたアクションを使用してアセットをインポートします（例：生成されたテクスチャの適用、メッシュの追加、オーディオのシーケンサーへの配置）。
5. 反復または複数のレーンを組み合わせて、完全なシーンを構築します。

制限と注意事項

• 有料の Scenario アカウントが必要です。各生成でクレジット（クリエイティブユニット）が消費されます。
• すべてのプロンプト、パラメータ、参照ファイルは生成前に Scenario のクラウドサービスに送信されます。プライバシーの詳細はリポジトリの PRIVACY.md にあります。
• アドオンは 実験的 とマークされています – 一部のレーンは利用できないか、特定の Blender バージョンで機能が制限される場合があります。
• エージェント（MCP）は、オプトインすると任意の Python を実行でき、セキュリティリスクがあります。デフォルトでは無効です。
• オフライン ZIP インストールは自動更新されません。新機能やバグ修正を得るには再インストールが必要です。

ライセンス – 拡張機能コードは GPL-3.0-or-later でリリースされています（Blender アドオンに必須）。バンドルされた SDK ホイールは元のライセンスを保持します。詳細は LICENSE、SDK_BUNDLE.md、TRADEMARKS.md を参照してください。

詳細情報

• ユーザーガイド：docs/USER_GUIDE.md（各レーン、コストプレビュー、出力処理をカバー）。
• API ドキュメント：https://docs.scenario.com。
• MCP プロトコルリファレンス：docs/MCP.md。
• サポート：リポジトリの サポート ページから問題を開くか、support@scenario.com にメールしてください（資格情報を公開しないでください）。

---

Scenario for Blender は、生成 AI を 3D 作成ループに直接もたらし、アーティストが Blender から離れることなく、アセット、環境、さらにはシーン全体をプロトタイプできるようにします。