3d editing: Submeshes

This page contains a theory part and a guide.

The guide section of this page has been created in the context of First Person Perspective Fixes: Editing the .mesh. It will show you how to split a mesh into submeshes (or how to alternatively delete these parts of the mesh).

What are submeshes?

For more information about this see Submeshes, Materials and Chunks and the section Submeshes in Blender

To learn how you can use them for appearance management, check Chunkmasks: partially hiding meshes

Guide: Splitting off submeshes

Prerequisites

You have the Wolvenkit Blender IO Suite and a compatible version of Blender installed.

Importing the mesh into Blender

1. Open Blender and create a new General file.

2. Optional, but recommended: delete everything in the file. In the scene collection in the top right, right click on “Collection” and click “Delete Hierarchy,” as we don't need these.

   
3. Press File → Import → Cyberpunk GLTF and browse to your .glb file.

4. Import the file (default settings).

   

Selecting the right parts

Directly after importing the mesh, Blender will be in Object Mode.

1. Your item should appear in the 3D viewport now. Use the camera controls to the left of the scene collection (or mouse/keyboard shortcuts if you're familiar with them) to get a better view of the item.

   
2. In the scene collection, find the newly-added collection and expand the armature

3. You will see the item's meshes (which correspond to Wolvenkit's submeshes as defined by name).

   • My jacket only has one submesh. Your item might have more.

1. In the scene collection, select all the submeshes of your item

   • click on the first, then shift-click on the last

Edit Mode: making a selection

Now, select the parts of your mesh that you want to split off (or delete). If you have never done that, read the section below before starting, as it can save you a lot of time.

1. Switch to Edit Mode (keyboard shortcut: Tab)

1. Click in the 3D viewport next to your mesh to deselect everything. Use the camera controls to get close to what you want to select. In my example, it's going to be the entire collar.

2. Start by selecting a single vertex on the part that you want to get rid of.

3. Press Ctrl + L (select linked)

4. If you're lucky, it will select what you want. If not, undo (shortcut: Ctrl+Z) and select things by hand.

5. Once you have made your selection, decide how to proceed: either by Splitting off submeshes or by Deleting vertices.

Splitting off submeshes

TODO: This needs a screenshot or two

1. Split your selection (shortcut: P)

2. You will now have (a) new mesh(es) in Blender. Those are your future new submeshes

   • Each will be named original_mesh_name.001

3. Rename each of them, following the naming schema from the original meshes:

submesh_<index>_LOD_1

1. After you have renamed all meshes, proceed to Exporting from Blender.

Deleting vertices

At any point, you can press x and select delete vertices to remove parts of your mesh. In this example, we will delete the entire collar:

Exporting from Blender

After your mesh is edited to your satisfaction:

1. If you're still in Edit mode: change back to object mode (shortcut: tab)

2. The meshes should still be selected.

3. Hit File → Export → Cyberpunk GLB

4. Overwrite the .glb file that you imported, so that you can import it with Wolvenkit. If you are considering to do something else instead: read this first

Now, you can import your mesh into Wolvenkit.