Asset importing

Attention

Please make sure you have read these guides before continuing here

Addon Configuration:

[Open]

Project Setup:

[Open]

Tip

All importers print a progress bar to the console, which can help estimate how long the import is going to take until completion!

Materials

Materials are stored in .material files, and accompanied by .texset and .texture files in Hedgehog engine 1 games.

Usually, materials are automatically imported as part of a model or similar, but if you just want to edit one or multiple material files, you can do so by importing them directly.

How to import .material files

If you just want to import materials into your project without automatically adding them to any model open the importer, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_material_1.png

Where to find the importer

How to import .material files and add to a model

To import materials to a specific object, first select the object that the materials should be imported to (must be a mesh), then open the importer from the specials, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_material_2.png

Where to find the importer

Texture images during import

Images are stored as .dds files.

Those used by materials can also be imported; If Import images has been disabled in the import properties, or an image file was not found / could not be read, the addon creates a 16x16 placeholder texture in its place based on the connection of the template material.

Models

Models are stored in .model files, and are imported as armatures with one or more meshes. Models consist of mesh units, each of which references a material by name. HEIO will try to import those automatically when importing models.

Usually models are imported standalone, but can also be part of a .pcmodel file.

How to import .model files

Open the importer, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_model.png

Where to find the importer

Terrain models

Terrain models, stored in .terrain-model files, are nearly identical to models, with only 3 differences:

  • They have no armature, and thus no weights

  • They have no morph models

  • They have an internal resource name and special flags

While they too can be imported standalone, they are usually part of .pcmodel files (HE2) or referenced by .terrain-instanceinfo files (HE1) (not yet supported)

How to import .terrain-model files

Open the importer, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_terrain_model.png

Where to find the importer

Collision meshes

Collision meshes, specifically HE2 bullet meshes, are stored in .btmesh files.

Collision meshes usually part of a .pcmodel file, but can also be imported standalone.

How to import .btmesh files

Open the importer, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_bulletmesh.png

Where to find the importer

Point Clouds

Point clouds are responsible for

  • Placing stage geometry (*.pcmodel)

  • Placing stage collisions (*.pccol)

  • Placing stage light (*.pclt) (not yet supported)

When imported, HEIO will also attempt to import the referenced resource files, such as

  • *.pcmodel: *.terrain-model, *.model

  • *.pccol: *.btmesh

  • *.pclt: *.light (not yet supported)

How to import .pcmodel / .pccol files

Open the importer, select your file(s) to import, configure the import properties and then confirm.

../_images/asset_importing_pointcloud.png

Where to find the importer