# WKit Blender Plugin: Error messages

## Summary

**Published:** Apr 19 2024 by [mana vortex](mailto:undefined)\
**Last documented update:** Apr 19 2024 by [mana vortex](mailto:undefined)

This page will tell you how to resolve error messages from the [Wolvenkit Blender IO Suite](/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite.md).

### Wait, this is not what I want!

You can also check [Troubleshooting your mesh edits](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/troubleshooting-your-mesh-edits.md) 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

<figure><img src="/files/pQUAxEv7y45AJAd9T3r0" alt="" width="339"><figcaption></figcaption></figure>

## Ungrouped vertices found

This should only happen for meshes with armatures. You can check the screenshot under [#assign-weights-before-exporting](#assign-weights-before-exporting "mention") 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:

<figure><img src="/files/ZvTidhjvf7pCIKM8qGqF" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="/files/V5vNmUyPYfM5oFljPXRS" alt=""><figcaption></figcaption></figure>

## 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](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/on-4k-textures-and-high-poly-meshes.md#quad-overdraw)). 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.

<figure><img src="/files/nWnj8diDtTwMXltTIkcE" alt=""><figcaption><p>Mesh -> Clean Up -> Degenerate Dissolve (Blender 4.2 - 5.0)</p></figcaption></figure>

## Meshes must have UV layers

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

{% hint style="info" %}
For more information on this, check [UV Mapping: texturing a 3d object](/cyberpunk-2077-modding/for-mod-creators-theory/materials/uv-mapping-texturing-a-3d-object.md).
{% endhint %}

Switch to the Data tab and add one:

<figure><img src="/files/muGWmjt9wGtElcK6AoeG" alt=""><figcaption></figcaption></figure>

You should now be able to export, but your material will most likely look funky. To remedy this, refer to [Adding decals](/cyberpunk-2077-modding/modding-guides/items-equipment/editing-existing-items/adding-decals.md) -> [Adding decals](/cyberpunk-2077-modding/modding-guides/items-equipment/editing-existing-items/adding-decals.md#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](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/blender-getting-started/blender-running-python-scripts.md) to delete them:

{% embed url="<https://github.com/manavortex/cyberpunk2077/blob/master/python/armature_cleanup/remove_invalid_vertex_groups.py>" %}

## 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-dont-need-an-armature](#amm-props-you-dont-need-an-armature "mention")

If your mesh is supposed to move with the body, check [#equipment-you-need-an-armature](#equipment-you-need-an-armature "mention")

### 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.

<figure><img src="/files/AIfuk3gpAAcYOx0EAE5L" alt=""><figcaption></figcaption></figure>

### 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](/cyberpunk-2077-modding/modding-guides/items-equipment/editing-existing-items/replace-a-player-item-with-an-npc-item.md) 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.

<figure><img src="/files/f3mfCRHigIWD4YYlYa93" alt="" width="345"><figcaption></figcaption></figure>

## 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](https://github.com/KhronosGroup/glTF-Blender-IO/issues/912#issuecomment-581564314). See [Troubleshooting your mesh edits](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/troubleshooting-your-mesh-edits.md) [Troubleshooting your mesh edits](/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/troubleshooting-your-mesh-edits.md#wolvenkit-finds-too-many-vertices-but-blender-export-is-fine) for how to remedy this.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/modding-tools/wolvenkit-blender-io-suite/wkit-blender-plugin-error-messages.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.