Summary

Created by @Simarilius Published October 15 2022 Last documented update: December 29 2023

This guide will show you how to add animations to a previously exported character. It assumes that you successfully completed Exporting Characters to Blender.

It uses the following versions:

• Cyberpunk 2077 game version 2.1

• Blender >= 3.6 (stable) or 4.0

• Wolvenkit >= 8.11.1 (stable | Nightly)

• Wolvenkit IO suite for Blender >= 1.5.1

Exporting to Blender

So exported characters are cool, but how do we get them out of that annoying A-pose?

We need the rig, and maybe some animations:

• the main body rig

• the head/face rig

We're going to export them, bind everything, and attach the head to the body. (recapitate?!?)

Finding the body rig

You can look it up in the body's entity file. Find it by file name, or right-click on Jackie's body mesh and select "find files using this", then doing the same again on the .app file.

Open up the .ent file and check the components array for an entAnimatedComponent (usually nameddeformations), which lists the rig:

Copy the path under rig and put it somewhere where you can find it later.

Finding the head rig

The head rig is in the same folder as the head mesh.

Naming conventions:

generic:             <name_of_head_mesh>_skeleton.rig
Jackie:              h0_001_mb_c__jackie_welles_skeleton.rig

Right-click on the .rig file and select Copy relative path. Put this with the body rig path.

Re-exporting the meshes

We now need to re-export the meshes we want to use.

The body mesh

In the Export Tool, select the body mesh and adjust its export options. (In Wolvenkit < 8.8, double-click it).

1. Filter by name: paste the file names (or paths) that you saved in the previous step into the empty row at the top of Available on the left

2. Select the rig by name (the same one as in the .ent file)

3. Move it into the Available list

4. Click on Finish to apply your changes

The head mesh

1. Repeat the process above, but use the name of the head mesh rather than the body.

Importing into Blender

Delete the head and body component that you've imported the first time around: we're going to do a reimport. With the Cyberpunk GLTF plugin (File > Import > Cyberpunk GLTF), import both of your files into Blender — the process works exactly like it did the first time, just that there's extra data now.

If the WithRig has worked, you should notice that rather than the mass of unorganised huge bones, you now have a skeleton structure that kinda makes sense.

I normally change the bone display settings of that armature from Octahedral to Stick, as that prevents bones from completely hiding the mesh:

Merging the skeletons

Now, we hook up everything by merging all rigs into one.

1. Rename the head's armature to HeadArmature

2. Rename the body's armature to BodyArmature

3. Switch to the "Scripting" perspective and create a new empty script

4. Copy the script from github and paste it into the document

   1. Optional, if you skipped step 1 and 2 because you like making things complicated: At the top of the script, find ~line 5 head = bpy.data.objects['HeadArmature'], and put the names of your armatures from the SceneCollection tab

5. Click on theBodyArmature in the 3d viewport

6. Run the script

The rigs should merge; the head meshes should be without an armature parent now.

Hopefully it looks something like below, with all the bones selected and just the one green dude in the outliner:

Parenting the other meshes to the armature

For each submesh item, repeat the following steps:

1. Select it in object mode

2. Set the Armature Modifier in the Modifiers tab to BodyArmature

This should snap the item to the body and it will follow with correct weights when animated.

Animations

To find animations compatible with the character you just exported, open up their .ent file and expand the resolvedDependencies:

Alternatively, search for .anim in the asset browser.

Add the animation you've chosen to your WKit project and export it . If you want to use this animation for editing, you need to check Include Root Motion in the export settings.

You will end up with a new .glb file, which you can import into Blender.

Now let's apply it:

1. Select the BodyArmature

2. Switch to the Animation perspective

3. In the panel at the bottom, change the dropdown on the left from Dope Sheet to Action Editor

4. In the dropdown in the middle, select one of the animations you just imported.

5. Click the "play" button

You can keep importing more anim files and the list just grows.

Anyway, cheers Chooms, hope this has been helpful, have fun!

Troubleshooting/reporting:

Most of the animations seem to work flawlessly. Occasionally the process gos screwy somewhere and the model freaks out when you attach the anims. In that case, please open an issue on github or tell us about it on Discord in #blender-add-on.

Please include your .blend file and the full relative path to the animation that was giving you trouble in your report.

This wiki focuses on workflows that are central to WolvenKit. You can find much more knowledge and documentation in the wiki, for example the Modding Guides section:

… or our knowledge base, where you can find documentation like

That's just a small selection, hit up and look around!

Summary

Created by & Published: September 03 2022 Last documented update: November 2024

This guide aims to walk you through finding and exporting a character to blender so that its usable for cosplay or 3d printing or whatever. Guide is using nightly WolvenKit, Cyberpunk add-on for Blender, and Blender 3.6.

This guide uses the following versions:

• Cyberpunk 2077 game version 2.1

• Blender >= 3.6 (stable) or 4.0

• Wolvenkit >= 8.11.1 (stable | Nightly)

• Wolvenkit IO suite for Blender >= 1.5.1

Prerequisites

• You have created a new Wolvenkit project

The character's .ent file

This section will tell you how to find and add an NPC's file to your project. If you already have one (because you're exporting an NPV), you can skip it and go straight to #exporting-to-blender.

Finding the file

Before we can export anything, we need to find the .ent file for the character we want to export. This tutorial will use Jackie, but it works just the same for everyone else.

The easiest way to find a characters ent if their not already in the list on the wiki is to use Red Hot Tools. Once its installed you can simply walk up to an NPC in game and the inspect tab will show you the ent and appearance info you need. With that info you need to find them in wolvenkit.

With our project open in Wolvenkit, we switch to the Asset Browser and search for the right file

jackie

jackie > .ent

This will give us plenty of files — we'll sort them by file extension and scroll to the ent section of the list. jackie_welles.ent looks promising, so we'll double-check if it's the right file:

• Right-click it and select Open without adding to project

• Use the entity preview tab to confirm that it's him

Now, add the file to your project.

Exporting to Blender

With the .ent file in your project, you can run the script that will handle the actual export, adding all the necessary files to your project and exporting them in a way that Blender can process.

Open the Script Manager (Tools -> Script Manager as of Wolvenkit 8.15), find Export_Ent.wscript and run it.

Importing into Blender

Point it to the exported .ent.json in your project's files. For Jackie, the relative path is source\raw\base\characters\entities\main_npc\jackie_welles.ent.json.

Importing a specific appearance

Unless you specify otherwise, the default appearance will be chosen. If you want another, open the .ent file in your project and enter the exact appearanceName into the Blender open dialog.

You can find the appearance name in your .ent file inside the appearances list:

Now, click the Import Ent from JSON button and wait while the Blender plugin does its thing.

Summary

Created by Published May 2023

This guide aims to walk you through finding and exporting a vehicle to blender.

If you'd rather watch a video Boe6 goes through a basic example in the second of his vehicle modding videos . You still have to read below if you want an non default appearance.

Requirements

• or newer

• or newer (hasnt been tested on older)

• or newer

Vehicles have different challenges from the characters, but the is fully up to the task, as long as you give it the right info.

Importing vehicles to blender needs the .ent, .app & .rig files in .json format, along with all the meshes and the main .anim file for the vehicle as .glb. Fortunately, there is a script to do the heavy lifting – and this guide will tell you how to use it.

Once you've added the .ent to your project, you now have two options, of which you can use either:

1. "Find Used Files" from the context menu, then manually add them all to your project

2. Use the script from Tools -> Script Manager -> Export_Vehicle_Ent (the has documentation)

Being lazy people, we naturally recommend the second option.

Get a specific appearance

Otherwise, you need to enter the exact appearanceName into the Blender open dialog. You can find the appearance name in your .ent file inside the appearances list:

Your entity in Blender

In Blender, select File -> Import -> Cyberpunk Entity. You need to point it at your exported vehicle entity – find it in your project's raw folder, it should be the only file with the extension of ent.json.

At this point, you should have a full vehicle. The meshes should be

• aligned to the armature bones

• bound to special bones such as doors etc. via ChildOf constraints

You can find animations in the dope sheet > action editor. If you select the rig, you can select them from the dropdown to play them.

Importing multiple entities at once might be screwy. If you want several vehicles in a scene, import each into a separate blend file, then use File -> Append to merge them.