Wolvenkit Blender IO Suite
How the Wolvenkit Blender plugin works
Summary
Published: ??? by manavortex Last documented edit: May 20 2024 by manavortex
This is the landing page for the Wolvenkit Blender plugin. Here, you can find Usage instructions, as well as an overview of its features:
Wait, this is not what I want!
If this is your first time using Blender, you can check out Blender: Getting Started
Under Installing the Wolvenkit Blender Plugin, you can find a detailed install guide
For detailed usage instructions, check WKit Blender Plugin: Import/Export
The plug-in's source code and original readme are on github
If you run into issues using the plugin, you can check WKit Blender Plugin: Troubleshooting
Compatibility
Game version | Plugin version | Wolvenkit version |
---|---|---|
2.0.0 or higher | latest (at least 1.5.0) | |
up to 1.6.3_hotfix1 (but before 2.0) | < 1.5.0 |
The plugin is developed on Blender 3.6 and Blender 4.0. For maximum compatibility, install the same version.
Usage
As soon as you have a mesh or armature selected, the viewport toolbar (keyboard shortcut to hide/unhide: n
) will show you the CP77 Modding
tab:
![](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%252FDqXOe21GAQ2WgW8Un9Xg%252Fblender_plugin_viewport.png%3Falt%3Dmedia%26token%3D1cd206ee-0387-47cb-aa25-fd1e0ad8d78c&width=768&dpr=4&quality=100&sign=861dc90b&sv=1)
Features
Animation Tools
In the animation tools, you can find
shortcuts for playing, renaming and deleting existing animations
shortcuts to add new actions and insert keyframes
You can load one of Cyberpunk's default armatures at any time:
![](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%252F2gm2qwXuuDVeGdX9aFPi%252Fwkit_blender_io_suite_import_anims.png%3Falt%3Dmedia%26token%3D3866d2bb-add0-4983-ba8d-68d54e49fd45&width=768&dpr=4&quality=100&sign=6c25ccd2&sv=1)
If you import an .anims file, selecting any armature will give you the option to play any existing animation:
![](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%252FcjbGnWgrXF7yQvPydyVY%252Fwkit_blender_io_suite_play_anims.png%3Falt%3Dmedia%26token%3D045448fc-1583-48c7-931a-7127a9ae0af5&width=768&dpr=4&quality=100&sign=a57dc57b&sv=1)
Mesh Tools
Transfer Vertex Weights
Lets you transfer vertex weights from one collection to the other (please read the info box below):
![](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%252FRBRQqfWNEmWYJOO5jQP3%252Fwkit_io_suite_transfer_weights.png%3Falt%3Dmedia%26token%3D66f3ffee-145d-4620-8cba-a032d3e2dea2&width=768&dpr=4&quality=100&sign=2891802f&sv=1)
The plugin will transfer weights by submesh name. If your target armature has more submeshes than your source armature, simply create duplicates and rename them accordingly.
For documentation of the autofitter, see the corresponding wiki page.
Modifiers
Lets you change the armature target (the skeleton that'll move and deform your mesh)
Material Export: Hair
Lets you export a hair profile. For documentation, see Hair profiles (.hp)
You can find a guide about at the link.
UV Checker
With the press of a button, you can switch out the currently active material to a coloured and numbered grid for easier UV mapping.
If the UV checker is currently assigned, pushing the button again will restore the original material.
Collision Tools
The collision tools and -generator can
generate of convex colliders with the exact shape of your mesh The number of vertices to sample should be set to match the number set in the .phys file in order to ensure successful export
generate box and capsule colliders with either user specified sizing or sized automatically to match the selected mesh
export edited collision bodies back to .phys ***currently requires a wolvenkit converted .phys.json file
Last updated