clothingItem#

Clothing items are first defined with an item script block, but a lot of their properties are defined in the clothing item XML files. Some of these properties include masks, textures, shaders, and models. The clothing items are linked to these files via the GUID parameter.

The clothing item XML files need to be stored in the path media/clothing/clothingItems/ for the game to recognize them.

File Patterns#

  • **/clothing/clothingItems/**/*.xml

Root Element#

Element:

<clothingItem>

Type:

type_clothingItem

Structure#

The root element uses a choice composition, meaning it can contain any combination of the following elements:

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

  • <> (optional): ````

Root Type Details#

type_clothingItem#

Type:

Complex

Composition:

choice

Elements#

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

The m_MaleModel and m_FemaleModel are used to specify what model file will be used for the clothing item. Those parameters should be left empty when the clothing item is a body texture.

The model file are accessed relatively to the parent folder of media and relative to the models_X folder, but preferably should be stored in media/models_X and accessed relative to it.

For example, for the following file structure:

📁 media
  📁 models_X
    📁 MyAwesomeClothing
      📄 myClothing.fbx

These parameters should have this following syntax:

<m_MaleModel>MyAwesomeClothing/myClothing</m_MaleModel>

The path separators can be either unix with / or \\, both are valid. Make sure to not add the extension.

m_AltMaleModel and m_AltFemaleModel are used to define alternative models for clothing items that share the same BodyLocation slot as another clothing item. Alternative models relationship between BodyLocations are set in the Lua (in media/lua/shared/NPCs/BodyLocations.lua for the vanilla game).

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

The m_MaleModel and m_FemaleModel are used to specify what model file will be used for the clothing item. Those parameters should be left empty when the clothing item is a body texture.

The model file are accessed relatively to the parent folder of media and relative to the models_X folder, but preferably should be stored in media/models_X and accessed relative to it.

For example, for the following file structure:

📁 media
  📁 models_X
    📁 MyAwesomeClothing
      📄 myClothing.fbx

These parameters should have this following syntax:

<m_MaleModel>MyAwesomeClothing/myClothing</m_MaleModel>

The path separators can be either unix with / or \\, both are valid. Make sure to not add the extension.

m_AltMaleModel and m_AltFemaleModel are used to define alternative models for clothing items that share the same BodyLocation slot as another clothing item. Alternative models relationship between BodyLocations are set in the Lua (in media/lua/shared/NPCs/BodyLocations.lua for the vanilla game).

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

The m_MaleModel and m_FemaleModel are used to specify what model file will be used for the clothing item. Those parameters should be left empty when the clothing item is a body texture.

The model file are accessed relatively to the parent folder of media and relative to the models_X folder, but preferably should be stored in media/models_X and accessed relative to it.

For example, for the following file structure:

📁 media
  📁 models_X
    📁 MyAwesomeClothing
      📄 myClothing.fbx

These parameters should have this following syntax:

<m_MaleModel>MyAwesomeClothing/myClothing</m_MaleModel>

The path separators can be either unix with / or \\, both are valid. Make sure to not add the extension.

m_AltMaleModel and m_AltFemaleModel are used to define alternative models for clothing items that share the same BodyLocation slot as another clothing item. Alternative models relationship between BodyLocations are set in the Lua (in media/lua/shared/NPCs/BodyLocations.lua for the vanilla game).

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

The m_MaleModel and m_FemaleModel are used to specify what model file will be used for the clothing item. Those parameters should be left empty when the clothing item is a body texture.

The model file are accessed relatively to the parent folder of media and relative to the models_X folder, but preferably should be stored in media/models_X and accessed relative to it.

For example, for the following file structure:

📁 media
  📁 models_X
    📁 MyAwesomeClothing
      📄 myClothing.fbx

These parameters should have this following syntax:

<m_MaleModel>MyAwesomeClothing/myClothing</m_MaleModel>

The path separators can be either unix with / or \\, both are valid. Make sure to not add the extension.

m_AltMaleModel and m_AltFemaleModel are used to define alternative models for clothing items that share the same BodyLocation slot as another clothing item. Alternative models relationship between BodyLocations are set in the Lua (in media/lua/shared/NPCs/BodyLocations.lua for the vanilla game).

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

The GUID of the clothing item. This needs to be the same as the one inside the fileGuidTable file for the clothing item to be recognized by the game.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

If true, the clothing item won’t deform with the character’s body. This is used for items like backpacks or hats that should not change shape with the character’s body.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

When m_AllowRandomHue or m_AllowRandomTint are set to true, the clothing item will respectively have a random hue or tint applied to it. m_AllowRandomHue doesn’t seem to be impactful on the clothing item as much as m_AllowRandomTint, which will apply the random color on white areas of the clothing item.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

When m_AllowRandomHue or m_AllowRandomTint are set to true, the clothing item will respectively have a random hue or tint applied to it. m_AllowRandomHue doesn’t seem to be impactful on the clothing item as much as m_AllowRandomTint, which will apply the random color on white areas of the clothing item.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Specifies a bone to attach the clothing item to. Mostly notably used for hats and some arm protection items. To attach to the head, use Bip01_Head.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Specifies a shader to use for the clothing item. The default shader used by clothing items is basicEffect. The value needs to be the filename of the shader inside the folder media/shaders.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

textureChoices sets the texture used by the clothing item. Many of those can be provided as random choices for the clothing item. The textures need to be stored in the folder media/textures.

For example, for the following file structure:

📁 media
  📁 textures
    📁 CoolMod
      📄 texture1.png
      📄 texture2.png

You’d have:

<textureChoices>CoolMod/texture1</textureChoices>
<textureChoices>CoolMod/texture2</textureChoices>

m_BaseTextures is used specifically for 2D clothing items that are applied on the character’s body directly (tshirts, pants, socks…). The folder structure is the same as for textureChoices.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

textureChoices sets the texture used by the clothing item. Many of those can be provided as random choices for the clothing item. The textures need to be stored in the folder media/textures.

For example, for the following file structure:

📁 media
  📁 textures
    📁 CoolMod
      📄 texture1.png
      📄 texture2.png

You’d have:

<textureChoices>CoolMod/texture1</textureChoices>
<textureChoices>CoolMod/texture2</textureChoices>

m_BaseTextures is used specifically for 2D clothing items that are applied on the character’s body directly (tshirts, pants, socks…). The folder structure is the same as for textureChoices.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

m_Masks when set to a specific integer value will hide specific elements of the character’s body model. This is notably used to remove clipping with body parts that are hidden by the clothing item. For example, a jacket will hide the torso and arms, so to reduce risks of clipping you may want to hide these.

You can find a list of the values and their corresponding body parts in the Project Zomboid Modding Archives here.

You can insert as many of these as you want, for example:

<m_Masks>12</m_Masks>
<m_Masks>13</m_Masks>
<m_Masks>14</m_Masks>
<m_Masks>3</m_Masks>
<m_Masks>5</m_Masks>

m_UnderlayMasksFolder supposedly is used to add a texture folder in which you have modified versions of these masks if you ever need to adjust the masks for your own clothing items without clashing with other mods custom masks.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Default value is media/textures/Body/Masks. Some clothing behaviors seem to be hardcoded to this path. You can notably use it to deactivate masks by setting the value to media/textures/Clothes/Hat/Masks, but it will also deactivate damage (holes) and blood effects.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Default value is media/textures/Body/UnderlayMasks. Some clothing behaviors seem to be hardcoded to this path.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Seems to be used to specify if a hat will hide the hair and beard. Notable values are:

  • default

  • nohairnobeard

  • nobeard

  • nohair

Then values Group followed by a number 01, 02, etc are also used.

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Link to other items that this clothingItem should spawn with. This is for example used to make left and right elbow pads spawn together. The value needs to be the GUID of the other clothing item.

To add multiple items, you can add multiple <m_SpawnWith> elements:

<m_SpawnWith>GUID1</m_SpawnWith>
<m_SpawnWith>GUID2</m_SpawnWith>
<m_SpawnWith>GUID3</m_SpawnWith>
...

unknown#

Occurrence:

Optional (0 or 1)

Type:

unknown

Refers to the name parameter of a decal group defined in the clothingDecals.xml file. The clothing decals are used to add additional textures on top of the clothing item. This is most notably used to add logos on t-shirts, and it is possible to add multiple logos on a single decal group.

Types#