This is the landing page for guides on how to change people. Here you can learn how to modify or create custom NPCs.

Please check the link tree in the menu on the left for details.

If you want to know where to find a specific NPC, check NPCs and their files in the References, lists and overviews section.

Depending on the supported framework, you need to name your WolvenKit project like this:

Supported overlays

KS-UV Femme path:

Head : base\4k\common\overlays\wa_head_overlay_d01.xbm

Body : base\4k\common\overlays\fullbody_overlay_d01.xbm

KS-UV Male path:

Head: base\4k\common\overlays\wa_head_overlay_d01.xbm

Body: base\4k\common\overlays\ma_fullbody_overlay_d01.xbm

VTK Femme path :

Head:

base\characters\head\player_base_heads\player_female_average\h0_000_pwa_c__basehead\textures\h0_001_pwa_c__basehead_overlay.xbm

Body :

base\v_textures\body\v_overlay.xbm

Arms :

base\characters\player\femme\body\arms\textures\femme_arm_left_01_overlay.xbm base\characters\player\femme\body\arms\textures\femme_arm_right_01_overlay.xbm

VTK Male path:

Body: base\v_textures\body\v_masc_overlay.xbm

Arms:

base\characters\player\masculine\body\arms\textures\masculine_arm_right_01_overlay.xbm base\characters\player\masculine\body\arms\textures\masculine_arm_left_01_overlay.xbm

Summary

Published: Feb 03 2024 by Last documented edit: June 14 2024 by LadyLea

This page collects information on making custom skins, tattoos and scars for V and NPCs.

Please check the nested pages in the Wiki's browser for more information, or click the "Next" button at the bottom of the page.

If you want to , you are more than welcome!

Summary

Published: Feb 03 2024 by , initial guide by Yggnire Last documented edit: 18 May 2024 by YoursTrulyBilly

This guide will teach you how to merge multiple tattoos into one.

For this example, we'll be merging two VTK tattoos from Belly Tattoos Pack and Low Back Tattoo Pack by Yggnire

Wait, this is not what I want!

• If you are looking for the body layouts, check Texture Frameworks for Player V -> #texture-layouts

• For a more detailed guide with illustrated steps, check How to create an overlay tattoo. You can use that guide for reference.

• If you want additional information, check Texture Frameworks for Player V.

Level of difficulty: Easy

The guide is extremely detailed and has screenshots for each step!

Requirements:

• The ability to read: mandatory, because I'm not gonna lie — this is gonna be difficult otherwise.

• Knowing how to edit images: recommended, because this guide will not cover it. If you don't know it, the relevant section will tell you what to Google, though

• The following two tattoo mods (kindly provided by Yggnire):

Expected time to complete:

<1h for total noobs, <15 minutes if you know what you're doing.

Prerequisites

• You have all tattoo mods that you want to merge installed in Cyberpunk 2077\archive\pc\mod

• All your tattoo mods are for the same framework (if not, check the guide about How to create an overlay tattoo).

Step 1: Create a Wolvenkit Project:

Depending on the supported framework, you need to name your project like this:

Step 2: Add the modded files

1. In the asset browser, find v_overlay.xbm inside the first .archive file and add it to your project (right-click or double-click)

1. Re-name the file in your project to e.g. lowbacktattoo.xbm

1. Add v_overlay.xbm from the second .archive file to your project

1. Re-name the file in your project to e.g. skulltattoo.xbm

2. Add the file v_overlay.xbm again — this will be your final overlay.xbm

Step 3: Export for edit

1. You can now find the exported .png files in source\raw\base\v_textures\body. Time to look at them.

Step 4: Photoshopping

1. Open lowbacktattoo.png in Photoshop.

2. Drag-and-drop the second file (skulltattoo.png) into your open tab.

3. Optional: If the pictures aren't the same size, use the W: box at the top of the file to scale it up or down.

1. If your added file has been pasted as a smart object, rasterize it by right-clicking on the layer in the Layers palette

2. Merge the layer down on the base layer

Fixing the transparency

We have one last thing to do before we can import our file back, and that is fixing the transparency. Don't worry, we'll do it step-by-step:

2. Find the Channels palette. It should be right below your Layers palette, but if it's not, you might have to turn it on via Window -> Channels

Exporting

1. Select File -> Export -> export as png

2. Overwrite v_overlay.png

Step 6: Importing into Wolvenkit

2. Find and select v_overlay.png

3. In the sidebar, make sure that PremultiplyAlpha is checked

4. Import!

1. Check the files in Wolvenkit. They should have changed.

2. Delete all files that aren't v_overlay.xbm, since we don't need them anymore.

Step 7: Testing the mod

1. Make sure that no other tattoo mods are installed — or there's a chance that you'll get to see those, rather than your new edit.

Summary

Published: Feb 03 2024 by

Overhaul of information & addition of reference pictures: June 16 2024 by LadyLea Last documented edit: June 26 2024 by AllKnowingLion

Why is there a need for Texture Frameworks?

Since CDPR utilizes the same texture paths and texture files for V and NPCs, Texture Frameworks are used to give V separate texture files from NPCs, allowing you to edit V’s skin or tattoos without your edit affecting for example, Judy, River, or crowd NPCs.

The Original Texture Layouts and Paths for V

For clarity's sake, below is also documented V's original/vanilla texture layouts and paths, that are shared with NPCs. In addition to what was stated earlier, the options to create desired looks is very limited using this vanilla way.

Texture Layouts

The original texture UV Layouts CDPR utilizes for Player V:

Texture Paths

Which Texture Frameworks exist?

Unique Arms

The earliest initial texture framework by Halvkyrie for Player Female V. This mod makes the player arms use separate textures, allowing for different custom tattoos on each arm without the former limitation of mirroring.

Texture Layouts

Unique Arms utilizes the following texture UV Layouts for Arms:

Texture Paths

The Unique V Texture Framework

Also known as "UV" or "KS-UV" was created by Zosoab70 and AllKnowingLion, and released by their team account, "KnowSo". The UV Framework was the first full body and arm texture framework. The base version is designed for players to be able to make their character as unique as they'd like while also allowing for modders to easily create their textures for the body and arms from a single file instead of having to use multiple. Following the 4.1 update, however, modders will have the option to utilize alternate layouts for the arms that are formatted more closely to the vanilla structuring.

Supported body mods:

• (F) Lush/SoLush

• (F) Solo Original

• (F) Solo Small

• (F) Solo Ultimate

• (F) Solo Arms

• (F) Solo 2.0 (Unreleased)

• (F) Project Valentine

• (F) Paragon Body (Discord Exclusive release on KS Discord server)

• (F) Nanarc's Flat Chest Body

• (F) Songbird Body

• (F) Songbird Body 2.0

• (F) Vanilla Plus

• (F) Ultra High Poly Body (UHPB)

• (F) Vanilla High Feet (Alternate UV Framework base body file)

• (F) Freyja

• (M) Adonis

• (M) Atlas

• (M) Titan Body (Unreleased)

• (M) Pinkydude's "Better Feet" Body

Texture Layouts

UV Texture Framework's base version utilizes the following Full-Body texture layouts:

Texture Paths

The texture files for UV are separated by body gender. UV Texture Framework resources can be found on nexus - Miscellaneous files Section.

V Texture Kit

Also known as "VTK" created by xBaebsae, is a framework that focuses on giving HD Skin textures and Tattoo textures for the body, feet, arms and head for Player V. It integrates Halvkyrie's Unique Arms paths, and its structure expands for more customizability.

Supported body mods

• (F) Vanilla HD

• (F) Vanilla HD - VTK Big Breasts

• (F) Vanilla HD - VTK Small Breasts

• (F) Hyst's Realistic Butt (RB)

• (F) Hyst's Enhanced Big Breasts (EBB)

• (F) Hyst's Enhanced Big Breasts + Realistic Butt (EBBRB)

• (F) Hyst's Enhanced Big Breasts: Push Up (EBBP)

• (F) Hyst's Enhanced Big Breasts: Push Up + Realistic Butt (EBBPRB)

• (F) Hyst's Enhanced Vanilla Body (EVB)

• (F) Hyst's Angel Body

• (M) Gymfiend

Texture Layouts

VTK FemV utilizes the following texture UV Layouts for Arms:

VTK FemV utilizes the following texture UV Layouts for the Body:

Texture Layouts

VTK Gymfiend utilizes the following texture UV Layouts for Arms:

VTK Gymfiend utilizes the following texture UV Layouts for the Body:

Texture Paths

The texture files for VTK are separated by body gender. VTK resources can be found on nexus - Miscellaneous files Section.

What's the difference?

Primarily, the basic difference is the UV layout of the body/arm textures between the base version of the UV Framework, and VTK. Beyond that other features include:

An example of the UV Layout differences in-game:

Summary

Published: Apr 11 2024 by Yggnire, initial guide by Yggnire Last documented edit: Aug 16 2024 by

This guide will teach you how to create your own overlay tattoo for either of the texture frameworks, or how to convert a tattoo for a different body mod.

Wait, this is not what I want!

• If you are looking for the body layouts, check Texture Frameworks for Player V -> #texture-layouts

Level of difficulty

The ability to read: mandatory, because I'm not gonna lie — this is gonna be difficult otherwise. Knowing how to use a drawing software : recommended, because this guide will not cover it. Knowing how to use WolvenKit.

Estimated Time:

<5 minutes to set up everything 5 minutes - as long as it takes you to create a tattoo that you like <5 minutes for the import/install

Prerequisites

• You have

• A drawing software like Clip Paint Studio, Photoshop or photopea.com

• Some time and patience to create tattoo

Step 0: Setup

1: Create a Wolvenkit Project

2: Add the right files to your mod

You have two ways of getting the correct files:

• download the modders' resources from the framework's page

• add the files to your project from the framework you have already installed

The tutorial will walk you through the second:

2. Find the name of the texture that you want to edit on the Overlay textures by framework page.

4. Add the files to your project by double-clicking on them.

Optional: Add the base body texture as a reference

The tattoo frameworks will have the base body texture in the same folder as the overlay files.

1. Right-click on your overlay file in Wolvenkit's Project Browser

2. Select Copy Relative Path from the context menu

4. Delete the file name from the path: you just want to search for the folder

5. Add > .xbm to the end of your search (with a space!) to limit your search to texture files.

6. Hit Enter and browse through the files inside the folder: one of them will be the base body texture.

3: Export the textures

1. Use the Export Tool to export the .xbm files to .png.

2. You can right-click on one of the png files to open it in the Windows Explorer

4: Edit the textures

It's image editing time! This guide will only give you a rough outline, but make sure to read the red box below.

You can use an image editing software of your choice, as long as it supports alpha transparency. If you don't have one, use photopea.com – it's free and in your browser!

1. Optional: Import the body texture as reference

2. Import the overlay texture that you want to edit

Resizing the textures

1. Create a new layer above the skin texture and start drawing your tattoo :

Making changes

You can now draw on the transparent layer (again, do not draw on the body texture).

If you are converting a tattoo, you will have move individual parts around instead.

Exporting from your graphic editor

When your tattoo is complete, uncheck the eye on the skin layer

Your project should look like this: Your tattoo and no background

Let's export the tattoo. A detailed tutorial can be found under #editing-a-texture.

5: Reimporting the texture

Now you need to import your file back into Wolvenkit. You have two ways to do that:

Import Tool

1. Overwrite the png that you created in step 3.1

2. Open the Import Tool and import your png

3. You're done

Texture View

1. Save your new tattoo anywhere on your PC as a .png file.

2. In Wolvenkit, open the .xbm file by either double-clicking the file, or clicking the blue icon

4. Switch to the "Texture Preview" tab

5. Right click on it and select Replace Texture. Choose the file you have saved.

Time to test!

Summary

Published: 18 May 2024 by YoursTrulyBilly Last documented edit: 18 May 2024 by YoursTrulyBilly

This is an optional sub-page for the guide. Only follow the steps here if you want to merge into a clean template — otherwise, you can go on!

Adding the target file

We will merge both of these tattoos into the file that's loaded by the VTK framework. To get that, we'll download the Modding resources from xBaebSae's .

1. In the downloaded zip file, open the subfolder xBaebsae_VanillaHD_Body

2. Extract the base folder inside into your Wolvenkit project, subfolder source\archive:

1. You only need v_textures\body, so you can delete the folder characters.

1. Now, rename v_overlay.xbm (for example to v_overlay_0.xbm)

Why am I renaming this?

Tattoo frameworks work by loading certain overlays on top of the regular skin texture. Due to technical limitations, these overlays must be hardcoded.

You want to create a new overlay with the merged textures from both of your .archive mods. Since all these files will change the same .xbm file, we're creating a backup here.

This guide was originally written by Halk and imported with their permission. You can find the original .

This will help you from Step 6 and forward from NCT’s guide.

With WolvenKit

1. After your tattoo is where you want it, and you’ve turned off all the other layers, flip your file vertically - do not just rotate, you gotta use the Flip Canvas Vertical option. Save your file as a .png on a transparent background. From: To:

2. Open WKit and , name it as you want your mod’s .archive to look like in the mod folder. Or not, I’m not your dad. Do not save your WKit projects in the Cyberpunk folder.

3. Your Project Explorer tab will look different, this is just how I like to organize my tattoo making by putting all my files in the same place. (Anything you put in the RAW folder will not make it to the game mod!) I’m replacing a Masc V body tattoo, so I need the original .xbm file of it to make my import. This is where the “Help with file Names” document from NCT’s guide comes handy. I’m replacing the Tattoo 1 in the Character Creator. The guide tells me that the name of its file is tattoo_body__customisation_01. Since it’s for Masc V, I need the _d01 variant. As you can see, I already have the file I need extracted and ready to use down there. Assuming you don’t, head over to the Asset Browser and look for the file you need. Again, refer to the document in NCT’s guide. Double click to add it to your project. Your Project Explorer tab will now look like this!

3. Once everything is correctly set up, just click Install on the upper menu so it packs and installs your replacement to the game, then test it! (I am not sure if you need to do anything else to use it as a REDmod, but I don’t use REDmod so I won’t guarantee it works if you just use “Install as REDmod”.)

Summary

Published: Feb 29 2024 by Yggnire, initial guide by Yggnire Last documented edit: June 15 2024 by LadyLea

Level of difficulty

The ability to read: mandatory, because I'm not gonna lie — this is gonna be difficult otherwise. Knowing how to use a drawing software : recommended, because this guide will not cover it.

Expected time to complete

<5 minutes to set up everything 5 minutes - s long as it takes you to create a scar that you like <5 minutes for the import/install

If you want to know how to make scars, I advise you to take a look at the tutorial

Prerequisites

• You have

• A drawing software like Clip Paint Studio, Photoshop or

• Some time and patience to create scars

Step 1 : Settings up

1.1 Create a and give it a name

KS_UV project name should be 005_modname

VTK project name should be 000_modname

1.2 Add the correct files

2. Add them to your project by double-clicking on the entries in the Asset Browser

5. Save the files in a new folder.

Step 2 : Scar creation

Step 3 : Replacing and Importing

Do this for all of the files. If you install the mod, you should now be able to see your new scar!

Summary

Published: Feb 05 2024 by Yggnire, initial guide by Yggnire Last documented edit: Feb 05 2024 by Yggnire

This guide will teach you how to create scars by replacing vanilla one. In this guide, we'll replace #4 in the Character Customization.

Level of difficulty

The ability to read: mandatory, because I'm not gonna lie — this is gonna be difficult otherwise. Knowing how to use a drawing software : recommended, because this guide will not cover it.

Expected time to complete

<5 minutes to set up everything 5 minutes - s long as it takes you to create a scar that you like <5 minutes for the import/install

Prerequisites

• You have

• A drawing software like Clip Paint Studio, Photoshop or

• Some time and patience to create scars

Step 1: Settings up

1. Create a and give it a name that you can remember. Since we're replacing a basegame asset, make sure that it starts with basegame: basegame_my_scars_replacer

2. To create scars replacer, you need the following files (they're shared for both body genders) from this folder:

1. Add the files to your project by double-clicking

Step 2: Scar creation :

Let's start by creating the scar's bumpmap. Open pma__basehead_scars_n01.png (the yellow-greenish one).

The image should look like this :

The vanilla size are 1024x1024, I have upscaled mine to 4096x4096, but that's personal taste.

1. You will need to erase one of the pre-existing scars. Use the pipette tools and take the same color as the background.

1. Add a new layer and paint over this part of the image.

1. Once it’s done, add a new layer and start to draw your scar, I recommend you to use a brush similar to wet watercolor to create « natural scars » if you want to create cyberware scar, use a more consistent brush .

1. To create your scar, take a basic red color, and draw your scar on the new layer you created in Step 2.

2. Copy the entire layer (Hotkey: Ctrl+A, Ctrl+C)

3. In the Layers Palette, select the red channel and paste your scar. The image will now be black and white.

1. In the Layers Palette, select all three channels (or RGB) to see colours again.

2. Now you need to turn your image green. There are various ways to do that, for example Image -> Adjustments -> Hue/Saturation.

3. Copy the green scar and paste it into the green channel.

4. Use CTRL + T to select it and shifted the scar a few pixels to the right (you can use the arrow keys). It should now look like this:

Editing the roughness map

1. Now that you have a scar, open h0_000_pma__basehead_scars_m01 (the black-and-white one, your metallic map).

2. On the yellow image, switch to the red channel again and copy everything (Hotkey: Ctrl+A, Ctrl+C)

3. Paste it into the metallic image (Hotkey: Ctrl+V). It should now be on another layer. If not, undo the paste (Hotkey: Ctrl+Z), create a new layer in the layer palette, and paste it again.

4. The pasted scar should automatically be black and white. If not, change that via the Edit -> Image -> Greyscale option.

5. Invert the image (Hotkey: Ctrl+I) so that it looks like the picture below:

1. Now change the contrast of the formerly red channel so that the scar is black (Image -> Adjustments -> Brightness/Contrast).

2. Repeat the process with the green channel from the normal map.

3. Now change the brightness of the formerly green channel to a light grey Image -> Adjustments -> Brightness/Contrast).

4. Set the blending mode of the green scar layer to Difference. This will give you an inverted image, but that's fine.

5. Now, merge the two layers (hotkey: Ctrl+E)

6. Invert it (Hotkey: Ctrl+I)

7. Change the tint of the RED scar to black and the GREEN one to light grey.

Do this for the others png files with appropriate colors.

Replace in your wolvenkit project all the png with the new one, « Import » and then « Install » and enjoy your new scar !

Go to Character Customization and select the scar 4.

Known issue :

Here is the issue that I have had to deal with and you will certainly meet it.

In-game, this kind of issue can happen , nose textures cut and strange square shadow on the neck.

To remedy this problem, create a new project and obtain the 4 file types as seen above and replace them with those that you modified, export, import, install and that's it, the problem should no longer be present. If the problem persists, start the procedure again.

Summary

Published: Feb 29 2024 by Yggnire, initial guide by Yggnire Last documented edit: Feb 29 2024 by Yggnire

I will give you some basic idea on how to create scar, I encourage you to use these basics and explore as many possibilities as possible. Don't hold on to what I'm going to explain to you.

Have fun.

Level of difficulty

The ability to read: mandatory, because I'm not gonna lie — this is gonna be difficult otherwise. Knowing how to use a drawing software : recommended, because this guide will not cover it.

Expected time to complete

- as long as it takes you to create a scar that you like

Prerequisites :

• A drawing software like Clip Paint Studio, Photoshop or

• Some time and patience to create scars

• A graphic tablet (hightly recommended)

I use the software CLIP STUDIO PAINT but you can do it with the one you want.

I'm gonna do the scar on the normal map (bumpmap) first.

I take a RED color like this :

Handmade scar :

I use a wet watercolors brush for the natural scar

Do the base of your scar :

Then pimp it , you can erase or add some pieces to your scar with your brush

Now copy paste your scar and change the color to GREEN, place the layer below the red one and move it a few pixels to the side you want.

Now copy paste your scar on the skin textures

Use the Pipette tools and take the skin color, use the "Lock Transparent Pixels" parameters OR you can use CTRL+U to modify the color as you wish, do the same for the GREEN layer, personally I use a lighter color for the red layer and a darker color for the green layer

Good job, you have your first scar ! Now do magic with wkit and go see your scar in-game

In-game appearance

Baked Normal map scar

In this part of the tuto I will show you a different way to do a scars (with better in-game results)

To begin you will need the diffuse map :

Draw your scar : I know this is not a simple scar if I have done this one, it's to show you what we can do with baked normal map.

Save your scar as a .PNG.

Download it and when you are in , click on "Open photograph from file".

Choose your png file of the diffuse map.

Choose a shape, personally I will pick the right one

Make those sliders slide the way you want and then "save normals to file"

Now you will need to go on WolvenKit, replace with "Replace Texture" your normal map with the new one you just baked.

The image should turn green, if not, go in the "import tab" and select "TEXG_Multilayer_Normal"

OR "TEXG_Generic_Normal" and import it, it should fix the problem.

You can now "Save" the image

You can now open the saved file with your drawing software, and select the scar.

Copy and paste it on the normal map of the game

You can see that the copy paste isn't smooth and have created rough edges, you will have to erase them with a smooth brushe.

When you are done with this part, you can save your file as a .PNG, keep it for later.

Now that the diffuse and the normal map are done , there remains one map to do, the roughness map.

Note that the roughness map is not really necessary for creating the scar BUT it brings more realism to it.

With a roughness map, you can give differents textures just by changing the colors you are using, see the examples :

You will have to copy the scar made on the diffuse map and paste it on the roughness map.

Now you have to change the colors to make them match with their elements

You can now replace all the textures by your textures in Wkit. Export and Import and then see the result in-game.

Published: March 15 2024 by D.I.S.C.O Last documented update: March 18 2024 by

This guide will teach you how to

• port a hair mesh from a different game to Cyberpunk

• add physics ("dangle bones") to parts of it

• use the UUH4V framework to avoid conflict with NPCS

Wait, this is not what I want!

• For an overview of existing hair files and -colours, check

• For a more detailed guide on hair physics, check or

You can find a video tutorial by eagul on youtube:

Requirements

Introduction

You first need to understand the files you need for hair to work in CP2077. There are three type of files: the Mesh, the Texture and the Physics.

The Mesh

Adding the head

Begin by importing the player’s head. This will allow you to adjust your mesh more accurately and to avoid clipping.

Adjusting the hair

1. Import your hairstyle mesh. This tutorial is using the Festive Hunter’s hairstyle from Nier Reincarnation, since a future version of this tutorial will also cover the addition of ornaments to your hair

1. The modded hair will come with its own armature (bones), modifiers and materials. Delete all those, since you don't need them:

   • Bones: The "armature" object in the Outliner (top right panel)

   • Vertex groups: In the "data" tab (green triangle) under object properties (bottom right panel)

   • Modifiers: In the "modifiers" tab (orange wrench)

1. Reposition and refit the hairstyle to fit V's head.

Rigging the hair

Unlike clothes, most head meshes only have one bone: Head. More complex designs and physics will involve more bones, but we'll stick to the easy version for now.

1. Select your hair

2. Switch to Edit mode (Hotkey: Tab)

3. Select all vertices (Hotkey: A)

4. In the Data tab of the Properties panel (green triangle), create the Head entry (see screenshot below)

5. Click on Assign

If you were to add this mesh in-game, it would stay on your character's head like a helmet.

Submeshes and materials

The Physics

Remember when I said “like a helmet”? That also means your hair will not have any physics. Some short hair won’t have physics to wave around to begin with, but if you want your bangs and ponytails to wave when you open the character editor, get ready for some trial and error.

1. First of all, understand which part of your hair you want to have physics first, and separate them into a submesh:

   1. In edit mode, select the part that you want to split off (You can use "Select Linked", Hotkey Ctrl+L, to speed this up)

   2. Once you're content with your selection, separate the selection into a new submesh (Hotkey: P -> S)

2. Repeat the previous step on the submeshes that you don’t want to move. In this case, only the bangs will move:

Finding vanilla hair to replace

Search for a vanilla hairstyle from the game that resembles your physics part the most, and export them with Wolvenkit.

What you want to look for is how much the vanilla hairstyle overlaps with your mod hairstyle. The closer their shape resembles, the better. In this case, I find hairstyle 05 to be the most suitable, so I export that mesh, as well as their rig and animgraph.

If you want your hair to have physics, be sure to include the .animgraph and .rig into the project. They are the physic components for the hair.

I've done this enough time to have some experience regarding which mesh should I use for weight transfer. For Front and Right Bang, use components from hh_081_wa__buns_02, for Left Bangs, use hh_040_wa__pixie_bob , for hair on shoulder, use hh_118_wa__gillean or hh_115_wa__alanah, for ponytails use hh_083_wa__ponytail_01.

-Parent the hair meshes under the vanilla mesh’s armature, as well as add the armature modifier.

While you can put your ornaments and hairstyle together, I recommend keeping them separate. You can import any head item and use its armature instead. This is my personal preference to keep things tidy, to avoid confusion when we handle hair’s material and texture later. It’s best that you keep the hair and ornament in two separate mesh files.

-And we are now done with the Mesh Section, but we can’t export it just yet. We need to make sure that our hair will actually show up as hair in the game, so we shall move on to the next part.

The Texture

If you are porting a hairstyle from another game, it is highly recommended that you just adapt the UV of your hairstyle to fit CP2077’s shared hair texture instead of using the original texture. This will allow your hair to use the game’s hair color system, as well as saving you a lot of hassle when handling the materials.

Excluding beards, caps and private hairs, CP2077 has 5 types of hair textures. Export them from Wkit and add them into Blender so that you can use it as reference for UV editing.

Curly hair strands - base\characters\common\hair\textures\hh_curly01_alpha01_r.xbm

Dreadlocks - base\characters\common\hair\textures\hh_dread01_alpha01_r.xbm

Kinky hair strands - base\characters\common\hair\textures\hh_kinky01_alpha01_r.xbm

Long straight strands - base\characters\common\hair\textures\hh_long01_alpha01_r.xbm

Short straight strands - 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.

Keep in mind that no matter what type you choose, you will always need three accompanying texture files for the hair texture to work properly. These files are gradient, id and flow. You can find them by replacing alpha in the file name with any of the terms above.

-Open UV Editing and edit the UV to fit the white parts of the alpha texture. The black parts of the alpha map are where the mesh will be transparent, thus creating the image of strands of hair. Keep in mind that the hair root is pointing upwards, while the hair tip is pointing downwards. The direction is important for gradient handling. Scale and rotate the UV to fit the alpha.

This is how your UV should ideally look like. Everything is where the alpha will work.

You can preview how your hair will look in Blender by creating a material and importing all the textures mentioned above. This part is optional, but it's nice to check for gaps before you export.

-Create a material and assign it on your mesh before opening the Shading tab.

-Connect alpha texture to Alpha slot of Principled BDSF.

-Create a mix node, set to color and multiply. Connect id texture to slot A and gradient texture to slot B, and connect the output of the multiply node to a Gamma node and set the value to 2.4. Connect the output of the Gamma node to Base Color of Principled BDSF.

-Connect flow texture to Rebuild Normal Z to Normal Map to Tangent of Principled BDSF.

-Turn on Viewport Shading.

This is what your mesh should look like. The black and white represents how hair color gradients will show itself on your hairstyle. Black is the root color., white is the tip color.

-Now you can export your mesh.

Wolvenkit

Create a project and copy the framework file from UUH4V Framework. I want to replace FemV hairstyle 33, so I chose file 33 for FemV.

Remember this? Copy and replace one of the sets of three files. For example, you need to rename your imported mesh to fhair33_pt1.mesh. If that’s the case, you need to rename the .animgraph and .rig to fhair33_pt1.animgraph and fhair33_pt1.rig. Move them into the uuh4v_framework folder and replace the original file.. Having the wrong names will cause your mesh to morph weirdly.

-Open your mesh to check the materials. You want the materials to actually be what you want. Unless you have multiple submeshes, only the first entry in the material matters.

I want to use cards, not cards_top. I can manually change every instance of cards_top in the appearance, or find another mesh that uses cards in the first entry and copy the materials over instead. Since I joined my meshes into one mesh, only the first material entry matters for every appearance. This is the easy way to do it, because there are 35 appearances for 35 hair colors that you need to check over and edit. Copying the materials from another working hairstyle is the simplest way to do it.

Now you can install the mod and see how it looks in the game!

Oof. The color looks about right, but…

If you’re wondering why the hair is warping weirdly like that, it’s because of the physics. It is important to understand that the method taught in this tutorial is the easiest and fastest method, but also the most unreliable. Advanced modders can weight paint and edit rigs by themselves instead of relying on vanilla hair weights, but I know neither of those so I can’t teach you how. If you can’t get your hair physics to look right, it’s perfectly fine to leave it static instead. A good looking hairstyle is better than a glitchy wavy mess like this.

Static hair mesh, but no weird morphing.

Oh right, we got a hat, don’t we?

-Replace another mesh other than what you have for your hairstyle, and install the mod.

Tadaa! A simple hairstyle replacement with a fancy hat.

Summary

Created & Published: May 13 2023 by @manavortex

This guide will show you how to do the following things:

• Setting up a Wolvenkit project with the prepared example files

• Creating your V's head in Blender (has its own sub-page)

• Adding them as an NPC to spawn them with AppearanceMenuMod (has its own sub-page)

Difficulty:

Easy, but not trivial: you don't need any prior knowledge, but the process is complex, and if you miss steps or deviate from the instructions, things will end up not working for you.

This guide uses the following versions:

• Cyberpunk 2077 game version >= 1.6

• Wolvenkit >= 8.12 (Nightly | Stable)

• Blender 4.1

  • Wolvenkit Blender IO Suite >= 1.5.5.2

• AppearanceMenuMod >= 2.1

Preparation: The character preset

Due to the complexity of V's head mesh, you have to do a little bit of prep work here.

Don't worry, I'll walk you through it step by step.

To create a face, we need to know your character's values. For that, you need to have AppearanceChangeUnlocker installed, or you won't see them:

• Eyes

• Eyebrows

• Nose

• Mouth

• Jaw

• Ears

Find the mirror in V's apartment and note down the numerical values.

Setting up the files

2. Download the example files from Nexus

3. Merge the source folder in the download with the source folder in your Wolvenkit project directory

1. Delete the one you're not using (do one Wolvenkit project per NPC. No, really, I mean it.)

Check if it works

This is a working Wolvenkit project — let's make sure that it works.

2. Switch it to "Install and launch"

3. Click it

4. When the game starts, load a savegame

5. Open the CET overlay

6. Switch AMM to the "Spawn" tab

7. Search for Tutorial

8. Spawn Tutorial Woman or Tutorial Man

You should now see a person in front of you.

Get cracking

Now it's time to do the actual work.

• If you want to create your V's head for Cyberpunk, go to NPV: Creating a custom NPC

• If you just want to set up the file structure, go to NPV: Creating a custom NPC

Summary

Created: Sep 22 2024 by Silverlags Last documented update: Sep 22 2024 by Silverlags

This guide will walk through the basic steps of how to change a hair mod to correspond to a different slot, showing you how to change a hair mod from slot 01 to a different slot for female V.

Requirements:

• Hair mod to replace

• Wolvenkit to analyze mods, replace names, and pack mod

Step 0: Get the modded files

1. Switch the Asset Browser to the Mod Browser by flipping the switch (2) on the image below

2. Locate your hair mod

1. Add all files inside the mod to your project. These files will be called "your hair" in the rest of this guide.

Which files does your hair have?

Does your hair have any files with the extension .app under the following path?

base\characters\head\player_base_heads\appearances\hairs

• Yes (left): Proceed to #files-with-an-.app-file

• No (right): Proceed to #files-without-an-.app-file

• Everything is in the root, and you have no idea which is which:#files-a-bunch-of-borked-files-in-your-projects-root

Files: A bunch of borked files in your project's root

Happens when a mod has been packed with incompatible Wolvenkit versions.

1. Delete all files - we'll start over

2. Starting with Wolvenkit 8.15, you can find a scan button in the Asset Browser. If you do not have it, install a Nightly.

3. Click the scna button and try adding these files again.

4. If the file names do not resolve themselves, you will have to mix and match. Read on with Case 2.

Files: Without an .app file

The modder has taken and overwritten original game assets, and you'll have to do the same.

In this section, we'll do the following things:

• Find a compatible hair in the files

• Move your hair to overwrite that one instead

Let's get started:

1. Open Cheat Sheet: Hair -> #name-of-meshes-by-index

2. Find the mesh file for the slot that you want to replace. We now need to check if it is compatible.

Can I use this hair?

1. Switch the Mod browser back to the Project Browser

2. Use the Wolvenkit search with its full name, for example, hair mesh 34: hh_151_wa__judy_variation02_common.mesh

3. Select Browse to Asset Folder from the context menu:

1. You will see the hair meshes from the cheat sheet, among with a bunch of other files:

1. This hair has .rig and .animgraph files, which means that it has physics. Does your hair have those files included?

   • Yes: You can use this hair. Continue to #5

   • No: You can't use this hair. Go back to the previous section and pick a different hair slot from the list.

1. If your hair has more submeshes than the hair you are replacing, you can't use it either (not without #files-with-an-.app-file). Go back to 1 and pick a hair with more submeshes, such as one of the braids or the sumo hair.

2. OK, so you can use the hair. Add it to your project.

   • If it has a _cyberware_01.mesh and your mesh does not, you can simply create a copy (hold ctrl while dragging)

Re-slotting the hair

You will reassign the hair to a different slot by overwriting different game files. We do this as follows:

1. Right-click on a mesh and click on rename (can be done using shortcut key F2) and type the desired slot's mesh name along with its cyberware version

1. Repeat this with all files for your hair.

2. Your project browser will now look like this:

1. Drag each of the files to the new mesh's folder (hh_089_ma_thompson)

2. You will see a dialogue asking you to overwrite. Select "Yes":

1. Delete the now empty folder hh_033_wa_player. We don't need it anymore.

Files: With an .app file

The modder has overwritten the hair's control files. It should look like this (subfolder names can vary):

This is good news, because it's the easy case. You only need to do two things:

• Pick a new hair slot

• Move your .app files to overwrite the ones from that hair.

Let's get started.

1. Open Cheat Sheet: Hair -> #hair-control-files-by-index

2. Pick any hair by slot - we will use slot 04 and search for all its .app files: hh_003_pwa__hairs_89 > .app

3. Add all these files to your project:

Now, we need to overwrite all these files with the ones from our other mod.

1. Select the first .app and press f2, or select "rename" from the context menu

2. Change its number from 059 to 89

3. You will get a file overwrite confirmation. Select "yes"!

Wait, we're missing a file!

1. Your mod didn't have hh_003_pwa__hairs_89_cyberware_01.app.

2. Optional: Take a moment to curse these incompetent guide writers, or yell very loud.

3. Select hh_003_pwa__hairs_89.app in the mod browser

4. Hold the ctrl key down and drag it on itself

5. You will get a file overwrite confirmation. Select "no" to create a copy.

6. Overwrite cyberware_01.app with your copy.

Pack 'n' go

You can also click on the down arrow next to install and set to "Install and Launch" to do these two steps for you!

That's it! You can now test your new hair mod.

Troubleshooting

You are missing a file

An .app file

Go up to #files-with-an-.app-file -> #you-are-missing-a-file

A .mesh file

If your mod does not have any .app files, you have the following options:

• Overwrite it with a duplicate: just duplicate one of the existing files, and add it a second time. This may cause clipping.

• You can overwrite it with a shadow mesh:

  • Search for base\characters\common\hair\shadow_meshes\hh_ > wa (> ma for a masc V)

  • Find something that looks vaguely similar

  • overwrite

• You can find a different hair to overwrite

A .rig or .anim file

You need to find a different hair to overwrite.

Summary

Created: Sep 16 2024 by Last documented update: Sep 16 2024 by

This guide will show you how to create a custom hair colour to to replace an existing .hp file.

Creating a custom .hp file

You can find a step-by-step walkthrough under WKit Blender Plugin: Import/Export -> #hair-profiles-.hp

Adding it to the character creator

This is currently under development! (Exciting, isn't it?)

Summary

Created & Published: Summer 2021 by @Pinkydude

What you’ll need :

• WolvenKIT or the game files extracted [basegame_4_animation.archive]

• The 010 hex editing software with the CP77 template as well as the scripts (I recommend joining the CP77 Modding server to grab those!)

• The WolvenKIT console (CP77Tools)

🟨 WON’T WORK With AMM’s naked/shirtless custom appearances

I’ll assume you already know some basic modding (extracting the files with the console or WKit etc)

You need to grab the mesh you’re going to use as a body / chest and swap on the NPC. I made edit to mine, but I used the “t0_000_ma_base__full” body

Open the “buffer 0″ and check the files list, search for the skintone your NPC is using. Mitch is using the “male_01_ca_pale.mi” file

You can see I have it custom pathed already, but you can check the other files to see the path

Go to the “base\characters\common\skin\character_mat_instance\male\body” folder and grab the .mi file corresponding to your NPC’s skin tone

Copy and Paste it in a custom folder created at the base of your mod

Also create another folder where you will put the custom texture you want your NPC to use (edited or not)

Let’s go back to our buffer 0 of our mesh

custom path your skintone, in my case “male_01_ca_pale.mi”, to point to your custom folder. In my case “base\materialinstances\male_01_ca_pale.mi”

Open that .mi file. That file point to another .mi file, that we also need to copy and paste in the custom folder, and then custom path

It calls for another file, that we also have to copy and paste into the custom folder. That .mi file finally calls for the texture files! We custom path those as well

Once you have the .mi files all custom pathed, and the texture custom pathed as well (don’t forget to save the edited files of course) you can custom path the one in the mesh buffer as well and save, then rebuild the mesh using the console (so that the edit in the buffer actually have an impact on the mesh!)

Copy that mesh, and create the folders that goes to your NPC’s main outfit, and swap one of the slot. I used Mitch’s jacket to load the body mesh

That specific body mesh will now read and load the .mi files and .xbm files from your custom folders in the mod and your NPC should now have a different texture than your V!

Summary

Published: May 13 2023 by @manavortex Last documented update: Nov 09 2024 by

This page is a part of the NPV guide. It will show you how to create your V's head in Blender. If you want to load your head back into Cyberpunk, note that you aren't changing anything in the files itself — that will come in NPV: Creating a custom NPC.

We will not be dealing with the body, this is part of the next section as well.

If you want a 3d model, you probably know what you're doing; in that case, make sure to run the script and get the shape right, then go wild.

Prerequisites

• You have downloaded the prepared Wolvenkit Project from Nexus

• You have Blender installed (confirmed working on 4.1 and 4.2)

• You have the Wolvenkit Blender Plugin (you won't be able to export otherwise). Check Installing the Wolvenkit Blender Plugin if you don't.

In this section, we will be moving/deleting files. You can complete these steps in Wolvenkit or in the Windows File Explorer.

Step 1: Getting head

1. Open the head folder in your project's archive section.

   1. Optional: Be confused and/or panic about why there are over 9000 files.list
2. Look into the head/morphtargets folder

   1. Optional: Be confused and/or panic about why there are over 9000 files again.
3. Delete all those files that you aren't using (read on as for how)

I have included all meshes and morphtargets from the game files. We'll now thin out the options, deleting those parts that your NPV won't be using.

Deleting unused files: the convenient option

Finding the right piercing

In the files, you will see four files for jewelry:

tutorial\npv\your_female_character\head\i1_000_pwa_c__basehead_earring_01.mesh
tutorial\npv\your_female_character\head\i1_000_pwa_c__basehead_earring_02.mesh
tutorial\npv\your_female_character\head\i1_000_pwa_c__basehead_earring_03.mesh
tutorial\npv\your_female_character\head\i1_000_pwa_c__basehead_earring_04.mesh

… none of which is your V's exact piercings. Instead, there are full sets of jewelry, most of which will be hidden.

You have to look at the meshes and find the file that includes your set of piercings. We will delete the ones you don't need later.

Deleting files

Many of the files are variants and your V will be using one or none of them. That means you have a bunch of files to delete.

• If you have chosen the convenient option, you should already have a list of files that you need to keep.

• Otherwise, you need to refer to #what-the-actual-fuck-are-all-those-files and use the table below for some oversight.

The following table will show you examples on what to keep (as in, you delete everything else):

Expected result

After deletions, both head and head/morphtargets should hold only the files that your V is actually using.

For a list, see the table above.

Once you're done, you should have between 4 and 13/14 files:

Step 2: Exporting head

Now, we will export all .morphtarget files from Wolvenkit so that we can edit them in Blender.

1. Find the Export Tool (Tools -> Export)

   1. To filter, click into the empty row under "name" and write "morphtarget"

   2. Check the box in the header to select everything

   3. Click "Export Selected"
2. Switch to your project's raw folder or Wolvenkit's raw perspective. You will find the entire file structure mirrored there.

3. In head folder, find the file head_import.blend. This file is a utility file which will automatically import and export the files for you. For that reason, it needs to be in a certain relative path.

1. Open it in Blender. It will take you to the scripting perspective, where you'll see something like this:

1. Press the play ▶️▶button.

2. The script will now import a bunch of armatures from the morphtargets folder. You will see them showing up in the topright corner (see the next screenshot under 7. for how it should look)

3. Switch to the next script in the file, but don't run it yet:

1. Find line 26 and following in the script, and alter the values to those of your V (which you get from the character preset, see here for further explanation).

1. After you've changed the values to those of your V, click the "play" button again. This will apply the morphs to your V's face:

Can I have that with textures?

Yes, you absolutely can! Once you have imported everything back into Wolvenkit, you can re-export the .mesh files and use the Wolvenkit Blender IO suite to import them with materials.

Step 3: Importing head

Exporting from Blender

Now that your head looks the way you want, it's time to run the final script, which will export your changed head to .glb for you:

This will overwrite already existing files, leaving you with a set of import-ready mesh files.

Now it's time to get them back into Wolvenkit.

1. Find the Import Tool (Tools -> Import Tool)

2. Click "Import All". You shouldn't see any errors.

3. You're done!

If the head mesh has not changed, you ran into a problem — check the Log View and/or make sure that you completed all steps in the right order. Especially changing any paths will break things.

Step 4: Make sure that it works

Spawn your NPV and check that they look like they should.

• If they do, proceed with NPV: Creating a custom NPC

• If they don't, check #step-5-optional-troubleshooting

Step 5 (optional): Troubleshooting

Optimally, this process just runs with no hitches. However, during beta testing and troubleshooting, people ran into a few issues, so I'm listing them here.

Blender won't export

You need to use the Wolvenkit Blender IO Suite for export. Make sure that it is installed and up-to-date.

Blender script errors

You can check if Blender has run into errors by opening the Blender console window - from the menu, select Window -> Toggle System Console.

As of December 2023, any script errors have been because the person encountering them has been using the wrong Blender version. You can see which version is currently running either via UI or by checking the path in the system console window's title:

As of plugin version 1.5.5.1, you should have at least 4.0 installed.

The piercings are in the wrong position!

The problem went away after the person having it upgraded Blender.

V was imported, but they're unsettlingly, subtly wrong

If you had the example project lying around for a very long time, please try and redownload it (Nexus link), as the first version had been using an NPC animationgraph for facial expressions.

If that's not it, then you ran into the shapekey offset issue: some shapekeys don't correspond 1:1 with their numbers in the character creator. If a part of your shape is shaped wrong or looks weird in the game, add or subtract 1 from the corresponding shape key, and run the script again.

Summary

Published: May 13 2023 by Last documented update: Mar 18 2024 by

This page is a part of the NPV guide. It will show you how to use the provided example project to create a custom NPC for Cyberpunk 2077, whom you can then spawn with AppearanceMenuMod.

It will give you a brief overview over the control files and tell you how to pull in the right meshes (and appearances).

Wait, this isn't what I want!

• How about AMM: Custom NPCs?

• Find a more detailed guide about adding components to NPC app files under Appearances: change the looks. This may help you if you get stuck!

Prerequisites

This guide assumes that

• you already have a head mesh (see this section otherwise)

• that you're using a set of default paths (if not, you will have to adjust)

  • the corresponding files are in either of these folders tutorial\npv\your_female_character\head tutorial\npv\your_male_character\head

  • the meshes are named like their in-game equivalents, e.g. h0_000_pwa_c__basehead.mesh (if not, you will have to adjust)

Skipping and skimming

This guide contains as little fluff as possible, and since much of it has been covered in other guides, extra information will be contained in the links. These will be annotated as clearly as possible with what you need to read and what's optional.

If you're skimming in this guide, you will end up making mistakes. Read thoroughly. If at the end of a section you aren't where the guide says you're supposed to be, fall back and double-check your process. If you still have trouble, you can hit us up on discord in the #mod-development channel.

How everything hangs together

In the end, an NPV is just a custom prop with a god complex. For that reason, the file structure is the same (it's just a lot more complex, because you have more than 4 components).

If diagrams help you, then click on the link to see one.

The .lua file

We're registering our NPC with AppearanceMenuMod via a .lua file, which needs to end up in AMM's Custom Entities folder. The full path in the Cyberpunk directory will be this:

bin\x64\plugins\cyber_engine_tweaks\mods\AppearanceMenuMod\Collabs\Custon Entities

I have prepared two example files in the Wolvenkit's project's resources. Delete the one that you aren't using, then let's take a look at the other one:

tutorial_custom_female_character.lua

tutorial_custom_male_character.lua

The file content

This is the file content for the female example:

return {
  -- Your beautiful name :)
  modder = "tutorial",

  -- This must be UNIQUE so be creative!
  -- NO SPACES OR SYMBOLS ALLOWED
  unique_identifier = "tutorial_female_character",

  -- This is the info about your new entity
  entity_info = {
  -- name: The name that will be shown in the Spawn tab
    name = "Tutorial Woman",
  -- path: The path to your entity file. Must use double slash bars \\
    path = "tutorial\\npv\\your_female_character\\ops\\your_female_character.ent",
  -- record: This is the TweakDB record that will be used to add your character. More information below.
    record = "Character.afterlife_merc_fast_melee_w_hard",
  -- type: Character or Vehicle
    type = "Character",
  -- customName: Set this to true if you want the name you set here to appear in AMM Scan tab.
    customName = true
  },

  appearances = {
    "tutorial_woman_casual", 
    "tutorial_woman_business", 
  },  

  -- Here you can pass a list of attributes from different records to be copied to your new character.
  -- More information below.
  attributes = {
  },
}

It loads our root entity from tutorial\npv\your_female_character\ops\your_female_character.ent. That's the file which tells the game what to load.

The root entity

You find the root entity for your character here:

tutorial\npv\your_female_character\ops\your_female_character.ent
tutorial\npv\your_male_character\ops\your_male_character.ent

The root entity hooks up your .app file and the appearance names in the .lua file, and that's about everything there is to say about it. Here's how it looks:

Let's look at the .app file now.

The app file

This section will tell you how to edit your NPV's appearance – their skin colour, chrome, piercings, tattoos. We will do this in the .app file.

This is where all of your NPC's appearances are defined (appearanceDefinition, linked to the root entity via name). The appearanceDefinition's components define your NPV's properties, pulling in equipment, facial expressions, hair and skin.

It looks like this:

If you get a bunch of errors that complain about "mesh not found in project files" or "no depot path set, only hash given," that's no reason to panic – those errors come from files that you deleted, but which are still linked in the .app. If you deleted them by accident, restore them from the template project. Otherwise, you can (and should) delete the components.

How do I know what to put?

To find out which variants and appearances to use, I suggest that you use NoraLee's excellent NPV Part Picker. It will look like this:

The values you found out will go into the components in your NPV's .app file.

The NPV picker gives me a chunkMask...?

This property is used for hiding parts of a mesh. If the part picker gives you this number, simply paste it into the corresponding box in your component:

Customizing Cyberware

When selecting a different cyberware than the preconfigured one, you have to set the appearance name, or the whole thing will show up in grey. The appearance names are usually identical to the cyberware (cyberware_01, cyberware_02 etc.), but if you are uncertain, you can also open the mesh file and check the appearances list at the top.

Customizing piercings and chrome: Chunkmasks

You have the full piercing or cyberware file, but you're only using parts of it — yet the game stubbornly shows you the whole mesh.

Fortunately, you don't have to edit it in Blender, because you can hide the parts you aren't using via chunkmasks. Find the piercing or cyberware component in your .app file:

How do I know which numbers to put?

To hide those bits in the .app, we simply need to uncheck the corresponding boxes - check the previous screnshot!

Adding modded items

For a step-by-step guide on how to add items from mods to your NPV, check Appearances: change the looks -> #adding-items-from-mods!

Hair

This section will teach you how to add another hair mesh to your NPV. We will first remove the default hair, then replace it with the one you want.

1. Delete the current hair from the .app — there should be 2-3 components, their names will start with either hair_ or hh_0

2. Find the correct hair mesh. You have three options for this:

   1. Looking it up on our nifty list

   2. Using NoraLee's NPV Part Picker

   3. Filtering the files and clicking through their previews: female: base\characters\common\hair > wa_ > .mesh > !shadow male: base\characters\common\hair > ma_ > .mesh > !shadow

3. Enter the name of the hair mesh that you want to use into the Asset Browser's search bar (see next screenshot) and hit Return.

4. Once you have found the correct mesh file, right-click it and select "Find Files Using This":

1. This will give you a list of files, which you can mostly ignore. The only thing we care about is the hair's control file, which is usually an .ent file:

1. Open the .ent file and expand the components array. You will find three components in there, which you can now copy over to your .app!

The body

As of version 2.2.0, the body mesh and arms are included for easier replacing.

The process is the same as what you did with the hair: find the files in the mod, add them to your project, move them to your NPVs folder and customize them to your liking.

You can find more information at Cheat Sheet: Body (which also contains the tattoo paths).

And that's the gist of it!

Go forth and create custom apperances!

You can check this guide, or look through the .app files for other NPCs for ideas. If you need further details, I highly recommend checking out NoraLee's much more detailed tutorial, which will also give you all the context you could possibly need.

For guides on how to export a whole animated character to Blender, you can check here.

Summary

Published: May 13 2023 by @manavortex Last documented edit: Mar 02 2023 by @manavortex

Re-path your folder

You need to re-name the template folders. Unless you want to make more NPVs, it will be enough to re-name tutorial to your_username. Find a full guide to the process under .

Troubleshooting

My NPV breaks AMM!

That's how you know that you have syntax errors in your NPV's .lua file. Copy the contents of the file into a , then run the code and make sure to fix all errors.

My NPV doesn't spawn!

You can't select them in AMM

The error is with your .lua file – either it's not in the correct folder, or AMM fails to load it.

If you can select the NPV in AMM

If you click on the button, but nothing happens, that means that the game can't find your .ent file. The error is between your .lua and your .ent.

Most likely, the path to the .ent file is not correct. If it is, make sure that it has no upper-case characters.

My NPV turns into someone else if I walk away from them!

Clothes are floating!

For each of the mesh components that aren't moving, expand it and find the skinning entry. Make sure that the bindName points at root:

My feet are wrong for the shoes!

You need to manually enable the correct foot mesh.

Add an extra component and point the depotPath to the mesh for the correct feet. This is either l0_000_pXa_base__cs_flat or l0_000_pXa_base__cs_heels.

My NPV loads, but I'm getting a random appearance!

That happens when you're loading an appearance that the game doesn't know about — the problem is between your .lua file and your root entity. The names must match exactly, and must contain not typos or leading/trailing spaces.

If that was not it, double-check the path in your lua file and make sure that it points to the correct .ent file, and not to a backup or backup project.

Another NPV is showing!

I'm getting errors in Wolvenkit!

It installs, but doesn't launch

Just install the mod via WKit, launch Cyberpunk the way you normally do.

Garment Support isn't working!

GarmentSupport only works on actual garment items that have been equipped using the game's transaction system. As of October 2024, that's not the case for NPCs.

Unfortunately, you'll have to go refitting. Sorry!

This guide is part of the guide for creating an . It will teach you how to make your NPV compatible with xBaebsae's awesome mod, letting you use your NPV in the game's photo mode.

Requirements:

Compatibility: NPV < 2.0.0

For NPV projects >= v2.0.0 (30. October 2023), you can skip to .

For earlier versions, or if you have not been using the example project, you need to add the photo mode animations component.

Download Wkit Project - NPC App from the mod's .

1. In the .app file, open the first appearance

2. Open the components array

3. Find the entAnimationSetupExtensionComponent with the name of PhotomodeAnimations

4. Copy it to each appearance in your NPV's .app file.

Step 1: The photo mode .app file

Step 2: Overwrite the file

Instead of the dummy file, you will want to put your own app file there. You can copy the file by holding the ctrl key while dragging in the Wolvenkit Project Browser.

Step 3: Appearance names

The photo mode replacer assumes that your appearances will be named like this:

For the sake of clarity, the NPV appearances are not named this way. Open the photo mode .app that you copied in the previous step, and change the names of your appearances.

Step 4: Changing the facialsetup graph

1. For each appearance definition in In your photomode .app file, find the component with the name face_rig.

2. Make sure that the depotPath is of the graph is set to the correct .animgraph depending on your body gender:

1. Save the file. You now have photo mode expressions, but no more AMM expressions. Can only have one…

Step 5: Pack and test

Before entering photo mode, select the correct replacer in AMM:

1. Open the AMM overlay

2. Switch to Settings -> Photomode Nibbles Replacer

3. Select the correct replacer corresponding to your file

Step 5 (optional): Edit pose packs

To add more compatibility to a pose pack, you only have to edit the mod's .xl file, which you can do with a text editor. An entry looks like this:

There might be one or multiple entries for each supported .ent file. Find out which entry or entries belong together, then duplicate them and replace the paths with the one to your NPV replacer's .ent file.

Troubleshooting

(Most of) my NPV isn't moving in photo mode!

Force a refresh - select a different pose.

If that isn't working, refresh the appearance:

1. Open the AMM overlay

2. Switch to the Tools tab

3. Click the Target Replacer button

4. In the scan tab or the target tools, assign a different appearance. You can switch back right away.

My NPV has no facial expressions!

1. Verify that you've updated the graph.DepotPath with the correct animgraph

2. Verify that you only have a single face_rig component

The .lua file

In your project's directory, create the following folder structure:

In that folder, create your_custom_file.lua. (You can get a template project under ).

The most important thing here is the entity_id - this is what tells AMM about the already existing file that you have modified.

As an example, look at the lua file I made for way back when:

Knowing what I know today, I probably would have created a custom entity for Takemura-san in the first place, but since I chose to go down this road, I'm doomed to provide compatibility patches for the rest of eternity.

Ah, well. There are worse fates.

Summary:

Published: Oct 12 2024 by @chris Last edited: Oct 12 2024 by

This guide will show you how to create a custom rig for V, based on

Wait, this is not what I want!

• If you want to learn what a rig even does, check

• If you want to create custom poses instead, check

Requirements:

Level of difficulty:

Medium - you should have some general knowledge of Blender and Wolvenkit

Setting up

2. Find an add one of the following files (the correct one for your body gender):

1. Export it from Wolvenkit. Use the following settings:

   • Mesh Export Type: WithRig

   • WithRig settings: Select Rig -> woman_base_deformations.rig

Blender

1. You will see V's body: this is your immediate preview.

2. Enable and select the armature in the side bar panel:

1. Switch the viewport to to Pose Mode ( at the top left)

2. You can now select and scale individual bones.

• Generally you want to scale bones that do not effect other bones. Joints, or those parenting other bones can break the mesh in game. Rotation and location generally breaks things.

• In my testing, Thigh_1_JNT isn't worth the hassle, looks fine in blender but always broke for me in game. (if someone has a solution for this please let me know)

• Since you are simply using blender to get a visual on what you are changing, you technically only need to edit one half of the body.

Importing the changes into Wolvenkit

1. Add the required .rig files to your project (the second file is for first person perspective):

femV:

mascV:

1. Open one of the files in the CR2W editor and find the BoneTransforms array

2. Find the bone that you scaled in Blender:

1. Here, we copy the values from Blender' s BoneTransforms tab.

1. You need to do this for both sides of the body, so find the corresponding bone If the name of your bone ends with _r, the corresponding bone ends with _l, and vice versa

2. Save your changes

3. Open the other file in Wolvenkit, and repeat steps 2-6.

Unique V Body Framework: Compatibility

To ensure compatibility, you need to re-name any files you edited:

Testing

1. Before packing your mod, delete the .mesh file that you exported in step 1. Your mod should only contain files with the extension .rig.

3. Start up the game

Tada! if you did everything right then you can now cosplay as your favorite ant.

Thanks for reading hope it worked -Chris

Troubleshooting

My rig edit isn't showing up!

• Disable (remove) any other rig edits

• Make sure that it comes first in the load order by prefixing its name with a #

Summary

Created & Published: July 12 2023 by Mx_OrcBoi

PRC Framework was created by eagul, he also taught me how to do them, so I'm passing on the knowledge.

Required: Blender >= 3.5 & Wkit >= 8.9.1-Nightly

Level: If you can read and follow instructions, you should be ok.

Disclaimer: The detailed steps show how to place piercings in spots where vanilla ones already are.

For any other location on the face the steps are slightly different, as you will need to create your piercing on the head mesh and import over head mesh.

This is explained in a separate section.

I would suggest trying to create one in an existing location first, so you familiarise yourself with the steps and then play around with different locations.

Getting started

1. Download and install the below:

2. In wkit, import the below to your project depending on which V you want to create the piercings for:

1. Export to GLB so you end up with those files in the raw folder.

1. Import them into Blender using Cyberpunk GLTF import plugin. In this example I will be working on fV. You should end up with files like this and be able to see the head, vanilla piercings and a set of shape keys.

Each shape key corresponds with the number on the character creation slider. Basis is 1 on all sliders or no shape keys active. The rest is divided into ears, nose, eyes, mouth and jaw and subsequent numbers correspond to the character creator settings (1x is slider 2, 2x is slider 3 and so on).

You can see the shape keys actually working by selecting one of them and setting Value to 1.

For easier selection merge head mesh vertices by distance. To do this, select the head mesh, go into edit mode (Tab) and go to Mesh -> Clean Up -> Merge by Distance. Set merge distance to 0.0001.

1. Import your piercing mesh. I’ll use the septum half ring as an example. Make sure the mesh is already UV unwrapped if using custom mesh.

1. Duplicate the vanilla piercing. To do so select it in the viewport (object mode), press shift+D and then click the right mouse button. Hide the original mesh.

2. With vanilla mesh duplicate selected, go to edit mode (TAB) and press Del -> vertices. You will end up with an empty submesh.

3. Select your piercing mesh, then Ctrl select newly emptied vanilla submesh. Press Ctrl+J to join.

   By doing step 7 and 8 you’ll end up with your mesh having the correct bones for where it is placed.

   The result should be like this:

Weight painting

Now we need to either weight paint, or transfer weights if your new piercing is in the same position as vanilla one. Mine is, so I will go over transferring weights.

You can see the current weights the mesh has in Weight Paint mode.

I’ve selected the vanilla piercing here. By clicking different vertex groups you can see the colour of the mesh changes. This colour denotes how much influence each bone has on the mesh. Red is 100% and dark blue is 0%.

1. Go back to object mode if you’re in weight paint mode. Select your mesh and remove all vertex groups.

1. Go to modifiers (wrench icon) and add Data transfer modifier with below options. The source would be the vanilla piercing submesh that has weights.

1. Click Generate Data Layers, then apply the modifier.

   You can now see that your mesh has weights the same as vanilla mesh:

Creating morphtargets (shape keys)

1. Unhide the head mesh if hidden and make sure no shape keys have value other than 0, then select Basis shape key.

2. Go to edit mode (TAB) and position your mesh where you want it to be. You can keep the vanilla piercing visible for reference.

   I wanted mine to be a bit further back than the vanilla one, otherwise it clipped with the nostrils.

1. Now go through all the nose shape keys and position your mesh in the best position for each. You can set the value of the corresponding shape key on the head and vanilla piercing meshes to 1 for easier positioning (to do that come out of edit mode back to object mode) - if you do that, make sure you’re not setting any shape key to 1 on your new piercing mesh, they all have to stay 0. If creating nose piercing you only need to go through all the shape keys with nose in the name, if creating earring, go through ear shape keys and so on. No need to go through other, like for example eyes for a nose piercing.

2. Delete all unnecessary meshes if you have them, like head reference. Also delete the original piercing submesh, so only yours is left and rename the submesh accordingly (it should be something like submesh_00_LOD_1 and not something like submesh_00_LOD_1.005)

Exporting the mesh from Blender and importing in Wkit

Once you’re done export your mesh as gltf 2.0 with below settings. Save it over the glb exported in wkit.

If your piercing is influenced by more than 4 bones, also include this option on export.

Next import it in wkit.

Creating the mod

1. Add to project a morphtarget from PRC or create folder structure manually. They need to be named exactly like this, do not create a custom folder.

1. Now rename the morphtarget you imported from blender to whichever slot you want to use. The number will correspond to the slot. It does not matter which you use really, but if you want your mod to be compatible with any specific set of piercings made by someone else, check what slot they used and use different.

2. Move the file to eagul/piercingmorphs/.. (if you added to project a morphtarget from PRC to create the folder structure, delete it first, just leave empty folder before moving your new renamed morphtarget).

1. Now you can delete the character folders in base and install the mod.

Naming is important, your mod needs to load before PRC, so it is best to follow PRC’s naming convention: PRC_f/m_slot#.

To test your mod, set piercings to slider 12 for fV or 14 for mV and you should see your creation.

Supplement for creating piercings in non-vanilla locations

1. You can only export the head morphtarget as it is the only one we’ll need.

1. Import selected one into Blender, merge by distance, duplicate the mesh and delete all vertices from your duplicate in edit mode. This is similar to points 4-8 from the first section of the guide, except we’re working just with head mesh, not piercing meshes.

2. Weight paint your piercing. Since the location is not covered by any vanilla piercing, transfer the weights from your head mesh. Delete unused vertex groups (the ones that do not affect your piercing, ie have 0 weight). Since piercings are solid objects we don't want them to stretch, so go through the vertex groups that affect your piercing in weight paint mode and colour them in one sold weight colour (you can use the picker to pick one from somewhere around the middle of the mesh).

3. Once you’re done with the weight painting proceed to creating your shape keys as in the morphtarget creation section of this guide. You can use your original head mesh as reference. Tip: If you want to test if your mesh works ok before going through all shape keys make sure you create at least one, otherwise it will flatline your game. Creating means moving at least one of the shape key positions to where they should be, not at the same position as the basis shape key.

4. When done, delete the original head mesh and rename your own submesh. It should be called submesh_00_LOD_1.

5. Export your file to gltf with the same settings as in the guide.

6. Import your file in wkit over the existing head file, place in the correct folder and rename to whichever slot you’d like to use.

7. Open your morphtarget and edit the path in this section: