コネクター

コネクターをインストールすると、エージェントが1つのアプリ内で作業できるようになります。コネクターの中には、Blenderのようにコンピューターごとに1回だけインストールするものもあれば、Unity、Godot、Unreal Engineのようにプロジェクトごとに1回インストールするものもあります。

概要

コネクターは、Meshy DCC Coreウィンドウ（meshy-dcc ui）のConnectorsページからインストールするか、エージェントにインストールを依頼してください。Meshy DCC Coreは、何かをインストールする前にすべてのダウンロードをSHA-256チェックサムで照合します。

次の表は、各コネクターがどこにインストールされるか、またどのバージョンのアプリをサポートしているかを示しています。

3ds MaxはWindowsでのみ動作しますが、それ以外のすべてのコネクターはmacOS（Apple Silicon）とWindows x64で動作します。

Blender

Blenderコネクターをインストールするには、次の手順に従ってください。

1. Connectorsで、Blenderの横にあるInstallをクリックします。
2. Blenderが開いている場合は再起動するか、いつも通りに起動します。

Meshy DCC Coreは、通常の場所（macOSでは/Applications/Blender.app、WindowsではC:\Program Files\Blender Foundation）でBlenderを探します。Blenderが別の場所にある場合や複数のコピーがある場合、ウィンドウが場所を尋ねます。使用したいアプリの完全なパスを入力してください。例：/Applications/Blender 4.5.app。

このコネクターはMeshy DCCという名前のBlender拡張機能です。Blenderと一緒に起動するため、開いているすべてのBlenderがConnected nowの下に表示されます。

ターミナルからインストールするには、次を実行します。

meshy-dcc install --dcc-type blender --execute

Blenderが通常の場所にない場合は、--dcc-path <path to Blender>を追加してください。

Unity

プロジェクトにUnityコネクターをインストールするには、次の手順に従ってください。

1. Unityでプロジェクトを閉じます。
2. Connectorsで、Unityの横にあるAdd to a projectをクリックし、プロジェクトフォルダーの完全なパスを入力してInstallをクリックします。
3. いつも通りUnityでプロジェクトを開きます。

このコネクターは、プロジェクトにMeshy DCC Unityパッケージと.meshy-dccフォルダーを追加します。プロジェクトのProjectSettings/ProjectVersion.txtが指定するUnity Editorのバージョンを使用するため、そのバージョンがUnity Hubにインストールされている必要があります。

meshy-dcc install --dcc-type unity --project /path/to/project --execute

Godot

プロジェクトにGodotコネクターをインストールするには、次の手順に従ってください。

1. Godotでプロジェクトを閉じます。
2. Connectorsで、Godotの横にあるAdd to a projectをクリックし、プロジェクトフォルダーの完全なパスを入力してInstallをクリックします。
3. いつも通りGodotでプロジェクトを開きます。

このコネクターはaddons/meshy_dcc_godotアドオンを追加して有効にし、.meshy-dccフォルダーを追加します。PATH上のGodot、または/Applications内のGodot.appを探します。別の場所にある場合、またはWindowsでは常に、MESHY_DCC_GODOT_EXECUTABLE環境変数をGodotエディターに設定してください。

meshy-dcc install --dcc-type godot --project /path/to/project --execute

Unreal Engine

プロジェクトにUnreal Engineコネクターをインストールするには、次の手順に従ってください。

1. Unreal Engineでプロジェクトを閉じます。
2. Connectorsで、Unreal Engineの横にあるAdd to a projectをクリックし、.uprojectファイルがあるフォルダーを入力してInstallをクリックします。
3. いつも通りプロジェクトを開きます。

このコネクターは、プラグインをプロジェクトのPlugins/MeshyDccUnrealフォルダーにコピーし、お使いのエンジンでビルドします。これには数秒から数分かかります。ビルドには以下が必要です。

• macOS: エンジンが受け入れるバージョンのXcode。Unreal Engine 5.7はXcode 26までを受け入れます。
• Windows: Game development with C++ ワークロードを含むVisual Studio 2022。

Windowsでは、パスに英字、数字、句読点のみを含むフォルダーにプロジェクトを配置してください。Unreal Engineはそれ以外の文字の下ではプラグインをビルドできないため、インストールは停止してロールバックされます。

このコネクターは、Epic Games Launcherでプロジェクトのエンジンバージョンに一致するエンジンを使用します。ソースビルドや別の場所を使用する場合は、MESHY_DCC_UNREAL_ENGINEをエンジンフォルダーに設定してください。Unreal Engine 4はサポートされていません。

meshy-dcc install --dcc-type unreal --project /path/to/project --execute

その他のアプリ

これらのコネクターは、Connectorsから、またはmeshy-dcc install --dcc-type <app> --project <folder> --executeで、同じ方法でインストールされます。

• OpenSCAD: このコネクターはプロジェクトフォルダー内の.scadファイルに対して動作し、エクスポートとプレビューのたびにOpenSCADを実行するため、OpenSCADウィンドウは開きません。Meshyモデルを印刷ベースの上に立てて、STLまたは3MFとしてエクスポートできます。Apple Siliconでは、OpenSCADの開発スナップショットが必要です。
• Material Maker: このコネクターはフォルダー内でマテリアルグラフを構築・編集し、Blender、Godot、Unity、Unreal Engine向けのPBRテクスチャセットをエクスポートします。各エクスポート時に、Material Makerが一時的に前面に表示されます。このコネクターは開いているMaterial Makerウィンドウではなく、グラフファイルに対して動作します。エージェントがグラフを変更する前にMaterial Maker内でグラフを閉じ、完了したら結果を開くようエージェントに依頼してください。
• FreeCAD: このコネクターはプロジェクトフォルダー内のドキュメントに対して動作し、各ステップでバックグラウンドでFreeCADを実行します。MeshyのGLBモデルは、STEP、IGES、STL、OBJと並んでメッシュとしてインポートされます。
• Roblox Studio: 1つのプレイスファイル（.rbxlまたは.rbxlx）を含むフォルダーを選択してください。このコネクターはStudioプラグインを追加し、プレイスを開きます。Robloxはモデルをプレイスと一緒に保存しないため、Meshyからのモデルはそのスタジオセッションの間だけ保持されます。Meshy DCCツールバーでAllow Luauをクリックするまで、Luauの実行はオフのままです。

プロフェッショナルアプリ

• Houdini: Houdiniのバージョンごとに1回、Houdiniの環境設定にHoudiniパッケージとしてインストールされます。HOME変数が設定されている場合、Houdiniはそこから環境設定フォルダーを選びます。
• Maya: コンピューターごとに1回、Mayaモジュールとしてインストールされます。MeshyのFBXモデルは、Standard Surfaceマテリアルとそのテクスチャマップを伴って取り込まれます。
• 3ds Max（Windows）: 3ds Maxのバージョンごとに1回、起動スクリプトとしてインストールされます。MeshyのFBXモデルは、Physicalマテリアルを伴って取り込まれます。
• Substance 3D Painter: コンピューターごとに1回、起動時プラグインとしてインストールされます。エージェントはMeshyモデルからプロジェクトを開始し、PBRレイヤーを追加し、テクスチャをエクスポートできます。
• ZBrush: プロジェクトフォルダーを選択してください。エージェントは、自分で開いたZBrushではなく、Meshy DCC Coreがそのフォルダー用に起動したZBrushで作業します。最初の起動がタイムアウトした場合は、再度起動してください。

複数のアプリを同時に使用する

開いているすべてのアプリ、および開いているアプリのすべてのコピーは、それぞれ独自のIDを持つ個別のインスタンスです。エージェントは、自分が作業しているインスタンスの名前を把握しています。複数のインスタンスがリクエストに当てはまる場合、エージェントはどちらを指しているか尋ねます。アプリを再起動すると新しいIDが割り当てられますが、エージェントは再びそれを見つけ出します。

コネクターをアンインストールする

最も簡単な方法は、エージェントに依頼することです。自分でコネクターをアンインストールするには、次のいずれかを行ってください。

• Blender: Edit > Preferences > Get ExtensionsでMeshy DCCを見つけ、アンインストールします。
• Unity: Package ManagerでMeshy DCC Unityパッケージを削除し、プロジェクトの.meshy-dccフォルダーを削除します。
• Godot: プロジェクトからaddons/meshy_dcc_godotと.meshy-dccを削除します。
• Unreal Engine: プロジェクトからPlugins/MeshyDccUnrealと.meshy-dccを削除します。
• その他のアプリ: エージェントに依頼してください。各コネクターが追加したファイルを把握しており、削除する前にそれらを一覧表示します。