> For the complete documentation index, see [llms.txt](https://wiki.redmodding.org/cyberpunk-2077-modding/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/guides-all-about-hair/hair-use-cyberpunks-materials.md). # Hair: Use Cyberpunk's materials Using the game's UV layout and textures on ported hair ## Summary **Created:** Jul 31 2026 by [mana vortex](mailto:undefined) (split out from original page created by Eagul – research mostly done by IslandDancer)\ **Last documented edit:** Jul 31 2027 by [mana vortex](mailto:undefined) This page will show you how to make ported hair compatible with Cyberpunk's texture layout. {% hint style="info" %} You can find a video in the expendable box below (thanks to IslandDancer for making it)! {% endhint %}

Video by IslandDancer

{% embed url="" %}

#### Assumed skill level You should be able to select and move things in Blender without panicking. If you aren't, head to [Blender: Getting Started](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/blender-getting-started.md) and play around until you are. #### Estimated time Someone who knows what they're doing can usually do this in <30minutes. If it's your first time, you'll need an hour or to (more if you have to start over). ## Why do I need this? If you're already committed, you can skip this section and read on at [#how-do-i-do-this](#how-do-i-do-this "mention"). ### Quality Cyberpunk's hair material is extremely high-quality. However, it is using a set of four textures, some of which we don't have the tooling to generate yet (`strand` and `id`, which control how the light is reflected from individual hairs). By using Cyberpunk's original materials, you can get the maximum quality for the minimum effort! ### Mod file size Packing additional textures will increase the file size of your mod – unnecessarily so, if you complete this guide. Depending on [your resolution](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/on-4k-textures-and-high-poly-meshes.md), you can save dozens of megabytes. ### Compatibility If your hair texture is too high-resolution or if the strands are too fine, the hair will appear transparent. Even if yours doesn't, there is an edge case with AMD graphics cards, which might be affected anyway.

## How do I do this? ### Step 0: picking a hair texture Excluding beards, caps and private hairs, CP2077 has 5 types of hair textures. Pick one of them, then add it to your Wolvenkit project and export it as png. You can then import this into Blender as a reference for UV editing.

Hairstyle	Alpha texture
Curly	`base\characters\common\hair\textures\hh_curly01_alpha01_r.xbm`
Dreads	`base\characters\common\hair\textures\hh_dread01_alpha01_r.xbm`
Kinky	`base\characters\common\hair\textures\hh_kinky01_alpha01_r.xbm`
Straight long	`base\characters\common\hair\textures\hh_long01_alpha01_r.xbm`
Straight short	`base\characters\common\hair\textures\hh_short01_alpha01_r.xbm`

Most hairstyles I see use long straight strands, but don’t be afraid to use other types of hair and experiment with them. 1. Right-click on the texture in the asset browser, and select "find files using this" 2. If you don't have .mesh files in the list, right-click on a .mi file and search again until you have one 3. Add the .mesh file to your project and import it (you need it for the next step) ### Step 1: Blender Setup #### 1.1: reference screenshots First, let's grab reference screenshots so you have an easier time remapping. 1. Select your hair mesh 2. Switch to edit mode (hotkey: tab), then select all vertices (hotkey: a) 3. Switch to the "UV Editing" perspective and take a screenshot of the texture on the left 4. Deselect all vertices again and take another screenshot. You will use these as reference. #### 1.2: Changing the material Now, we change the hair in Blender to use Cyberpunk's material. 1. [Import](/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite/wkit-blender-plugin-import-export.md#meshes) the mesh file from step 0.3 with the [Wolvenkit Blender Addon](/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite.md) 2. Delete it again (hotkey:x - we only wanted the material) 3. Click on your hair mesh again to select it 4. Find the "Material" tab in the right-hand sidebar

5. Find the list near the top. You should have a material there; if not, click the + button 6. From the dropdown on the bottom left of the list, select the hair material that came with the import of the hair mesh Your hair should now show Cyberpunk's hair material (and probably looks terrible). #### 1.3 (optional): use the alpha texture as base texture It will be easier to see your hair if you assign the alpha texture instead of the base hair colour. The fastest way to do that: 1. Create a new material by clicking the "New" button below the list 2. Switch to the Shading perspective (top of the viewport) 3. Optional: look at the node editor and panic 4. Add a new "Image texture" node (Hotkey: shift+a, texture, image texture) 5. connect it to the Principled BSDF's "Base Color"

6. From the dropdown menu, select either `_alpha` or `_grad` . You should now see something like this: ![](https://lh7-us.googleusercontent.com/UKY62V9EKjuFtVwHtB-mAaQWM5GZnXsiq7rybKQ_laoHieuGspFhlBJGfA65hgb9W3gNAXyGdQgOa9Au3ydcL2jftMuTVUEdt6a4jPH9XrvJsn88ZzYhIvbvv2uMKdWB2_iFVfRz6eTf_AkACp5Jylw) ![](https://lh7-us.googleusercontent.com/LK9Wl4VrmZtVpIhHxgcrSG-O-eIrp_yBkrno5rTJbhYaJnAuRs98lKwzaISjmeZUnYZ8BRtqegn0oSeBBpN78mHUoo7JywvXgc-gcA9pli1H1tsS2sFn4Wr8UVRdgY6zi-rCWkhj6bawxYHlYgOVNlQ) In the next step, we'll re-map the UV clusters to Cyberpunk's hair layout (basically, we're pushing a bunch of squares across the texture). But for that, let's understand it first. ### Step 2: Theory If you don't care about this, you can skip ahead to [#step-3-changing-the-layout](#step-3-changing-the-layout "mention"). You'll have an easier time if you don't, though! This is cyberpunk's alpha texture for long straight hair: the black parts are transparent, the white ones are visible. There are different kinds of hair strand mapped out, which I'll explain below the screenshot.

.	What is it	Explanation
a	cover strand	The yellow chunk has next to no transparency and will look kind of flat. Its intended purpose is to cover up visible bits of the scalp via hair cap - if you use this on hair strands, the result might look ass.
b	load-bearing strand (3 options)	This kind of strand should make up most of the lower levels of your hair. It's dense and has little transparency. I usually try to avoid gaps in this layer, as they lead to poor coverage.
c	thinner strand (4 options)	We're getting to the upper layers of the hair. Unless V just left the hair stylist, the topmost hair strands will be lighter and less dense - so they will also be more reflective. You can use two strands on one card if you're okay with the gap - this can add variety.
d	flyhair	Frizz: what fashion magazines pretend you shouldn't have. This adds the final touch of realism to any hair.

### Step 3: Changing the layout {% hint style="info" %} Before you start moving anything, read [#additional-tips](#additional-tips "mention") to do future you a favour! {% endhint %} Now that we've understood how this works, we can actually change our mapping. Here are some essential keyboard shortcuts that you'll need (courtesy of [IslandDancer](https://www.nexusmods.com/profile/IslandDancer/mods)): **Blender Shortcuts:** **H** = hide\ **Alt + H** = unhide\ **S** = scale\ **S X** = scale (constrain to x-axis)\ **S Y** = scale (constraint to y-axis)\ **L** = select all contiguous geometry (select an entire single hair card)\ **A** = select all Now, let's get started. 1. Switch to the UV editing perspective (above the viewport) 2. If you don't see Cyberpunk's alpha texture in the texture editor on the left, make sure to load it (select it from the dropdown). 3. If it's not turned on yet, enable viewport shading (at the top right of the viewport, click the third orb in the list - you might have to scroll). What we need to do now is to **scale** and **rotate** the hair cards so that they fit Cyberpunk's texture. Make sure that the roots are at the top and the tips are at the bottom, or the hair colours will look weird. We'll select the whole cluster, then move it across the map to the densest hair strand (you might get better results if you use **b**, but this is an example): | Before | | | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | |

| Now there will no longer be gaps across the hair. However, you're not making the most out of the texture. Scale the hair cards so that they cover the entire strand, with a tiny bit of transparency at the edges: ![](https://lh7-us.googleusercontent.com/mCiabspnfeyj-RuZMMWQfDHQPdY16m1Q3d0DvA7D9oQQwFItpW0RDml7Hma7iuBaZLvY5aK5d-8uYfYSjqRBeF0S5dwvKGbswI_JMClEvoUbifbRR2HicRaPgFB5bmGY3VeF74xvVyGke_gOXPQ1heE) ## Additional tips {% hint style="info" %} This is fully optional, you can not do this and make more work for future you :) {% endhint %} ### Preserve hair stacks Your original hair will have **stacks of hair cards** assigned to the **same part of the texture**. Once you've moved your hair strands around, these stacks will be **irretrievably merged**, and if you want to come back later to tweak your hair mesh (because some parts of it look bad in the Afterlife or whatever), you will have a hard time teasing them apart. Fortunately, the UV layout **tiles** (imagine an infinitiely big repeated image) - which means that you can put a stack into place and then move it to a different UV tile (hotkey: g -> x -> 1, or g -> y -> 1, can be >1 or negative as well). This lets you preserve your hair card stacks for future edits. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/npcs/guides-all-about-hair/hair-use-cyberpunks-materials.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.