Right now it's the same with some minor text changes but if I ever end up updating this guide it will be for the wiki version instead because it's easier to work with

• Dislaik's clothing guide includes some basic information about PZ modelling in Blender.
  
  
• Character and Hair models[drive.google.com]
  
  
• I also recommend using this website[3d-convert.com] to convert the .X models from the media\models_X\Skinned\Hair folder into .DAE files, which can then be imported into Blender.
  I recommend using converting to the .DAE filetype because I've found that it's the most reliable for converting PZ models, although the conversion might fail for some models.

This section won't cover the modelling process but includes key information for hair models, as well as some general tips that you can use for all Zomboid models.

---

When you import models from the game I recommend selecting Dummy01 and then setting its scale to 1 on all axes so that you can work with the model at a more reasonable size.

You can then press CTRL+A to open the "Apply Transforms" menu and apply the rotation + scale of the Dummy01 object. You should then be free to delete Dummy01 as well as Bip01_Prop and Translation_Data.

If you are importing multiple models into the same scene then it can be helpful to repeat the above process for each of them, next you can also apply the rotation + scale of the duplicate Bip01 armatures - which you should then be able to delete without breaking the rotation/scale of the models attached to it.


If you have converted a model yourself to .DAE then you may find that all of the triangles in the mesh are separated. To fix this, go into edit mode on the mesh, select all, and then press M and merge by distance.

Importing this way might also import a ton of line objects, which you will need to delete.

---

In order to attach the mesh to the armature, you will need to select it, and then select Bip01,
You can select multiple objects by holding CTRL when selecting in the hierarchy list, or by holding Shift if you are selecting in the 3D Viewer.

Make sure your cursor is in the 3D View and then press CTRL+P to open the parenting menu, and Armature Deform to assign it.


You will then want to check the Vertex Groups of the mesh and ensure that the mesh has a Bip01_Head group. If your hairstyle is short enough then you may want to simply select your whole mesh and assign it to this vertex group - otherwise you will need to deal with Weight Painting to make sure that the hair moves correctly when the head bone is rotated.

---

You will want to use F_Hair_White, F_HairCurly_Long, F_HairCurly_Short, or F_Hair_Braids found in media\textures on the hair model, although you can also use your own custom texture.

You can use whatever texture you want inside Blender as the in-game texture will be assigned through script.
Zomboid only supports models having one material so you will want to delete any extra materials that your hair meshes might have.

---

I set up my Blender scenes like this so that each hairstyle has its own Blend file. If I have multiple hairstyles based on the same model then I will keep them in the same file. I separate the male and female models into separate collections so they can be hidden.

I suggest deleting unnecessary bones from the male and female armatures to lower file size.
I only keep the Head, Neck, and Chest bones. I don't recommend weighting anything to the neck bone because it usually breaks in-game.


I also recommend going to the shading tab in the top right and changing the shading mode to MatCap while you are modelling so that it looks closer to how it would in-game.

---

Select the hair mesh and the armature, and then go to export and choose .FBX.
These are my recommended export settings:

In C:\Users\Zomboid\mods there is a template that you can copy and use as a base.
Your folder structure will need to look like this:

Inside hairStyles you'll need to create hairStyles.xml, which will be where we create the hairstyles for use in-game. This file should contain something like this:
I will now explain what each of these lines means:

Every hairstyle you add to your mod will need to be included inside of this <hairStyles> tag.

You create a new hairstyle entry by using a <male> tag or a <female> tag, which decides which body type the hairstyle will be available for.

The name you use for the hairstyle will be its internal name, so you should make sure it does not conflict with any other hairstyle names. In this example I have included an "M_" in the name as I usually make my hairstyles available for both male and female characters, and it helps with organisation.

The model entry is where you will include the file path of the model you created. The path will automatically start inside the models_X folder. You also do not need to include a file type as the game will handle it automatically.

The texture entry is where you will include the file path of the texture you want to use for the hairstyle, it is recommended to use one of the default textures for maximum compatibility but you can include your own custom texture here instead. The texture here needs to be white, as it will be tinted in-game to the player's hair colour. The path will automatically start inside the textures folder.

The alternate categories will let you change to a different hairstyle entry when certain types of hats are equipped in-game, in order to prevent the hair from clipping through them. This is something we will return to in a later section of the tutorial.

The level is the length of the hair. You can choose the one appropriate to your hairstyle:
0 = bald
1 = short
2 = medium
3 = long

You can add multiple trimChoices to your hairstyle, which will define which hairstyles of the same length the player will be able to choose when using scissors in-game.
If you use my Spongie's Hair mod then these trim choices won't do anything, as it includes a workaround that unlocks every hairstyle regardless of the trim choices defined in them.

Finally the last relevant entry for this section is attachedHair, which you will only include if your hairstyle is a ponytail or any similar 'tied' hairstyle. This will let the player tie their regular hair into this hairstyle in-game. If this is not needed for the hairstyle you have chosen then you can delete this line entirely.

At this point you should be able to test the mod in-game and see that the hairstyle works, but the name in the character creation menu will be very strange. This is because we will need to create a translation for it.

To do this you will need to go to media/lua/shared/Translate/EN, where we will create IG_UI_EN.txt. This file will contain this:

IGUI_Hair_ is a prefix added to the name of every hairstyle, and M_TestHair is the name that you defined in hairStyles.xml. The "Test" will then be whatever name you want to appear in-game.

After this the name should appear in-game.

This section will explain how to use those Alternate categories in hairStyles.xml to use custom hairstyles when wearing headwear.

It is highly recommended that you use the mod Fluffy Hair, as it modifies the hat categories of every vanilla hat item to allow for more freedom with hat groups.

If you do use Fluffy Hair then you will need to make it a required mod on your workshop page and in your mod.info file. In mod.info you will need to include
"require=FH".

This section of the tutorial will be assuming you are using Fluffy Hair.

---

For this example I have removed any lines that are not important:
The categories you need to be aware of are:
Group01 = Hats
Group02 = Bandannas/Bandages
Group03 = Hoods
Group04 = Full Helmets (Crash helmets, bicycle helmets, etc)

The style is where you will enter the name of the hairstyle that will be used. This is how we will switch to a flattened version of the hair model. You can enter the same hairstyle for multiple categories.

As you can also see in this example, I have given my hat variants a "Group1", "Group2", "Group3", and "Group4" at the end of the name so that I can keep them organised.

Before you move on to modelling, I will point out that you can enter any hairstyle for a hat category. This means that if your hairstyle is already similar to one from the vanilla game, you could enter the name of a hat variant from Fluffy Hair instead of creating your own.

---

You will need to return to Blender to create new versions of your model that will need to be modified to reduce clipping with hat models as much as possible.

You need to make sure you have models that can cover the 4 hat categories
You will want to save effort by making your models fulfil as many categories as possible.



For most regular hairstyles I will just make two hat models, one where the top half is flattened, and one where the whole hair is flattened. Because I reuse these for all the hat groups it's important that none of the mesh clips into the head.


The process I use for ponytails is a bit confusing but it's very efficient.


This hair has a high ponytail so I make the tail hidden in the Group01 model to avoid clipping. In these situations I name the models G1 or G4 interchangeably. The tail can't be hidden when wearing bandannas so I made a model for Group02 where the tail is visible but the rest of the hair is still flattened.

This hairstyle in my mod is a ponytail variant of another hair, so I also use this flattened model for Group03 and Group04 in the regular hairstyle.

This hair has a low ponytail so G1 can be used for Group01 and Group02.


For short hairstyles, You will want to just make 1 hat model.

I recommend using wireframe mode to help align the mesh as closely to the head as possible without clipping.

---

Next we need to create new hairstyles for each hat model you made.
These are created the same way as a regular hairstyle.

Once again, I also recommend you add the group name (or another indicator) at the end of the model names, as it will make it much easier for you to manage your files.

The important thing you need to add is the noChoose tag, which will ensure that players and zombies cannot spawn with this hairstyle, as it will only be applied when the player is wearing an appropriate hat item.

You can set your hairstyle to only spawn on zombies when they meet certain conditions, such as their outfit, or how many days into the apocalypse need to have passed for it to spawn.

This technique can be used to stop a hairstyle from spawning on zombies, which I recommend using on immersion-breaking hairstyles.

You will need to navigate to media/lua/shared/Definitions and create a new LUA file called something along the lines of TestMod_HairOutfitDefinitions.lua, as long as you can recognise what the file is for it does not matter.

This file will need at the beginning.

Here are some examples of the types of things you can include in this file from the vanilla game:
Here you can see that the hairstyle "MohawkSpike" is only allowed to spawn on zombies with the "Punk" or "Bandit" outfits, and only if the save game is 180 days into the apocalypse.

This example will make "M_TestHair" only spawn on zombies wearing an outfit called "ZombiesDontLike", this outfit doesn't actually exist so there won't be any zombies for the hairstyle to spawn on.

If you have a lot of hairstyles in your mod that you need to exclude then you can copy this code and add your hairstyles to the list:
This code will loop over each name in the list and remove them all from zombie spawning automatically.

If you are looking for new hair mods, I have created a collection with some of the hair mods I found on the workshop:
https://steamhost.cn/steamcommunity_com/sharedfiles/filedetails/?id=2848318698

Please provide feedback on what I can improve in this guide, such as what I can make clearer and what you would like me to add.