WKit Blender Plugin: Troubleshooting

If it's not working as expected

Summary

Published: Jan 20 2024 by manavortex Last documented update: Apr 19 2024 by manavortex

This page contains troubleshooting options for the Wolvenkit Blender IO Suite.

If the plugin gives you error messages on export, please check WKit Blender Plugin: Error messages instead.

If you can't solve your problem with these steps, feel free to reach out on Discord in the #blender-add-on channel.

The first thing people on Discord will tell you is to read this page, so you might as well get it out of the way.

Blender errors will show up in the system console window (View -> Toggle System Console).

Version compatibility

Seeing the Blender version

You can see the exact Blender version in the lower right corner of the program:

Seeing the plugin version

You can find the current supported version in the table above (under Version compatibility), or check the github page's release section .

1. Open the preferences from the menu (Edit -> Preferences)

2. Switch to the AddOns tab in the bar on the left

3. In the filter field at the top right of the list, search for cyberpunk

4. Expand the entry and find the Version field

General Troubleshooting

Steam

If you installed Blender via Steam, stay on the stable stream and make sure to keep Blender up-to-date.

Check the console output

See if Blender encountered any errors by checking the console output. From the menu, select View -> Toggle System Console.

Our technical experts will want to see this. If you can't make sense of it via Google or ChatGPT, hit up the #blender-add-on channel on Discord.

Failed to import materials

Please complete the steps in General Troubleshooting first!

Make sure that your Wolvenkit is up-to-date

After updating Wolvenkit, make sure to re-export your .mesh with materials!

Make sure that your Depot is not outdated

The plugin needs your Wolvenkit Depot to a) exist and b) be more or less recent.

If you don't know what that is, or aren't sure how old your depot even is, it might be time to regenerate:

1. From the Tools menu, select the Depot generator

2. Click the Migrate Files button at the bottom and wait until WKit is done

3. Re-export your .mesh with materials and check if your problem goes away

If it does not, you can simply nuke the entire depot, as it will be re-generated whenever necessary:

1. From the Tools menu, select the Depot generator

2. Click the first button (Open Depot Folder) to open the folder in Windows Explorer

3. Delete everything there

4. Re-export your .mesh with materials

5. Your problem should be gone now