This covers how to create an empty HoudiniTools Package and populate it with HDAs.

1. In Houdini Engine, select Houdini Tools.

   • A pop-up window appears for Houdini Tools

2. In the top right, select the gear icon and then select Create HoudiniTools package.

3. Enter a name for your new package (ex. MyHoudiniTools) and change the category name to My Houdini Tools.

4. Select Create.

This creates a new directory at /Game/HoudiniEngine/Tools/MyHoudiniTools and creates a new HoudiniToolsPackage asset inside this directory.

You can now import new HDAs into this folder, or drag HDAs from another location in your Content Browser. Any HDAs placed in this folder (or a subfolder) appears in the HoudiniTools Panel under the categories defined by this package. The category name for this package will be My Houdini Tools, as specified in the previous step.

Double-click LMB on the HoudiniToolsPackage asset to access its properties and further configure its categories, if needed. By default, a HoudiniToolsPackage asset will have importing and exporting disabled for descriptor data meaning that external description data will not be imported when an HDA is reimported, nor will description data be exported when a HoudiniAsset is saved.

You can further organize the HDAs (and Presets) in this Package into subfolders and configure categories to match each subfolder seperately. The following example organizes the HDAs into a (MyTools) Deform category and a (MyTools) Destruction category. The he_geo_bend and he_geo_melt HDAs have been placed in a Deform subfolder. The he_geo_edgewear HDA has been placed in a Destruction subfolder.

The HoudiniToolsPackage asset have been configured with the following settings for the Categories property:

The resulting categories look like this:

These are three common workflows for managing HDAs and Packages in your Unreal project, depending on your project’s worfklow requirements.

See HoudiniTools Package and Description Data for more information.

Unreal-only ¶

In this workflow, you only want to manage HDAs inside of Unreal. You can assign custom icons, edit the HDA label, HDA description, etc., through the Edit Tool Properties panel. You are not importing or exporting to/from an external package directory structure. These are the default settings in the HoudiniToolsPackage

Import-only ¶

In this workflow, you are maintaining the HoudiniToolsPackage JSON data, HDA JSON data, and HDA icons in an external location such as a version-controlled repository. The external JSON data serves as the ground-truth for our HDAs and Package information. The HoudiniToolsPackage asset in Unreal will be configured to always import the external JSON descriptions and cache it on the respective HoudiniAssets in Unreal. This overwirtes any changes to HDA labels, descriptions, icons, Package categories, category filters, etc. a user might have made inside Unreal.

• Select the checkbox for:

  • Reimport Package Description

  • Reimport Tools Description

Note

External icons and JSON data will only be imported when the HDA or HoudiniToolsPackages assets are imported/reimported (if allowed by the owning Package settings).

Export-only ¶

In this workflow, you maintain the HoudiniToolsPackage JSON data, HDA JSON data, and HDA icons inside Unreal and want to propagate any changes inside the Unreal project to an external location location, such as a version controlled repository. The assets inside Unreal serve as the ground-truth for our HDAs and Package information. The HoudiniToolsPackage asset in Unreal will be configured to always export the asset data to external JSON description files whenever an asset or the Package asset itself is saved.

• Select the checkbox for:

  • Export Package Description

  • Export Tools Description

Note

External JSON data will only be exported when the HDA or HoudiniToolsPackages assets are saved (if allowed by the owning Package settings).