Submeshes, Materials and Chunks
How (and why) to split up meshes
Summary
Published: January 06 2024 by mana vortex Last documented update: Aug 08 2025 by mana vortex
This page explains the relationship between submeshes (parts of a mesh), materials ("skins" for any given part of a mesh) and chunks (submeshes as seen from the outside).
Wait, this is not what I want!
Check the parent page 3d objects: .mesh files for more general informatiton
In Material assignmentyou will get a general introduction and practical instructions
Check the Mesh Preview tab to see a preview of the mesh
Why are submeshes?
A mesh consists out of multiple parts — you might have noticed this in Blender and wondered why CDPR split up their items like this. The reason is that each submesh can have a different material assigned, and that it is possible to hide and show them under different circumstances.
At first, this seems a bit counter-intuitive, but keep in mind that Cyberpunk's entire material system is geared for flexibility. By altering a single submesh material, a black Arasaka helmet with red lights and a Hello Kitty hologram can become a black Militech helmet with red lights and a Hello Kitty hologram!

To learn how materials work, check the parent page: 3d objects: .mesh files -> Material assignment
Submeshes in Blender
In Blender, our helmet would look like this:

You can create more submeshes by splitting off parts of a mesh, and incrementing the submesh index.
Example:
You want red and blue glowing tubes on the example helmet.
Split parts of
submesh_04_LOD_1
intosubmesh_04_LOD_1.001
Re-name
submesh_04_LOD_1.001
tosubmesh_05_LOD_1
Export the new geometry and import it into Wolvenkit
Your mesh will now have six submeshes instead of its previous five
For each appearance that you have defined, add a chunkMaterial entry. If you skip this step, the new submesh will have no material assigned, and be invisible. File Validation will warn you about this.
Chunkmasks: partially hiding meshes
Imagine you want to hide the helmet's glowing parts (because you are being stealthy). You could just define another appearance where the glowing tubes are turned off — but you would have to add one for every variant you make. arasaka_hellokitty_glow
and arasaka_hellokitty_noglow
, the same for Militech, NightCorps and NCPD… ain't nobody got time for this.
That's why CDPR came up with chunkmasks.
The mesh is loaded via component in an .ent or .app file. Here, you will find the chunkMask
attribute, which looks like this:

The numbers in the dropdown correspond to the submeshes: unchecking an entry will hide it, regardless of the assigned materials.
You can only use chunkMasks to hide submeshes. If you want to conditionally show them, you have to use custom ArchiveXL tags (see ArchiveXL: Tags -> Adding Custom tags)
To use this on other items, check out PartsOverrides: Changing other meshes.
How to see chunkmasks in-game?
You have two options, (for NPCs, including V) and RedHotTools.
ACM
With ACM installed, make sure that the target is under the cursor in the middle of the screen (you can use photo mode to look at V). Then, find the correct mesh/component in the UI and click on the correct button:

RedHotTools
Find RedHotTools -> Installation guide for instructions on how to install this.
See World Inspector: Watch (the player) for a guide.
Level Of Detail (LOD)
If a submesh name does not end in LOD1, that means it's intended for lower resolutions (for example, if an object is far away).
By default, Wolvenkit removes these low-resolution meshes on export, since you don't normally want them for modded characters or items.
Last updated