Houdini 20.5 Unity

Install Houdini Engine for Unity

How to install Houdini Engine for Unity

On this page

The Houdini Engine is officially supported on Windows and macOS. You can unoficially install Houdini Engine using Linux.

Minimum Requirements:

Installing Houdini Engine

These instructions are for both Windows and MacOS.

Windows

Mac

  1. Install the launcher if not already installed.

  2. Open the launcher.

  3. Select Houdini ▸ Install. If you are not already logged in the web browser will pop open asking you to login to your SideFX account. The launcher will move to the front once the login process has completed.

  4. In the Choose a Version to Install select either Production Build or Daily Build depending on your desired build version. If you need to select a specific version then select Choose Another Version and install the version desired.

  5. In the Preferences pop-up window, turn on Unity Plug-in and click install.

  6. In Unity, from the main menu select Assets ▸ Import Package ▸ Custom Package.

  7. Select the HoudiniEngineUnity.unitypackage. The default location is \Side Effects Software\Houdini Engine\Unity\X.Y.Z.

    • X.Y.Z means your Houdini Version.

  8. Select Import.

    • It should install the plug-in into your project’s folder Assets/Plugins/HoudiniEngineUnity.

  9. Restart Unity.

Linux

  1. Install the launcher if not already installed.

  2. Open the launcher.

  3. Select Houdini ▸ Install. If you are not already logged in the web browser will pop open asking you to login to your SideFX account. The launcher will move to the front once the login process has completed.

  4. In the Choose a Version to Install select either Production Build or Daily Build depending on your desired build version. If you need to select a specific version then select Choose Another Version and install the version desired.

  5. In the Preferences pop-up window, turn on Unity Plug-in and click install.

  6. Create a Plugins folder in your Unity project’s Assets folder.

  7. Copy the HoudiniEngineUnity folder into your project’s Assets/Plugins folder.

    • The default location is \Side Effects Software\Houdini Engine\Unity\X.Y.Z. X.Y.Z means your Houdini Version.

  8. Open Unity, the content should automatically import the necessary files.

    • Make sure to delete the previous Assets/Plugins/HoudiniEngineUnity folder.

  9. Restart Unity.

Verify plug-in in Unity

Once you install the Houdini Engine, verify the plug-in is loaded properly.

  1. # In the Main Menu, you can see Houdini Engine as a new item.

  2. Select HoudiniEngine ▸ New Node ▸ Curve.

If successfully installed, a new GameObject will be created in the Hierarchy window and automatically selected. The Scene window will display the new Curve Editor, and the Inspector will display the new interface for working with HDAs. See image below:

Troubleshooting

If there’s no HoudiniEngine in the main menu or the curve doesn’t create, check the Unity Console Window located in Window ▸ Panel ▸ Console for any errors and log messages.

Errors about not finding Houdini or Houdini Engine installation or version mismatch:

  • Check the correct version of Houdini or Houdini Engine is installed.

  • If the Houdini or plug-in folder has moved at any point, t he plug-in won’t be able to connect with Houdini.

  • Delete the Assets/Plugins/HoudiniEngineUnity folder, reinstall Houdini, then restart Unity, and finally reimport the plug-in package from the instructions.

Errors about sessions issues and there’s correct version of Houdini and Houdini Engine.

  • Restart the sesssion from the main menu in HoudiniEngine ▸ Session ▸ Restart Session.

Upgrading the Plugin

If you have an older version of the plug-in in your Unity project, it’s recommended to have a clean upgrade:

  1. Close Unity.

  2. Re-open unity and open a new empty scene

    • A non-empty scene might cause asset references to be lost when upgrading

  3. Delete the folder within your project Assets/Plugins/HoudiniEngineUnity

  4. Shut down Unity (this ensures that any Houdini Engine sessions are closed)

  5. Re-open Unity and open a new empty scene (note: a non-empty scene might cause asset references to be lost when upgrading)

  6. Delete the following folder from within Unity: Assets/Plugins/HoudiniEngineUnity

  7. From the main menu select Assets ▸ Import Package ▸ Custom Package.

  8. Select the HoudiniEngineUnity.unitypackage. The default location is \Side Effects Software\Houdini Engine\Unity\X.Y.Z.

    • X.Y.Z means your Houdini Version.

  9. Select Import.

    • It should install the plug-in into your project’s folder Assets/Plugins/HoudiniEngineUnity.

  10. Restart Unity.

Unity

Getting started

Project Setup

Using Houdini Engine

Reference