-- 重要 --- 

最新の SideFX Labs for Unreal Plugin を実行するにはバイナリが必要です。プリコンパイル済み（事前コンパイル済み）のバイナリを含むプラグインは、プロダクションリリース（Production Release）でのみ提供されており、以下のリンクからダウンロードできます。 

https://github.com/sideeffects/SideFXLabs/releases

SideFX LabsのプロダクションリリースとHoudini本体のプロダクションビルドは異なります。
2026年1月28日現在、SideFX Labsの最新プロダクションリリースは21.0.512となります。

https://github.com/sideeffects/SideFXLabs/releases/tag/21.0.512

あるいは、ご自身でプラグインをビルドすることも可能です（後述の「ソースからのビルド」セクションを参照）。

1. 

Unrealプロジェクトのディレクトリにある Content フォルダの隣に、Plugins というフォルダがあることを確認してください。もし Plugins フォルダがない場合は、新規作成してください。（プロジェクトディレクトリとは、.uproject ファイルがある場所のことです。）

代替のインストール場所

プロジェクトファイルは共有またはバージョン管理（ソースコントロール）されているが、エンジンファイル自体は管理されていないチーム環境で作業している場合は、上記のようにプロジェクトディレクトリへのインストールを推奨します。

また、別の方法として、エンジンのディレクトリにプラグインをインストールすることも可能です。 例: C:\Program Files\Epic Games\UE_5.0\Engine\Plugins\FX\ <ここに SideFX_Labs フォルダを貼り付け>

個人で複数の異なるプロジェクトを扱っている場合は、この方法の方が便利かもしれません。

バイナリを含まない、または必要としないレガシー（旧）バージョンを使用したい場合は、そのまま ステップ4 へ進んでください。

2.

使用したいプロダクションリリース（Production Release）をGithubにて見つけてください。「Assets」の下にある SideFXLabs-H**.*.***.zip という名前のファイルをダウンロードします。ダウンロード完了後、ファイルを解凍すると「SideFX Labs Package」が展開されます。パッケージ内の /unreal/<Unreal version>/ ディレクトリに、特定のUnrealバージョン向けのプラグインが入っています。

※プロダクションリリースのみ実行するにはバイナリが入っています。pre-release版はバイナリをビルドする必要があります。

3.

 使用しているOSのフォルダ（Mac または Win64）の中にある SideFX_Labs フォルダをコピーし、その後 ステップ5 へ進んでください。

4. （レガシー版を使用する場合）

Legacy フォルダの中にある SideFX_Labs フォルダをコピーしてください。

5. 

コピーした SideFX_Labs フォルダを、ステップ1で用意した Plugins フォルダの中に貼り付けてください。

6. 

これでプラグインがプロジェクトにインストールされました。Unrealプロジェクトを起動すると、プラグインが提供するマテリアル関数（Material Functions）やスクリプト化されたアクション（Scripted Actions）などがすぐに使用できるはずです。

プロジェクトを開いた状態で、メニューの [Edit] > [Plugins] から "SideFX Labs" を検索することで、プラグインが正常に有効化されているか確認できます。

ソースからのビルド (Building From Source)

SideFX Labsのプロダクションリリース以外ではバイナリファイルがありません。下記を参考にバイナリファイルをビルドしてください。

1. Houdini Launcher を開き、「Command Line Tools」を起動します。これは、「Houdini Versions」セクションにある任意のHoudiniバージョンの、歯車アイコンの右、Launchボタンの左にあるドロップダウン矢印をクリックすると見つかります。

2. ターミナルが開いたら、以下のコマンドを入力します。 hython path/to/builder.py （※ builder.py スクリプトは、このインストールガイド（Plugin Installation Guide.txt）と同じフォルダにあります。）

3. 「Unreal Build Tool」ウィンドウが表示されたら、各パラメータを入力して「Start Build」ボタンをクリックしてください。

• Build Platform: プラグインをビルドする対象のプラットフォーム。

• Build Script: Unrealのビルドスクリプトへのパス。Windowsでは .bat ファイル、Linux/Macでは .sh ファイルになります。これらのファイルはUnreal Engineインストールディレクトリ内の Engine/Build/BatchFiles/ にあります。

• Plugin File: SideFXLabsフォルダ内にある .uplugin ファイルへのパス。

• Build Path: ビルドされたプラグインが出力されるディレクトリへのパス。

   

エラーによりbuilder.pyからビルドできない場合は、RunUAT.bat を直接使用することが可能です。

Unreal Engineには、プラグインをパッケージ化するための標準バッチファイル RunUAT.bat が用意されています。これを使えば確実にビルドできます。

手順

1. コマンドプロンプト（cmd.exe） を起動します。

2. 以下のコマンドをコピーして、ご自身の環境に合わせてパスを書き換えて実行してください。 ※ 特に <UEのインストール場所> の部分は、実際のEngineフォルダの場所に書き換えてください。

"C:\Program Files\Epic Games\UE_5.X\Engine\Build\BatchFiles\RunUAT.bat" BuildPlugin -Plugin="path/to/SideFX_Labs.uplugin" -Package="出力先ディレクトリを指定" -TargetPlatforms=Win64 -Rocket

終了すると、-packageで指定した場所日binaryフォルダ（その他プラグインに必要はフォルダと合わせて）が作成されています。このbinaryフォルダごとPluginsフォルダ内のSideFX_Labs フォルダに保存して下さい。