In Blender, check your shapekey section. It should look like the green box (or be empty).
If it does not, you need to apply any extra shapekeys, because Wolvenkit will ignore them on reimport. Expand the box below, or check here to find out how.
Get the edit out of the shapekeys
Do the following things:
Duplicate your mesh: Select it in Object Mode, then press Shift+D
Click the arrow under the - button next to the shapekey box
Click New Shape from Mix
Now, delete all the other shapekeys (select them and click -)
Delete your new shapekey as well. That will apply it.
In Object Mode, select the duplicate of your mesh (that still has all the shapekeys)
Delete your additional shapekeys. That will reset it to an un-refitted shape. We want only the game ones here!
Go to Edit Mode (hotkey: tab)
Select all vertices (hotkey: A)
Delete all vertices (hotkey: X)
Go back to Object Mode (hotkey: tab)
Select your shapekey-less refitted mesh
Select your empty mesh
Join them together (hotkey: ctrl+J)
If everything went well, you should now have a mesh with Wolvenkit-compatible shapekeys!
Tangents
You get an error message like this:
Message: One or more Geometry in provided GLTF doesn't contain Tangents data. Tangents must be included within glTF files.
Use the Cyberpunk Blender IO Plugin to export
Quick, easy, recommended: the plugin will tell you exactly what's broken and how to fix it. Download it here.
Alternatively, you can check by hand:
Expand if you like to suffer
Check if your mesh is triangulated. If you aren't sure whether or not it is, go into edit mode, select everything, and go to Face -> Triangulate (Shortcut: Ctrl+T)
Check your export settings and make sure that you have the correct box checked upon export:
If the error persists, check that each of your submeshes has an UV map:
If not, you have to create one (and probably UV unwrap your mesh).
Bone: neutral_bone not present in export Rig(s)/Import Mesh
The neutral bone is created by the glb export plugin when there are vertex groups without a parent bone. WolvenKit will not let you import if there is a mismatch.
Your armature in Blender needs to have a bone for every vertex group in the submesh, and there must not be vertices with no vertex group assigned.
The following two scripts help you finding and/or fixing the problem. Switch to the Blender Scripting perspective and create a new, blank text file. Then, toggle the Blender system console to see their output (Blender: Window -> Toggle System Console)
Missing bones
Optional: To find which bones you're missing, you can use this script, which will print their names to console. You can also skip this step and try the troubleshooting below.
You can find a Python script on mana's github that will drop unused bones and vertex groups. Run it in Blender's Scripting Perspective with your armature
Option 1: Fuck those bones: Noesis
You can import the mesh with Noesis, which will not do any of these checks. For that, you need to import/export via .fbx.
Since noesis expects differently-named submeshes under the root armature, you'll want to export the mesh via noesis, join your changed meshes on those under Noesis_Root, and import it again.
Caution: You'll have to rotate your armature in this case.
While this will get your mesh into the game, the missing bones mean that parts of it won't move the way you expect it!
Option 2: The Netrunner suit
The armature from the following mesh has a lot of bones and will often resolve most of your issues:
Try using the Netrunner body as a base for import. You can use Wolvenkit's Select Base Mesh feature for this.
create more submeshes with the correct naming in Blender, e.g. submesh_01_LOD_1, submesh_02_LOD_1
If you end up with missing bones,
Option 3: Transferring bones
It's time to play 3d puzzle and assemble bones from multiple sources. Unfortunately, there is no simple solution for this yet. You need to
find the bones that your armature is missing in other meshes
transfer them into your import target mesh (guide on xbae's page)
export all the extra meshes into Blender
merge their rigs, which you should do with the linked Python script
and finally reimport everything back into Cyberpunk.
Everything else
WolvenKit will not import a mesh that has any kind of issues. Those include, but are not limited to:
non-flat faces
zero faces/edges
loose vertices/edges
There is no guarantee that any of the steps below will actually solve your problem.
Edit Mode
In Edit Mode, you can find a few commands in the Mesh -> Clean Up menu:
Delete Loose
Split Non-Planar Faces
Split Concave Faces
Merge By Distance
If you select your whole mesh, Merge By Distance will merge the individual parts, obliterating the seams. To avoid that, make sure to do them one after another:
- Select a vertex/edge/face in Edit Mode
- hold down Ctrl Num+ to select everything connected
- use Merge By Distance before proceeding to the next part of your mesh
It's still broken
Your last option is the 3d print tool to (hopefully) find out what is wrong with your mesh.
Fortunately, the tool is free, easy-to-use and already included in your Blender.
If you don't have a 3d print entry in the tools of your 3d viewport, you might need to enable the plugin in Blender's settings first.
Use the 3d print tool in edit mode to directly fix your issues
Zero Edges: Those are bad, fix them (click on them, then press X and just delete them)
Non-Flat Faces: Those are even worse, as they can make the game crash. You need to split them up until they are flat, or investigate the surrounding edges/vertices to see what's going wrong here.
Zero Faces: Only fix if you have <100 of them — the tool doesn't always identify them correctly (the mesh analyzed above was h0_000_pwa_c__basehead, which is absolutely fine).
In-Game
My mesh won't show up
In Blender
make sure that you have exactly one UV map
check Face Orientation — most materials won't show backfaces (red). You can import submeshes with the suffix _doubled to make WolvenKit generate them for you, like it does with hair.
In Wolvenkit
When saving your mesh, check the console for errors. In version >= 8.9.0, a basic material validation is taking place.
If you don't see any warnings, make sure that the resource paths in your mesh are correct and that you aren't loading invisible textures.
Parts of my mesh are missing
Do they show up in the Wolvenkit preview?
No: you probably forgot to select them when exporting from Blender. Make sure that you get them all into Wolvenkit.
Yes: There's either an issue with your material assignments or with your chunkmasks. Refer to the corresponding guides to learn how you can debug this.
My mesh won't move at all
Some meshes require an entAnimatedComponent along with the garment's component. Check here for details.
Changes from Blender are missing in-game
For example, you have moved something, but the change doesn't show in the game: this most often happens when you change things around in edit mode, since they are stored as object properties rather than applied immediately.
Select the object in edit mode
Press Ctrl+A
Select "All Transforms" to apply all transformations.
My mesh is moving weirdly
E.g. you've changed a shape, but now everything moves at an offset.
As stated in the importing/exporting guide, it is easy to fuck up the mesh's properties, and this is most likely what happened. The easiest way to "fix" this is to apply your shape deformation to the original object.
Replacing the vertices
Import the original object into Blender, without any of your changes. If you have to, reexport the working file from Wolvenkit.
If you have added the item via ArchiveXL or swapped out an in-game item with something that belongs in a different slot (e.g. a jacket on the head slot), you might have to fix the corresponding entity file.
My shadow mesh is always visible
Check the renderMask attribute inside heder / renderChunkInfos / index. For shadow meshes, there shouldn't be anything but MCF_RenderInShadows.
My mesh ignores my texture edits!
The textures are most likely embedded. Here's how you can force your material to pull in external textures instead:
Thanks to Adahm for the screenshot
Garment Support
My mesh is string cheese/exploding vertices/a puddle on the floor
This section will tell you how to delete garment support. If you don't want that (you shouldn't! It's cool!), check the next section.
Looks like we have guests from beyond the Blackwall
To check if it's this, equip only the edited item. If it breaks as soon as you put on another clothing item with garment supports, then the solution below applies.
Option 1 (likely to work): Import your mesh with garment supports
Option 2 (guaranteed to work): delete GarmentSupport from the mesh
This will break automatic shrinking when you put clothes over your item. But hey, if the alternative is a broken mess…
I'm doing everything right, but garment support still explodes!
Component IDs
Check the component's id in the mesh .ent or .app appearance's components array:
If any given ID is equipped twice, it can break garment support in the way you're observing.
As of January 03 2023, we don't know how these are generated and can't tech the problem away in Wolvenkit. Your only choice here is to manually randomize your ID in a text editor by switching out single digits. Remember that the resulting ID needs to be an even number!
Import settings
Make sure to import your mesh with garment support enabled. If that doesn't do the trick, you can try re-creating the garment support shapekeys in Blender.
If not, you have to create one (and probably UV unwrap your mesh).
