TRELLIS Blender Plugin

TRELLIS & TRELLIS.2 Blender アドオン

更新：TRELLIS.2 のサポートを追加

TRELLIS と TRELLIS2 の 3D 生成機能を Blender に統合するアドオンです。

機能

TRELLIS

• テキストから 3D：テキストからテクスチャ付き 3D メッシュをネイティブに生成
• 画像から 3D：単一の RGB 画像からテクスチャ付き 3D メッシュをネイティブに生成
• テキスト条件付きディテールのバリエーション：テキストを指定してメッシュのテクスチャを生成
• 画像条件付きディテールのバリエーション：単一の RGB 画像を指定してメッシュのテクスチャを生成

TRELLIS2

• テキストから 3D：テキストからテクスチャ付き 3D メッシュを生成（z-image-turbo を使用して t2i を行い、その後 trellis.2 を使用して image2mesh を行います）
• 画像から 3D：単一の RGB 画像からテクスチャ付き 3D メッシュをネイティブに生成（ネイティブの trellis.2）

MCP 統合

MCP と統合されており、Cursor／Windsurf と通信できます。Trellis MCP を参照してください。

インストール

要件

• Blender 3.6.0 以降
• [オプション1] TRELLIS API サーバーを起動していること（my TreLLIS fork を参照）
• [オプション2] TRELLIS.2 API サーバーを起動していること（my TreLLIS.2 fork を参照）

両方のサーバーを起動し、Blender アドオンでバックエンドを切り替えることもできます。

プラグインを有効にする

1. プラグインファイルをダウンロードします（このリポジトリをクローンします）
2. Blender で「編集」>「プリファレンス」>「アドオン」を開きます
3. 「インストール」をクリックして、trellis_for_blender.py ファイルを選択します
4. 「3D View: TRELLIS」の横にあるチェックボックスをオンにして、アドオンを有効にします

ネイティブのワークフロー

1. パネルにアクセスします（3D ビューポートを開き、n キーを押してサイドバーを開きます）。TRELLIS を見つけます。
2. （任意）シーン内のオブジェクトを選択し、条件付き入力として画像を選択します。
3. 生成パラメーターを調整します（経験上、ステップ数は少なめでも使用できます）。
4. プラグインは、オブジェクト（選択されている場合）と画像／テキストの両方を API バックエンドにアップロードします。
5. 完了すると、モデルをダウンロードしてシーンにインポートできます。

メインパネルで過去のリクエストを確認できます。

MCP ワークフロー

1. パネルにアクセスします（3D ビューポートを開き、n キーを押してサイドバーを開きます）。TRELLIS を見つけて、Start MCP Server をクリックします。
2. Claude／Cursor／Windsurf を開き、以下の設定を貼り付けます：

"mcpServers": {
        "trellis": {
            "command": "uvx",
            "args": [
                "trellis-mcp"
            ]
        }
    }

生成パラメーター

• スパース構造の設定
  • サンプルステップ数（構造拡散のサンプリングステップ数。デフォルトは 12）
  • CFG 強度（classifier-free-guidance。デフォルトは 7.5。値を大きくすると入力画像への適合度が高くなります）
• 構造化潜在表現の設定
  • サンプルステップ数（SLAT 拡散のサンプリングステップ数。デフォルトは 12）
  • CFG 強度（classifier-free-guidance。デフォルトは 7.5。値を大きくすると入力画像への適合度が高くなります）
• メッシュの後処理オプション
  • 簡略化率（削除する三角形の数。デフォルトは 0.95）
  • テクスチャサイズ（デフォルトは 1024。品質を高めるには 2048 に設定できますが、処理に時間がかかります）
  • テクスチャベイクモード（'fast' または 'opt'。'opt' は時間がかかる場合がありますが、品質が高くなります）

問題の報告、議論、貢献を歓迎します！