1 of 1

A new head for V

How to change V's head

Summary

Published: September 30 2023 by Last documented edit: Oct 20 2024 by

This guide will teach you how to edit the player head to create custom head shapes. You don't need to understand the complex parts of the process, as long as you follow the instructions to the letter.

If you want to edit other files for V, you may be able to find their paths in Cheat Sheet: Body or one of the surrounding pages.

Step 0: Prerequisites

You have Blender installed
You have
You have the Wolvenkit Blender IO Suite installed and ready to go

This guide assumes that you'll be starting from 0. If you want to use character creator options, please reference the NPV: Preparing the head in Blender to the point where you apply all shapekeys.

Step 1: Preparing the files

1.1 Exporting from Wolvenkit

You can consult Cheat Sheet: Head-> #head-file-paths for more information about head files. This is not necessary for the scope of this guide.

all morphtarget files for your body gender to your Wolvenkit project:

body gender

Asset Browser search query

Make sure to include all morphtargets in the folder: cyberware, tattoos, scars, and for mascV, beards.

1.2 Importing into Blender

Use the Wolvenkit Blender IO Suite to import all of your morphtarget.glb files. Make sure to un-check With Materials in the right sidebar - we won't need them, and they'll only slow down the import process.

If there is a collection with the name glTF_not_exported, collapse or delete it - we don't need all those things.

Step 2: Sculpting prep

If you have applied shapekeys

If you come from the NPV guide and have used the script to apply character creator presets, you have lost all shapekeys and need to restore them.

For all armatures (collections) in your blend file, do the following:

Import the .morphtarget.glb again. This will create a collection with the same name and the .001 suffix:
For each mesh in the collection, repeat the following steps:
1. Select it
2. Switch to Edit Mode (Hotkey: Tab)
3. Select all vertices (Hotkey: A) and delete them (Hotkey: X)
4. Switch back to Object Mode (Hotkey: Tab)
5. Select the empty mesh, then (Ctrl+click) the corresponding mesh without shapekeys
6. Join into the empty mesh (Hotkey: Ctrl+J). You now have a re-shaped mesh with shapekeys.

You now have between 32 (femV) and 45 (mascV) collections in Blender. That's a lot of resculpting! Fortunately, we don't have to do everything by hand.

Sculpting prep: A dedicated mesh

We'll make use of Blender's modifiers, specifically Surface Deform, to do the heavy lifting for us. For that purpose, we'll use a dedicated sculpting mesh, and make everything else take its shape.

In the Outliner at the top right of your viewport, find the collection with the name of h0_000_pXa__morphs.morphtarget (x being w or m) and expand it.
Find the mesh starting with submesh_00_LOD_1 (it can have a suffix like .001), and select it by clicking on it
Duplicate it (Hotkey: Shift+D, ESC)
Rename your duplicate to e.g. sculptme. This is the mesh we'll be editing.
Select sculptme, then switch to the Data tab of Properties (at the bottom right of your viewport), and disable Shape Key Edit Mode:

Now, we're ready to hook up the magic.

Sculpting prep: Modifiers

Each mesh in your .blend file needs a Surface Deform modifier that binds it to sculptme. Fortunately, you don't have to do that by hand!

Make sure that sculptme is still selected in the Outliner - the script will target the wrong mesh if it isn't.

The script you need is add_surface_deform.py from mana's github.
Follow the Blender: Running Python Scripts guide with that script, then come back here.
After clicking play, all meshes but sculptme will now have a surface deform modifier:

You can now hide all collections that you don't want to see in the Outliner.
I usually only keep sculptme, eyes, and eyebrows visible (hiding the original head mesh)

Step 3: The actual sculpting

This is the part where you draw the rest of the owl.

Save your .blend file before you start with this. In fact, save it twice. You can thank me later.

You can use the sculpt mode to change the shape of sculptme until you're satisfied.

This guide won't go into details (yet), except to tell you that the Elastic Deform tool is your best friend here. Check Refitting: Mesh sculpting techniques for tips and tricks how to go about this.

Step 4: Exporting from Blender

As of October 2024, Wolvenkit may run into issues exporting edited morphtargets, so make sure to hang onto your .blend file!

This is an excellent time for a save, because the script will remove the surface deform modifiers.

Before you can export your sculpt, you need to apply the surface deform modifiers, because Wolvenkit (and Cyberpunk) will flat-out ignore them.

Fortunately, you can do this by script as well.

4.1 Applying the surface deform

Find apply_surface_deform.py on mana's github
Follow the Blender: Running Python Scripts guide with that script, then come back here.
After clicking the play button, the Surface Deform modifier will now be gone, and your mesh will have changed shape for good.

4.2 Exporting the morphtargets from Blender

You can now export the morphtargets.

For each armature, select all submeshes inside
Use the Wolvenkit Blender IO Suite's default settings and overwrite the corresponding .morphtarget.glb

Step 5: Testing

If everything has worked, you should now be able to create a new V with your new head shape. (Loading into an existing V might cause crashes)

Otherwise, the right place to ask for help is #mod-dev-chat on the redmodding Discord server.

Happy modding!

Step 6 (optional): Disabling the character creator

By turning off character creator slides, you can stop Cyberpunk from crashing.

As of 8.15, this will break Wolvenkit export. Before exporting, you need to set the numTargets back to what WKit expects it to be.

For each .morphtarget, you can change this value to 0:

Troubleshooting

I can't export my morphtarget anymore!

If you get an exception about blob.header.numTargets: check #step-6-optional-disabling-the-character-creator.

Otherwise: Known issue as of Wolvenkit 8.15 - future Wolvenkit versions will fix this. It's why you were supposed to hang on to that .blend for dear life. :)

It crashes when loading into a savegame!

A known risk of custom heads, because custom cyberware/beards/tattoos won't play nice with this. See #step-6-optional-disabling-the-character-creator for an (admittedly heavy-handed) solution.