Houdini Engine 1.9
 All Classes Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Unity

Installation

Windows

Minimum Requirements:

  • Windows Vista
  • Unity 4.5
  • Houdini or Houdini Engine 13.0

Recommended Requirements:

  • Windows 7
  • Unity 5.0 64-bit
  • Houdini or Houdini Engine 14.0
Note
If you install the 32-bit version of Unity, either because you cannot upgrade to Unity 5 or because you have other plugins that only support 32-bit, you will need to make sure you also install the 32-bit version of Houdini.
Also, the regular Houdini installer includes Houdini Engine. You do not need to install both Houdini and Houdini Engine. You should only really install Houdini Engine (via the houdini-engine-X.Y.Z.winB.vc11.exe) if you only want Houdini Engine functionality and do not need to use Houdini itself or you only have a Houdini Engine license.

Fastest way to get the plugin working inside your Unity project:

  1. Download and launch the houdini-X.Y.Z-win64-vc11.exe installer, where X.Y.Z is the version of Houdini.
  2. Follow the steps and make sure to select the Houdini Engine for Unity 5.0 64-bit option on the Houdini Engine installer screen.
  3. Install/launch Unity with a Unity project you wish to use Houdini Engine on.
  4. In Unity, go to Assets > Import Package > Custom Package...
  5. Navigate to
    C:\Users\Public\Public Documents\Unity Projects\Houdini_Engine_Project_X.Y.Z
    where X.Y.Z is the version of Houdini you just installed.
  6. Select the houdini-engine.scripts.unitypackage file for import and import everything inside.
  7. You should see the Houdini Engine menu in the top menu bar but just to be safe, restart Unity.

Mac OSX

Minimum Requirements:

  • OSX 10.9
  • Unity 5.0 64-bit
  • Houdini or Houdini Enigne 14.0
Warning
To re-iterate the minimum requirements above, if you want to use the plugin on Mac OSX you must install the 64-bit version of Unity.

Fastest way to get the plugin working inside your Unity project:

  1. Download and launch the houdini-X.Y.Z-macosx_x86_64_clang5.1_10.9.dmg installer, where X.Y.Z is the version of Houdini.
  2. Follow the steps and make sure to select the Houdini Engine for Unity 5.0 64-bit option.
  3. Install/launch Unity with a Unity project you wish to use Houdini Engine on.
  4. In Unity, go to Assets > Import Package > Custom Package...
  5. Navigate to
    Users/Shared/Unity/Houdini_Engine_Project_X.Y.Z
    where X.Y.Z is the version of Houdini you just installed.
  6. Select the houdini-engine.scripts.unitypackage file for import and import everything inside.
  7. You should see the Houdini Engine menu in the top menu bar but just to be save, restart Unity.

Sample Assets

  • There are sample assets alongside the .unitypackage. If you want to use them you'll need to copy the Assets/OTLs and Assets/Resources folders into your own Assets/... Unity project directory.
  • You can also open a new Unity project right inside the C:\Users\Public\Public Documents\Unity Projects\Houdini_Engine_Project_X.Y.Z folder. Doing so will automatically include the Houdini Engine plugin as well as the sample Houdini assets.

Troubleshooting

  • If you don't find the .unitypackage file or the sample assets in the Public Documents/Shared folder there is also a copy in the Houdini installation directory, under engine/unity. For example, if Houdini was installed in the default location on Windows in: C:\Program Files (x86)\Side Effects Software\Houdini X.Y.Z, the Unity plugin files will be in: C:\Program Files (x86)\Side Effects Software\Houdini X.Y.Z\engine\unity. The same applies to Mac OSX.
  • If you do not find the .unitypackage file at all but you do find the Assets folder in the Public Documents/Shared folder you can still import the plugin scripts into your own project by copying the contents of the Assets folder into the root of your project.
  • If you see the error System.DllNotFoundException: libHAPI, first make sure to:
    • Check that you installed the correct bitness of Houdini given the version of Unity you have running. See above instructions.
    • Check that your system PATH environment variable does not contain any other Houdini installations.
    • Check that you do not have the environment variable HAPI_PATH defined.
    • Check that the path of the correct version of Houdini shows up in the new PATH definition printed in the Unity console at load time.
    • If all else fails, and on Windows, try this:
      1. Copy the OpenCL.dll, jpeg.dll, iconv.dll, and intl.dll files from the Houdini bin folder (in the install directory).
      2. Paste them beside Unity.exe in Unity's install directory (in the Editor folder).
      3. Restart Unity and try again.