WKit Blender Plugin: Error messages

Plugin error messages and how to resolve them

Summary

Published: Apr 19 2024 by mana vortex Last documented update: Apr 19 2024 by mana vortex

This page will tell you how to resolve error messages from the Wolvenkit Blender IO Suite.

Wait, this is not what I want!

You can also check Troubleshooting your mesh edits for less addon-specific mesh troubleshooting

Assign weights before exporting

This should only happen for meshes with armatures.

• Switch to the Data tab (the green triangle)

• If you don't have vertex groups, add one

• If you already have vertex groups, select the one named to the bone closest to your ungrouped vertices

• If you aren't already, switch to Edit Mode (Hotkey: Tab)

• Click the "Assign" button under the vertex groups panel

Ungrouped vertices found

This should only happen for meshes with armatures. You can check the screenshot under Assign weights before exporting for references.

1. Switch to the Data tab (the green triangle)

2. The plugin should have switched your viewport to Edit Mode (if not, do it yourself - hotkey: Tab)

3. Find out which vertices are the problem by moving them around in the edit view

4. In the list of vertex groups, select the armature bone closest to your ungrouped verts

5. Click the "Assign" button under the vertex groups panel

6. Rinse and repeat the process for all submeshes until the plugin lets you export

No armature objects are selected

You are trying to export a pose, but you didn't select your armature. Click on the armature object in the outliner:

No meshes selected

You're trying to export something, but you haven't selected any meshes. Select everything that you want to export in the outliner (top-right panel) - the armature parent will be auto-selected for you.

Degenerate Geometry

Some issues with the geometry can prevent mesh import in WolvenKit.

Zero Faces

Faces so tiny that their surface area is 0 (also bad for performance). To get rid of them, do one of the following:

Fix on export

You can check the "Fix" box in the export dialogue

Degenerate Dissolve

Select Mesh -> Clean Up -> Degenerate Dissolve. This will collapse faces and edges without a surface.

Mesh -> Clean Up -> Degenerate Dissolve (Blender 4.2 - 5.0)

Meshes must have UV layers

For Cyberpunk material assignments to work, your mesh must have UV maps.

For more information on this, check UV Mapping: texturing a 3d object.

Switch to the Data tab and add one:

You should now be able to export, but your material will most likely look funky. To remedy this, refer to Adding decals -> Step 5: UV projection

All faces must be triangulated before exporting

Triangulation means that faces must have exactly three corners.

1. The plugin should have switched the viewport to Edit Mode. If not, do it yourself (Hotkey: Tab)

2. Triangulate faces (Hotkey: Ctrl+T). The default settings are fine.

3. You should now be able to export.

Vertex groups not assigned to a bone

You have vertex groups in your mesh that don't have a corresponding bone in the armature. Run the following Python script to delete them:

cyberpunk2077/python/armature_cleanup/remove_invalid_vertex_groups.py at master · manavortex/cyberpunk2077GitHub

Armature missing

The armature (rig, skeleton) is the thing that makes your mesh move in-game.

If your mesh isn't supposed to move, check AMM props: You don't need an armature

If your mesh is supposed to move with the body, check Equipment: You need an armature

AMM props: You don't need an armature

It's enough to check the "Export as Static Prop" box during export, and the error will go away.

Equipment: You need an armature

You should have an armature in your .blend file because you're importing over an original Cyberpunk mesh. If you don't, you might want to refer to a guide such as Replace a player item with an NPC item and follow the steps.

Open the Modifiers tab (the orange wrench) and repeat the following steps for each mesh:

1. Make sure that there is exactly one Armature modifier present. If there is none, click Add Modifier and add one.

2. Click into Object and select the armature that your mesh is parented to.

Each submesh must have less than 65,535 vertices

If your submesh has >= 65,535 vertices

You need to reduce the vertex count.

If your submesh has < 65,535 vertices

That's due to how the Blender .gltf export works. See Troubleshooting your mesh edits Wolvenkit finds too many vertices, but Blender export is fine! for how to remedy this.