WKit Blender Plugin: Error messages
Plugin error messages and how to resolve them
Summary
Published: Apr 19 2024 by manavortex Last documented update: Apr 19 2024 by manavortex
This page will tell you how to resolve error messages from the Wolvenkit Blender IO Suite.
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
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FB9XjMHl3KWKvc6jq2EX9%252Fblender_plugin_ungrouped_verts.png%3Falt%3Dmedia%26token%3D93ac541d-7f20-4c83-92d1-157a6fbc9d3d&width=768&dpr=4&quality=100&sign=5fc8a9b4&sv=1)
Ungrouped vertices found
This should only happen for meshes with armatures. You can check the screenshot under Assign weights before exporting for references.
Switch to the Data tab (the green triangle)
The plugin should have switched your viewport to Edit Mode (if not, do it yourself - hotkey:
Tab
)Find out which vertices are the problem by moving them around in the edit view
In the list of vertex groups, select the armature bone closest to your ungrouped verts
Click the "Assign" button under the vertex groups panel
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:
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FuZms4z0Ys7O9nz4LRX4z%252Fimage.png%3Falt%3Dmedia%26token%3Dac1be2f6-e25f-4587-aea4-117a38f71d70&width=768&dpr=4&quality=100&sign=d99edd9b&sv=1)
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.
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FRtnzJ8Eyy2t39pDDJENL%252Fimage.png%3Falt%3Dmedia%26token%3D8168f9e8-5608-4d23-9758-a106744c1d4b&width=768&dpr=4&quality=100&sign=a63082ef&sv=1)
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:
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252FpzKSrjUYk7Lt4mpn5z00%252Fblender_addon_uv_maps.png%3Falt%3Dmedia%26token%3D79818c08-e741-4a0c-a7ea-9069994bbb4d&width=768&dpr=4&quality=100&sign=c3f52229&sv=1)
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.
The plugin should have switched the viewport to Edit Mode. If not, do it yourself (Hotkey:
Tab
)Triangulate faces (Hotkey:
Ctrl+T
). The default settings are fine.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:
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.
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252Fpi0t4HPiVKJVEYTktVs9%252Fimage.png%3Falt%3Dmedia%26token%3D6962c7f7-9c11-4409-8587-705a3070f329&width=768&dpr=4&quality=100&sign=6847057c&sv=1)
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:
Make sure that there is exactly one
Armature
modifier present. If there is none, clickAdd Modifier
and add one.Click into
Object
and select the armature that your mesh is parented to.
![](https://wiki.redmodding.org/~gitbook/image?url=https%3A%2F%2F1427525421-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F4gzcGtLrr90pVjAWVdTc%252Fuploads%252Fyvan9rqpdWQZdoXp1osa%252Fblender_addon_select_armature.png%3Falt%3Dmedia%26token%3D1fd30e1e-e4ab-4c34-bce3-8675e4be7afd&width=768&dpr=4&quality=100&sign=9e28c328&sv=1)
Each submesh must have less than 65,535 vertices
If your submesh has >= 65,535 vertices
If your submesh has < 65,535 vertices
That's due to how the Blender .gltf export works. The only thing you can do to avoid the issue is to make sure that no two vertices share the same UV coordinate.
switch to the UV editing perspective ( -> UV Mapping: texturing a 3d object)
Turn on UV Sync Selection:
Once you have found an overlapping vertex, select linked (Hotkey:
Ctrl+L
)Move the entire UV island by a whole tile in any direction (Hotkey: e.g.
G
->X
->1
)Repeat the process until there are no more overlapping islands.
Last updated