Altering Appearances within Wolvenkit - Full Workflow

Summary

Created: December 26 2023 by @madmaximusjb Last documented edit: August 17 2024 by

This guide will edit Viktor's body and clothing: he's an ex-boxer, he should be more muscular!

In the process, you'll learn the following things:

• Locating an NPC's files

• Editing a body in Blender

• refitting a clothing item in Blender

Creating a Mod in Wolvenkit will not be covered by this guide.

Wait, that's not what I want!

• If you just want the quick and dirty version, check Appearances: change the looks

• Or maybe you only care about Exporting Characters to Blender

Required tools

• The Wolvenkit Blender IO Suite

• Blender (the version that is compatible with the plugin)

• Wolvenkit stable | nightly ()

Hey choombas! Today we're going to be going over the entire workflow of modifying the appearance (body mesh or clothing) of a character in the game. For this guide, we'll be giving Vic (the ripperdoc) bigger pecs, but this guide should work with any character. Ready? Let's go.

Locating the .app File

The .app file lists the NPC's components, so everything that the game will add to them. This section will tell you how to find either the .app file directly, or an .ent file that leads to it.

By .ent file

Entity files are using the .app files, so you can find them from there. For instructions on how to find them, just keep reaidng.

Wiki

Under NPCs and their files, you can find a bunch of paths. If you're lucky, then your character is on that list.

From the entity folder

Almost all entity files are in the following folder:

base\characters\entities

Via Wolvenkit Search

By folder

Most main characters have their .app files here:

base\characters\appearances\main_npc

Via Wolvenkit Search

Understanding the .app file

For us, we'll be wanting to locate victor_vektor.app, which is in the main_npc folder I listed earlier.

Once we add this file to our project and open it, we will see an array named "appearances".

All of the different appearances for Victor are located in this array. Upon expanding it, we see that he only has three.

Open the default appearance and then the Components array. This is where all of the components for that appearance are stored: clothes, body meshes, hair meshes, etc.

As you can see, there are quite a lot to sort through. Don't worry, most of these things you won't have to mess with anyway.

Here are the components for body and shirt: "t0_001_ma_body__ripper_doc6245" (body mesh) and "t1_001_ma_full__ripper_doc1487" (shirt).

We'll start with the body mesh.

Modifying the Body Mesh

To modify the body mesh, we'll export it to Blender.

First, add the mesh file to your project by clicking on the yellow arrow next to the mesh file's path:

Next, we want to export the file out of Wolvenkit to enable us to edit the mesh in Blender, since right now, the file is in a format Blender can't read.

Exporting the body mesh

Once that's open, check the box next to your body mesh and click "Export Selected".

Importing it into Blender

Open up Blender, delete everything from the default project, and click on "File>Import>Cyberpunk GLTF".

Import it.

If all went well, you should see a blank body mesh in your viewport.

To edit this mesh, there are two ways to do it. You can use edit mode to edit specific vertices, or use sculpt mode if you prefer. We're going to use edit mode. Make sure you have your mesh selected, and enter edit.

You should see something like this:

These are all of the vertices that make up your mesh. Before we begin editing, you'll want to enable this button right here:

This enables proportional edit mode. Now, select a few vertices at random on Vic's pec muscles. It should look like this:

Now, to edit these vertices, we're going to press "g" and then "y" to edit them on the y-axis. Remember to scroll up until you see the circle around your cursor shrink to a little less than the width of Vic's chest. Now, we'll drag the cursor out a little to pull those areas out. Use some creative independence to determine what looks good. For me, this is fine.

Now that we've done that, make sure there aren't any rough edges on your mesh and then select your mesh and export it as a Cyberpunk GLB to the same file that you edited.

Now, you must go back to Wolvenkit to import the mesh. Even though you exported the file from Blender, it's still in a raw format and unreadable by the game. Go to "Tools>Import Tool". Select your mesh and "Import Selected".

Cool! You've just edited your first body mesh! Now we can change the shirt to account for our changes.

Modifying the Clothes

The first thing we want to do is find the piece of clothing that we want to edit within the .app file. For us, that's "t1_001_ma_full__ripper_doc1487". Let's export it using the same process as with the body mesh (remember to add it to your project before trying to export it).

Before we import the mesh into Blender, let's first import the edited body mesh so that we can see what we need to change. Follow the same process we used to import it the first time. You should get something like this:

Now that we can see what we need to edit, let's begin. Make sure to select all of the meshes that make up the shirt, as there are several. Once you have done so, select multiple vertices in the areas that the body is clipping, similar to what we did with the body mesh. Also, remember to enable proportional editing mode in the toolbar up top. Again, press "g" to enter edit mode and "y" to edit the mesh on the y-axis. Remember to scroll up until the circle around your cursor is small enough. Edit the shirt out until it doesn't clip anymore. This looks good to me:

Once you're happy with your edits, select ALL of the shirt meshes and export as a Cyberpunk GLB to the same file you imported.

Now, head back to Wolvenkit and import your changes. "Tools>Import Tool", check your mesh and click "import selected".

All that's left is to replace the depot path of the mesh you just edited. Head back to Vik's .app file, and find the shirt component ("t1_001_ma_full__ripper_doc148"). Replace the "mesh" path with the relative path of your mesh (right click on your mesh in the project explorer and "copy relative path"). Click save on the top left.

Now, you can pack your mod or install it directly to your game.

Congratulations! You just edited an appearance and changed the clothes to match! This guide can be applied to most characters, so I'm excited to see what you'll do with it!

Until next time, chooms!