Cyberpunk Blender Add-on

The Cyberpunk Blender add-on is designed to fully automate the shader setup for Cyberpunk 2077 mesh files. The add-on integrates with files created by WolvenKit. To learn more about WolvenKit visit the dedicated WolvenKit wiki.

---

Requirements

1. Blender version 3.1 or higher
   https://www.blender.org/
   

2. WolvenKit version 8.8.1 or higher
   https://github.com/WolvenKit/WolvenKit
   

---

Usage

The latest version of the Cyberpunk add-on requires Blender 3.1 or higher. Not all Cyberpunk shaders are currently supported by the add-on. If you're interested in adding support for a new shader please consider reaching out to us on our Discord, Cyberpunk 2077 Modding Community.

Installation

1. Download the .ZIP file from the Releases section

2. Install the Cyberpunk add-on for Blender by navigating within Blender to Edit \ Preferences \ Add-ons \ Install... and locating the downloaded .ZIP file. Be sure the add-on is enabled by marking the checkbox within the installed add-on list.

3. When installed Cyberpunk options should be available under File \ Import and File \ Export

Mesh Import

1. Export a mesh with materials using WolvenKit Learn more

2. Navigate within Blender to File \ Import \ Cyberpunk GLTF and select the exported gLTF/glb file. Within the import options choose the same texture format as the WolvenKit export. (PNG is default)

Entity Import

1. Convert the ent file to json and export all the meshes used using WolvenKit, a wscript to automate this is available on Discord in the wolvenkit-scripts channel.

2. Navigate within Blender to File \ Import \ Cyberpunk Entity and select the exported json file. You can enter the appearance you want in the import options, this requires the appearanceName from the entity appearances info. Enter ALL for all appearances.

Streaming Sector Import

1. Convert the streaming sectors you want to import from WolvenKit as json, and export all the meshes used using WolvenKit, a wscript to automate this is available on Discord in the wolvenkit-scripts channel.

2. Navigate within Blender to File \ Import \ Cyberpunk StreamingSectors and select the wkit project file for the project they were added to. All sector file jsons found in the project raw folders will be imported.

---

About the add-on

This repository was originally created by @HitmanHimself as CP77research to help study and reverse engineer elements of Cyberpunk 2077. HitmanHimself's cp77research contained various modding-related projects and documentation, including the Cyberpunk add-on for Blender. The add-on HitmanHimself created was based on research and initial python implementation by @Turk645. The add-on is now maintained here by the RED Modding GitHub organization to continue support and centralize development.