FAQ

I get error when enabling add-on

There are different causes for this, but usually one of below solutions fixes the issue:

  • Try Restarting Blender

    • sometimes it is all it takes

  • Make sure you are up-to-date

    • update Blender to the latest version
    • Update Hair Tool. If you can't run the addon, "auto-updater" won't work. In that case you will have to download update manually

  • I need to use old Blender

    • For Blender 3.3 up to 3.4 use currently hair_tool_2.46 - 25 June 2022

  • Remove Old hair_tool folder

    • sometimes old files from previous Hair Tool version may give trouble after update, if they are not removed (auto-updater deals with this automatically)
    • Hair Tool folder is placed in your addons directory
    • remove hair_tool folder from your ./addons/ directory
    • restart Blender
    • install Hair Tool again from zip file - this usually fixes installation problems

  • Conflict with another add-ons

    • If it still won't work, it is not often, but there may be conflict with another addon, or your blender setup may be corrupted.
    • Try this: Restart Blender > then use File menu -> Defaults -> Load Factory Settings -> enable Hair Tool now. If Hair Tool works now, then it means, that your old config was corrupted, or there was conflict with another addon
    • If above helped, then you may need to set up your blender config from scratch.

Greyed out parameters panel

Hair UV Go to Preferences -> System -> Enable 'Global Undo'. You may need to restart blender after saving settings. It looks like blender bug, and from time to time this option is disabled for no reason.

Hair UV operator can't be found in search menu

Since 2.24 version I added 'Hair UV' button to UV Image Editor header: Hair UV Unfortunately I'm not sure why this operator is missing from search menu for some people...

How do I export hair?

Hair generated in Hair Tool can be exported just like any other mesh (File > Export > FBX). Just make sure to Convert Curves to Mesh hair first.

How do I export hair texture?

If you are using default Hair Tool hair material, then it is using just one texture - alpha mask. You can export it from UV Editor (or Image Editor) > Image menu > Save as: Exporting Hair Texture

Note: Build-in HTool hair shader has complicated shader nodes setup, that allows them to look nice in Eevee. It is impossible to copy it to another game engines.

If you want to create more complicated setup, with multiple texture types, you should use Hair Baking scene, where you can set up you hair and bake them as images to target directory.

How do I animate Hair?

There is no one way to animate hair, but usually I recommend using simple softbody mesh as deformer for actual hair like it is shown in video below:

There is now built-in option to animate hair using Jiggle Bones see Animation

Error when using Curves from Grid surface

Make sure your source grid surface has proper topology. Examples of bad topology: Bad Grid Mesh

Note: First mesh is bad, because it has no subdivision. The last torus does not have any border edge that could be used as marker for roots of hair.

Examples of proper topology: Bad Grid Mesh

Note: Torus is ok, as long as you break one of loops, to create border edge.

How to assign UV to selected strand?

For selected strands you can use Set UV region

How do I change hair texture?

To change hair texture you first need to identify which material Hair Profile is using.

Hair System UI by default hair will receive material named HT_Defautl_Material

  1. Identify profile material, and open it in Shader editor (see yellow boxes below)
  2. Find texture node and change the hair texture, to any other image you want

Hair Texture Edit Remember to connect Vector input of texture node, to HTool_UV node - or texture won't be mapped correctly

Note: HTool default texture uses: RGB channels for depth pass, A channel for opacity. If you want to use different texture, make sure it has similar channels setup (or use two - depth and opacity - textures).

Note: If your texture layout is different, you may need to adjust UVs of Hair System. You can do it in UV Image Editor, by pressing Hair UV button see - Defining Hair UVs.

How do I change hair modeling tool hotkeys

Go to Edit menu → Preferences → Hotkeys and navigate to hair modeling category: hair model keys