Summary

Created & Published: November 05 2022 by @manavortex Last documented edit: Feb 28 2024 by @manavortex

This tutorial will teach you how to switch a player mesh for an NPC garment and map its variants to the existing colours.

Other relevant know-how for this process (you don't need to read them if you already know which item you want to replace):

• Finding an item's spawn code and mesh

For a guide how to import meshes into Cyberpunk, check here.

Step 1: Replace the mesh

Perquisite: You need a Wolvenkit project.

Find the mesh that you want to use ("the old mesh") and replace it with the one that you want to switch in ("the new mesh").

1. Find both files in the Asset Browser and add them to your project.

2. Move the replacement mesh to the original mesh's folder.

3. Rename the old mesh (e.g. "t2_084_pwa__short_sleeves.mesh" -> "original.mesh").

4. Rename the new mesh to replace the old mesh (e.g. "t2_135_wa_jacket__monk_shirt.mesh" -> "t2_084_pwa__short_sleeves.mesh")

5. Open both meshes in WolvenKit by double-clicking them in the Project Explorer — we will now transfer the appearance names to enable variants.

Step 2: Enabling variants

The game looks up appearances in a mesh file by name. If none can be found, then game meshes will fall back to the default appearance, which is how the early replacers worked — every variant (base_01, old_01, rich_01) would simply spawn the default appearance.

We can simply transfer the names from the old mesh to the new mesh by renaming the entries in the appearances array.

Now that we have done that, we can start recolouring.

Step 3 (optional): Find the .mlsetups

Each appearance in the appearances array has a list of chunkMask entries (one per submesh), which are assigned a material by name.

For a more detailed explanation, you can check this page, but all we care about right now is this lookup chain:

Step 4: Success!

You can now save your mesh, then install your mod by clicking on the green arrow in Wolvenkit's toolbar. Once you have started up the game, the old item will now look like your new mesh — including its variants.

Enjoy!

This tutorial will teach you how to swap player's clothing items with NPC's that requires blender editing.

Without mesh editing, some NPC meshes will clip quite badly, because they don't have as many poses and animations as V. Some are even worse, since they'll be flying around rather than following V's movements.

In this guide, we'll fix up a coat by transferring weights from a different item. Prerequisites: - Blender 3.1 *Required* 3.6 *recommended* - Cyberpunk Blender Addon - Wolvenkit

Step 1: Finding a player item of the same size

Prerequisite: you have the mesh that you want to fix already in your project. For this tutorial, we'll want Maman Brigitte's jacket: t2_001_wa_jacket__maman_brigitte.mesh

1. Use the to find a player mesh of roughly the same size/length/cut. For this tutorial, we'll use River's coat: t2_087_pwa_jacket__river_short

   • For female body gender, search for _pwa_

   • For male body gender, search for _pma_

2. Add it to

3. Export both meshes

Step 2: Import Meshes in Blender

1. Open Blender

2. delete the standard objects from the scene (Shortcut: A -> X)

3. Import the player mesh (File -> Import -> Cyberpunk GLTF)

4. Import the NPC mesh

Step 3: Editing meshes in Blender

1. Delete or hide the NPC item's armature

2. Delete the NPC item's armature modifier (or make sure that it points at the player item's armature)

Step 3.1: Weight transfer

Repeat the process for each submesh.

1. Select the player item's mesh

2. Select the NPC item's mesh

3. Switch to Weight Paint mode in the dropdown on the top left of your viewport

4. Select "Transfer Weights". Use the settings from the second screenshot.

1. Make sure that the NPC mesh's armature modifier is targeting the player armature:

Step 4: Exporting your edit and importing it to project

1. Select all submeshes under the NPC's armature

2. Use the Wolvenkit Blender plugin to export them over the player item's mesh (overwrite it)

1. Switch to Wolvenkit

2. Import the player item's mesh via Import Tool

3. Optional: copy the NPC's appearances, materials and material definitions to the player mesh

4. Optional: rename the appearances to match those in the original player item

Sometimes you will need to do a bit more of editing but that is not a topic for this tutorial.

Step 5: Success!

Now you have functional clothing attached to the player and not flying arround.