HomeDiscordGitHub
Edit

Fixing Eye Clipping in NPVs by Replacing Facial Rigs

The subtle art of stuffing bones into meat

Created: August 11, 2025 by saltypigloaf Last documented update: August 30, 2025 by saltypigloaf

Overview

In vanilla Cyberpunk 2077, V’s face only ever uses Rig 000 and it's associated bone structure, no matter what facial sliders you pick in Character Creation. This is a known bug and it causes serious visual problems.

❗ Why it matters:

  • There are 22 facial rigs in the game.

  • Each rig corresponds to a set of morph slider values: for example, Rig 000 = “all sliders at 1,” Rig 001 = “all sliders at 2,” etc.

  • These rigs exist so that every facial feature aligns correctly to your custom CC choices.

  • Using the wrong rig leads to eyeballs clipping through eyelids or cheeks when looking sideways in Photo Mode.

  • For V, this can be corrected using mods like Facial Customisation[sic] Rig Fix & Facial Customization Fix - ArchiveXL but does not apply to NPVs.

Before You Start

This guide assumes you already know how to:

  • Import/export meshes with WolvenKit

💡 If you’ve built NPVs before, you already meet these requirements. This guide focuses on the rig replacement process, not general WolvenKit navigation.

The Fix

We replace the head skeleton in your mesh with one from the correct donor rig that matches your NPV’s eye shape.

✅ Result: Restores correct bone positions for eyes and facial features. Eye tracking works again; no more “eyeballs escaping through your face.”

The Trade-Off

⚠ Heads up: This changes the entire head skeleton, not just the eyes.

  • Pro: Eyes track correctly; no clipping.

  • Con: The rest of the head inherits slight positional changes from the donor rig.

  • For most NPVs this is worth it.

Tools Needed

Software
Version
Notes

Wolvenkit Stable | Nightly

>= 8.6 recommended

You can't make mods without Wolvenkit

Workflow Overview

  1. Identify donor rig for your NPV’s face/eye shape.

  2. Export target mesh to GLB.

  3. Copy skeleton data from donor to target in WolvenKit.

  4. Re-import target mesh into WolvenKit.

  5. Update the face_rig component

Step-by-Step Guide

1. Prepare Files

  • Identify your donor mesh, based on the Character Creation chosen for the Eye

    • Navigate to base\characters\head\player_base_heads\player_{body}_average\

    • Find the subfolder with the numeric value of your Eye choice. The number will be offset by 1 because the rig 000 is associated with Character Creation choice of 01.

📄 Example:

If your eye selection was 12, your rig/bones will be found in the 011 folder, either:

  • h0_011_pwa_c__young_714

  • h0_011_pma_c__middle_763

  • Import the necessary files into WolvenKit:

    • Source mesh (donor head with correct rig, identified above)

    • New facialsetup and rig files

    • Target mesh (NPV head you want to fix)

  • Duplicate the target mesh to keep an untouched backup.

⚠ Warning: Never work directly on your final NPV mesh! Always duplicate for edits.

2. Export target mesh to GLB

  • Export your target mesh using the Export Tool in WolvenKit.

⚠ Note: You won't need to edit this GLB directly, but the step of exporting and importing is absolutely necessary.

3. Copy Skeleton Data

  • Open both both the target and donor meshes in WolvenKit.

  • Change the Editor Mode to Advanced in both

  • In the target mesh, delete the following arrays:

    • "boneNames".

    • "boneRigMatrices".

    • "boneVertexEpsilons"

    • "renderResourceBlob/header/bonePositions"

  • In donor mesh, copy each of these arrays, one at a time, and paste them into the target mesh:

4. Re-import target mesh into WolvenKit

  • Save your changes.

  • Using the Import Tool, import your target mesh from GLB.

⚠ Important: This step is crucial for allowing WolvenKit to correctly calculate the new bone values. Without it, your NPVs face will droop and sag.

5. Update the face_rig Component

After replacing the skeleton in the mesh, you need to update the face_rig component so the game points to the correct donor rig and facial setup.

  1. In WolvenKit, open the .app or .ent file that contains your NPV’s head setup.

  2. Locate the face_rig component.

  3. Update:

    • rig → point this to the donor .rig file you imported in Step 1.

    • facialSetup → point this to the donor .facialsetup file you imported in Step 1.

  4. Leave the animGraph value unchanged — this stays as it is.

⚠ Important: If you don’t update both .rig and .facialsetup to match the donor, the facial bones will not behave correctly in-game.

Credits

PreviousHow to add a new appearance to an NPVNextFor NPCs - Change Appearances

Last updated