What is WolvenKit?

WolvenKit is an open-source modding tool for Cyberpunk 2077 and The Witcher 3: Wild Hunt. Our vision is to develop a standalone software which can read and write all REDengine file formats, simplify and accelerate modding workflows, and help you create great mods for great games.

Our current development focus is REDengine 4 with Cyberpunk 2077.

After , you can…

• … dive right in and start

• … read more about the software on the page

• … check out what's new in our

• … learn about support for The Witcher 3 on the

… or join us on .

Quick Links

Websites & Community

Published May 24 2022

<summary paragraph>

Miscellaneous

• Launch Game from WolvenKit Wolvenkit is now able to run Cyberpunk 2077 from the app itself using the 'Launch Game' button, with support for launching either through platforms (like Steam:// gameid links) or from the executable executable, with support for launching with specific commands (e.g. -qualityLevel=Cinematic_RTX).

  • Pack, Install and Launch game is now included as well to quickly pack mod projects and launch the game.

Asset I/O

WolvenKit includes an all-purpose import and export tool for converting assets to game files and vice versa. Our tooling is bespoke allowing for native conversions with extensive options to suit your needs (check Import/Export or find the list of I/O formats for export/import).

Base game and user-generated archives can be browsed on the fly, making game dumps obsolete. Our Asset Browser also features instant preview for assets such as meshes and textures.

Development

WolvenKit is an open-source community developed application. The source code for WolvenKit and other projects can be found on our WolvenKit is primarily written in C# and the GUI uses WPF framework. Anyone can download the source code and build on their own with Visual Studio. If you're a developer who is interested in getting involved, please check out !

File Editor

WolvenKit is built around our RTTI-based file editor. Any REDengine file can be inspected, edited, and saved with the File Editor. The File Editor is also capable of reading and writing in-place buffer data. Game files can also be converted to human-readable json and back for ease-of-use.

Projects

WolvenKit can host virtually all of your required project files inside the Project Explorer. Each project is neatly separated into distinct folders which can be accessed through the application. No more whiplash from constantly navigating your file explorer to switch between projects! Feel free to host all of your assets within a mod project. Source files such as blends, psd, xcf, and more can be placed inside your project tree and opened directly with a double click! WolvenKit works with you by organizing your project files automatically.

UI/UX

WolvenKit is created with the intention of being an all-purpose mod editor. The application interface is designed to help modders keep their sanity by having every tool at their disposal from the main editor. The application is built with a configurable interface to suit your preferences.

Workflows

WolvenKit features a robust build pipeline for handling REDengine assets. Game files can be browsed, extracted, modified, and packed into an archive once again for use in game. WolvenKit can help guide modders along with this process by using our efficient pipelines.

Other

WolvenKit supports Blender for one-click imports of fully shaded Cyberpunk meshes using the Multilayered.mt supershader. Find the workflows here:

Documentation on Legacy WolvenKit can be found on the Legacy WolvenKit wiki at this link.

Now why would you want to do that? 💔

To completely delete WolvenKit portable delete your chosen installation folder, and the REDmodding folder in your users/appdata/roaming/ directory.

To delete the Installer version you can use Windows default Remove Programs or Features tool. You may then manually delete the users/appdata/roaming/REDmodding folder to remove your preferences as well.

What is the Log?

The Log is WolvenKit's internal logging service to inform the user of what's happening under the hood. It also shows output from the File Validation feature, which will check file connections for you.

If something is not working as expected, take a peak into the Log to check for useful information.

Published Apr 06 2021

After a long and hectic development process, we are very excited to finally announce the public Beta release of Wolvenkit for Cyberpunk 2077. That's right everyone, Wolvenkit is no longer a myth! Though there have been many delays, we greatly appreciate the community and our patrons and contributors for sticking by us throughout the development process, and for the hard work by the many programmers, artists, and researchers that have made this whole project possible. So many incredible breakthroughs and discoveries have been made in Cyberpunk 2077 modding thus far, and we are excited to see what the community can do with the new capabilities that will be made available with the release of WolvenKit. Modders will now be able to browse game assets, browse, read, and edit most if not all file formats used by the game, manage projects, and more. As this is only the initial release, some features you may expect are still to come in future releases. By choosing to support us, you will be not only be enabling us to continue to develop Wolvenkit and add further functionality and tools for use by the community, but also gain access to exclusive posts and updates on the development process, as well as private community channels, voting power, behind-the-scenes content, and more. Even the smallest amount can help us to continue / spend more time on developing more tools.

What is the LocKey Browser?

Based on Wkit v. 8.11.0

LocKey is a localization key designed to identify localized text strings. These keys, such as 'vehicle_enter' (which is not only user-friendly but also has a unique ID used typically), are employed throughout the game. Prior to display, these keys undergo localization to match the language setting of your game.

The LocKey browser allows to search for a specific localized text and reveals the corresponding LocKey (numbers) that, when localized, contains the desired text (string).

You can toggle the script manager via Tools -> Script Manager.

It looks like this:

Depot Generator

Tool for building a depot, a collection of extracted game assets to use them in other tools such as .

Summary

This page explains the main workspace within WolvenKit, the one holding the docking windows for the individual .

As of 8.13, Wolvenkit supports the . This means that you don't have to do anything besides configuring your — dependencies will be handled as needed.

What is the depot?

The depot is the folder where Wolvenkit stores anything it needs to export your project files. As of version 8.13, it can handle everything by itself, and you don't need a depot unless you want to browse game data outside of Wolvenkit.

MultilayerMask

You can export and import MultilayerMasks via Wolvenkit.

Audio

How do I use the Blender integration features?

If the Export Materials

Summary

Published: Sep 29 by (credit to for spelling out we needed this) Last documented edit: Sep 29 by

This is the Cool Stuff page — a list of things that you had no idea Wolvenkit could do for you.

What's a Home good for?

Welcome

Where can I submit feedback or bugs?

• Reach out on ! We have a dedicated channel for WolvenKit issues.

The majority of communication about WolvenKit happens on our Discord server. Use the following link to join our modding community.

If you want to follow development, look for help with our tools, or contribute, Discord is the place to be. For help with WolvenKit directly, look for the #wolvenkit-support channel.

Published October 22 2022

WolvenKit 8.7 is a major step forward. New features include support for building REDmods, sound modding, and animation modding. The UI has been fully transitioned to a title menu and toolbar setup. Texture I/O is significantly more powerful and robust. Numerous fixes for bugs, issues, and pain-points have been implemented. Check out the full release notes below.

New Features

• Support for Cyberpunk 2077 game version 1.6 Upgrading to WolvenKit 8.7 is mandatory for game version 1.6 and beyond. WolvenKit should handle new game releases more gracefully in the future.

• Support for REDmod

  • Added options for Building and Deploying REDmods

Changes & Improvements

• Texture I/O has been completely refactored Expect improved performance and versatility for users

• Import/Export arguments are now saved When adjusting advanced import options adjustments are saved per-file. For example if the XBM export format for a specific texture is changed from PNG to TGA, the specific XBM will default to TGA for subsequent exports. This behavior is persistent between WolvenKit sessions.

• XBM import arguments are now exposed When importing XBM files, texture setup parameters are now exposed making the texture pipeline much more powerful.

Fixes

• Fixed crash due to game version 1.6

• Fixed absurd UI layout on first launch by including a default layout

• Fixed raw textures not displaying or showing incorrectly within Preview window

• Fixed exception when generating materials to Depot

What is the Nightly?

The Nightly is Wolvenkit's Alpha/Beta version. Releases are build every day when the code changes (traditionally during the night, but this is CyberPUNK), so you will always have access to the latest and hottest features.

Naturally, the Nightly will have more bugs than the stable version — but you should use it regardless, because we need help catching those bugs.

For more information on this, check How do I report bugs?

How do I install it?

Download the portable version:

Then, extract the downloaded .zip file into a folder on your hard drive (for example, C:\Cyberpunk2077Mod\Wolvenkit_Nightly) and start it. Done!

How do I report bugs?

Is it a regression?

Double-check the bug in your stable install. If if works there, but doesn't work in the Nightly, then it's a regression (something that used to work but got broken).

If it's broken in both places: congratulations, you've found a new bug!

Reporting a bug

1. Head to the "Issues" section of (you need a github or Google account; they will not send you spam)

2. Click the "New issue" button

3. Select the type of issue you are reporting (probably "bug report")

4. Give a description of the bug, including the following information:

Summary

Created by @JJTurtle Published October 22 2022

Updated Jul 30 2023 by

This guide is intended for the beginning modder, who is still learning, and wants step-by-step instructions on how to fully install and configure their modding tools and asset depot.

To keep things simple, the recommendations in this guide will centralize many of the modding applications, assets, and related resources.

Requirements

Prerequisites

1. Hard disk space for the Depot:

   • For regular operations, <5GB storage will be enough

   • If you want to extract materials and meshes, you should have at least 15GB storage

We goin' in?

First, install Wolvenkit:

Then, we'll start with :

Let's configure and set up Wolvenkit and all its plugins:

Then, we unbundle those game assets that we need…

Now we're goin' in.

We do that by creating a tiny mod to make sure everything worked OK.

Feel free to skip this step, or hit up the and get cracking.

Basic Troubleshooting steps

.NET

The different libraries in Wolvenkit require both and . Make sure to install both!

Clean reinstall

Remove everything inside your Wolvenkit install folder, then download the latest release from github and extract the files into your empty directory.

If that doesn't solve the problem:

%Appdata%

You can find Wolvenkit's settings (including your project layout) in the following folder:

Maybe something here will help you resolve that error.

Get in touch

If these (admittedly basic) steps didn't help you resolve the issue, you can get in touch on the in the #wolvenkit-support channel.

Summary

Created: Dec 03 2024 by Last documented update: Dec 03 2024 by

This page describes Wolvenkit's Editor Difficulty Mode.

Where to change it

To change the default, head to Wolvenkit's

To switch it in-editor, use the dropdown in the upper left corner of the .app

Easy

Recommended for beginners. Many properties that you won't want to edit are hidden, other properties that you shouldn't edit are write-protected.

Default

Should show all properties that you realistically want to edit for regular use cases. Autogenerated properties are write-protected, irrelevant properties (e.g. platform) is hidden.

Advanced

The authentic editing experience from <= 8.14. Rawdogging CR2W without protection. Use at own risk.

Summary

Created: Jun 17 2024 by Last documented update: Jun 17 2024 by

Launch Profiles

You can set up different profiles to launch Cyberpunk 2077 from inside Wolvenkit. Via Launch Profiles, you can select what should happen when you press the button.

Configuration

Where to configure

With a long click on the Install button, you can open a dropdown menu that lets you pick a launch profile:

Available options

Create Backup of previous build

Create zip file

Same as the button in the toolbar: Will generate a zip file ready for Nexus upload.

Install to Game directory

Installs your mod to your Cyberpunk 2077 directory

Clean before build to prevent errors

Clears the packed directory before building. Not doing this may lead to leftover files in the resource directories or have other side effects, so you'll want to keep this checked.

Clean after build to save disk space

Clears the packed directory after building/installing/creating a zip file. Check this to save diskspace, but note that it will disable .

Pack as REDmod

Check this to pack your mod as REDMod rather than as a legacy mod. You don't generally want this, as it can lead to load order issues and increase your users' demands for support.

Deploy as REDmod

Check this to deploy your mod as REDMod rather than as a legacy mod. You don't generally want this, as it's not compatible with

Launch Game

Launch the game after installing the mod. Without this, the next three options will do nothing.

Load last savegame

When you start the game, it will load your last savegame (by timestamp).

Load specific savegame

Loads a specific savegame by name (or tries to).

Game Commandline Arguments

You can specify additional , which will be merged with those from the settings

Default profiles

WolvenKit will create the following profiles if it can't find them:

• Install

• Install as REDMod

• Install, Launch, and Load Save

• Install and Launch

To disable this behaviour, go to the and disable

The Quest Editor is designed to work .questphase files. It enables a node-based workflow: you select a node on the graph editor to edit and inspect its properties.

Right-click context menu

Common actions:

• Duplicate Node: Creates an exact copy of the selected node, including all its properties, but with a new unique ID and no connections.

• Detach Node: Removes all incoming and outgoing connections from the selected node.

• Delete Node (Soft Delete): Replaces the selected node with a special '' node. This is the default deletion for any signal-stopping node such as a PauseCondition, Choice, etc. This is the recommended way to remove such nodes from quests that have already been published, as it prevents users with existing saves from getting stuck in a signal-stopping node.

Unique actions:

• Recalculate Sockets for Phase and Scene nodes: syncs new in/out sockets created inside a Phase or Scene.

• Add Output for Randomizer node: creates a new output node on the Randomizer node

• Add Case for Switch node: creates a new switch case output + condition pair

Shortcuts

You edit the settings for Wolvenkit.CLI by editing appsettings.json in a text editor.

Runnning Wolvenkit.CLI settings will open that for you.

Property Documentation

As a rule of thumb, the settings correspond to their names in the Wolvenkit UI in CamelCase.

Example settings file

An example file (as of PL) can look like this:

The supported arguments can be found in the Wolvenkit repository for both and .

What is the Tweak Browser?

Based on Wkit v. 8.11.0

The Tweak Browser lets you to search for various elements. For instance, you can utilize the TweakDB Editor ⇗ in CET to locate a weapon record ⇗, then use the identified name to search for the entry in the Tweak Browser in WolvenKit. Once found, you can right-click on the tweak and select 'Add TweakXL Override', once done that you'll create a .yaml file with the tweak array structure.

Converting files to JSON will serialize their content to a .json file in your project's raw folder.

Importing them back will re-create the corresponding file under archive.

This is easiest way to and a perquisite for several modding workflows.

Export as JSON

This option is in the right-click menu:

Import as JSON

This option is in the right-click menu:

The following formats are supported by WolvenKit for imports and exports

• mesh ↔ glb/glTF Rigged and static 3d models can be converted to and from REDengine. For a detailed guide, see . Our I/O supports simple non-targeted skinned meshes for extreme efficiency. Advanced methods support multi-mesh, multi-rig, and material embedded meshes. Meshes with embedded morph targets are automatically included as shapekeys. WolvenKit can also export to virtually any 3d format (non-natively) through the built-in renderer Ab3d. You can read more about Ab3d here.\

• xbm ↔ png, tga, dds, jpg, bmp, tiff Textures can be converted to and from REDengine. For a detailed guide, see .\

• mlmask ↔ png, tga, dds, jpg, bmp, tiff REDengine mlmask files can be exported as an array of textures. These texture arrays can be encoded as a new mlmask with a bespoke masklist helper file. For a detailed guide, see .\

• wem ↔ wav, mp3 Audio files can be converted to and from REDengine. Use the Sound Modding Tool to import new audio.\

• morphtarget ↔ glb/glTF (experimental) REDengine morphtargets can be exported to glTF format. The morphs can be viewed as shapekeys/blendshapes with a 3d package. glTF files can be used to recreate morphtarget files, however only one morph is preserved.\

• anims ↔ glb (experimental) Animation files can be exported to glTF format. To import a .glb file as animation, switch Target File Format to anims in the export settings. You can find a detailed guide about this process . \

Summary

This page contains information on the general use of Wolvenkit's command line interface. For more specific information, please see the corresponding sub-pages:

• Settings

Help

• Display general help/list all commands: --help

• Display help for a specific command: archive -h

Using WolvenKit Console globally

You can now install and update the Wolvenkit Command Line Tools (wolvenkit.cli) as a dotnet global tool. The console can be used anywhere directly from the command line, with no custom installation, and easy update.

Open command prompt/powershell and type in:

dotnet tool install -g wolvenkit.cli

WolvenKit Console can now be run from anywhere using CMD/Powershell:

wolvenkit.cli uncook -p "D:\SteamLibrary\steamapps\common\Cyberpunk 2077\archive\pc\content\basegame_1_engine.archive"

For updates to WolvenKit console, open CMD/Powershell and type:

dotnet tool update --global wolvenkit.cli

Video Guide for launching CLI

Processing files in bulk

To process multiple .archive files (for e.g. extracting duplicate textures), write yourself a batch file:

Published Oct 03 2021

WolvenKit 8.4 brings major quality-of-life improvements in a relatively small package. Additions to file I/O, browsing user-generated mods, and new options for editing W2RC files can dramatically streamline some modding workflows.

What is the Properties viewer?

The Properties Viewer is used to provide extra information about selected files from within the Asset Browser or the Project Explorer. The Properties Viewer can also generate instant previews for REDengine texture and mesh files.

Created: Dec 03 2024 by Last documented update: Dec 03 2024 by

This page will tell you about keyboard shortcuts and nifty tricks that make working with Wolvenkit easier.

Project Browser

The context menu in the project browser reacts to Shift and Ctrl, making other operations available. Check it out!

Unlike music and voice-overs, sound effects in Cyberpunk 2077 are stored inside .opuspak files, which are described by a single sfx_container.opusinfo file.

Wolvenkit is scriptable using javascript and its internal API. With it you can automate tasks such as exporting, as well as make changes to files programmatically.

Adding Scripts

WolvenKit is made possible by the community

All aspects of WolvenKit are created by incredible community members. Many members of the RED Modding community donate their time and effort to engineer tools, applications, and support for modding for REDengine. We want to acknowledge the hard work and generosity of our contributors that make WolvenKit what it is today.

What is the WolvenKit Console?

WolvenKit Console is the core "Modkit" that drives the WolvenKit application. The Console supersedes the original CP77 Tools application created by rfuzzo. The same core functionalities of WolvenKit are available from command line for simplicity and extendibility for power users.

• For a documentation of the individual commands, see

Exporting

1. Extract the textures with uncook -p into a folder of your choice. TGA is recommended for CLI version 1.5.1 (latest).

What are long filepaths, and why do I need them?

In the year of our lord 2025, Windows does not (by default) support file paths longer than 256 characters — and if you're somebody who likes to use subfolders, this

Interested in contributing code?

Please do! Fork the project and please commit your changes in small incremental steps with descriptive messages. Code quality is not the biggest concern but refrain from simple mistakes. It's a good idea to create an issue when implementing a feature so people don't work on the same feature/issue in an asynchronous manner.

• Join the for active development

A comprehensive list of jargon you might see on this Wiki or around our community. This glossary is not alphabetical, so be sure to use your browser search function to find what you're looking for. (CTRL+F for most applications)

General

Section Brief

Configure the WolvenKit (wkit) application and MlSetupBuilder (mlsb), and make sure the Asset Browser loads the game's assets.

Configuring Wolvenkit

If your Wolvenkit is already configured (because you have followed the ), then you don't need to do anything here.

Otherwise, please do that now or use the to configure Game Executable Path and (optionally) Depot Path.

Installing Plugins

1. In Wolvenkit, click on

2. Click on

3. REDMod should already be installed. If it isn't, please follow the instructions .

4. For every other plugin, click Install

1. Now that all plugins are installed, you can configure (but read the blue box first). This step is optional; you don't need to do it at this time, but you won't be able to make full use of the plugin if it is not configured.

For detailed configuration instructions, head to -> ->

Testing

Let's make sure that your game path is configured correctly and that Wolvenkit can access the files:

1. Click on Continue to Editor
2. Open the Asset Browser

1. After several seconds, a success notification will appear and the asset folder structure will appear on the left. This means WolvenKit was able to access the Cyberpunk archive and extract the game assets.

Congratulations - everything is working! If you haven't done this during the full prep, now is a good time to . Otherwise, you can move on to !

As of version 8.11.1, Wolvenkit offers the following plugins:

Cyber Engine Tweaks

One of Cyberpunk's core mods (wiki | Nexus page). Will install the latest version for you.

Documentation about using and developing with CET can be found in the wiki.

Redscript

Another of Cyberpunk's core mods ( wiki | ). Will install the latest version for you.

Documentation about development with redscript can be found in the wiki.

MLSetup Builder

Written and developed by Neurolinked (): A tool for Cyberpunk-specific "texture" editing.

Documentation can be found on under

Wolvenkit Resources

This plugin is necessary to use the 's context menu functionality of "find used files" and "find files using this". It provides the information that Wolvenkit needs to connect those files.

RedMod

CDPR's official interface for modding.

Check the yellow wiki for documentation:

Red4Ext

One of Cyberpunk's core mods (). This will install the latest version for you.

It is necessary as a requirement for e.g. ArchiveXL and TweakXL.

TweakXL

One of Cyberpunk's core mods (). This will install the latest version for you.

For documentation, check ->

RedHotTools

Will install the Wolvenkit plugin of for you.

For install and usage documentation, check ->

The Scene Editor is designed to work .scene files. It enables a node-based workflow: you select a node on the graph editor to edit and inspect its properties.

What do the tabs mean?

The Scene Editor is designed for a node-based workflow: you select a node on the graph editor to edit and inspect its properties.

The first tab is the Node Properties tab where properties are dynamically shown and edits are synced with the Graph Editor

Here is a breakdown of the other tabs:

• Actors & Props: This tab displays the definitions for actors, props, and other entities that are physically represented in the game world. Use this tab to add new actors or check existing actors in a scene.

• Logic & Flow: This tab provides a global view of the logic and flow-control elements for the entire scene. This includes collections of data such as EntryPoints, ExitPoints, and other structures that define how the scene starts, ends, and progresses.

• Dialogue: This tab contains the scene's entire dialogue repository. It provides access to the scene's embedded LocStore (localization strings) and actual localised ScreenplayStore (screenplay data), which include all dialogue lines, player choices, and associated metadata for the whole scene.

Right-click context menu

Common actions:

• Duplicate Node: Creates an exact copy of the selected node, including all its properties, but with a new unique ID and no connections.

• Detach Node: Removes all incoming and outgoing connections from the selected node.

• Delete Node (Soft Delete): Replaces the selected node with a special '' node. This is the default deletion for any signal-stopping node such as a PauseCondition, Choice, etc. This is the recommended way to remove such nodes from quests that have already been published, as it prevents users with existing saves from getting stuck in a signal-stopping node.

Unique actions:

• Add Event Socket: creates a new event output socket on Section nodes

• Add Choice: creates a new choice option socket on Choice nodes

• Add Input: creates a new input socket on logical gates such as And, Xor, and routers such as Hub.

• Add Output for Randomizer node - creates a new output node on the Randomizer node

Shortcuts

This wiki focuses on workflows that are central to WolvenKit. You can find much more knowledge and documentation in the Cyberpunk 2077 Modding 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!

Archives

Required files are contained within these archives

• audio_1_general.archive

• audio_2_soundbanks.archive

• basegame_5_video.archive

• lang_en_voice.archive

Video files

Using , decompress basegame_5_video.archive located at: <gamedir>\Cyberpunk 2077\archive\pc\content.

Once extracted, they can be viewed via as Bink Videos and converted to other formats.

Audio files

can be used to convert decompressed archive audio to .ogg through command line, as well as (both of these tools have Linux versions that can be found ) to get smaller and cleaner files that can be played via other media players such as VLC. can be used for more convenient playback.

To execute conversion: .\ww2ogg.exe "<!AudioFilePath!>.wem" --pcb packed_codebooks_aoTuV_603.bin

A combination of these tools can be found at the which has a command line tool that can be downloaded from the repository or installed through the AUR. It has Linux and Windows support and converts WEM files to OGG without the hassle of the external PCB file or having to run through multiple programs for a clean output.

./wwtools converts all WEMs in the current directory to OGG files ./wwtools wem [input.wem] (--info) will convert the specified WEM to OGG and if the optional info flag is used it will print the information about the file and exit.

Playback through ffmpeg: ffplay.exe <!AudioFilePath!>.ogg can also be used along with its plugin.

Published Jun 28 2021

WolvenKit 0.8.2 brings massive improvements in key areas. Features such as the Asset Browser have been refactored to be more robust and efficient. This build also features the first scalable content pipeline for importing various assets. Be sure to thoroughly read the Release Notes and check the showcase video!

You can find the toolbar below the .

Summary

Published: May 1 2024 by Last documented update: Jan 6 2025 by

This page contains an overview about Wolvenkit's internal error codes and what they mean.

Section Brief

UI/Workflow documentation

This section contains general information and

What is the Asset Browser?

The Asset Browser is used to navigate, search and filter Cyberpunk 2077 game files so you can transfer these to the The Asset Browser eliminates the need for uncooking the entire game installation, as individual files can be pulled directly from archive files.

Summary

This page will show you how to use the Wolvenkit search to find files inside the /.

Wait, this is not what I want!

Published Mar 07 2022

WolvenKit 8.5 ushers in a new era for mod development. The File Editor now supports editing buffers for the .ent and .app formats. Buffer editing opens the doors to countless new possibilities for modders. Virtually all aspects of the UI have been streamlined and refreshed with quality-of-life improvements.

Known Issues

• Some TGA image previews may be incorrect All TGA's exported from WolvenKit will be previewed correctly within the Properties window. However TGA's exported from other applications with bottom left Origin will appear inverted. This is only an issue with the image preview tool with the TGA format. The texture will not be inverted when imported as an XBM.

Asset I/O

What's New

• MLMASK I/O has been streamlined The default format for mask I/O has been changed from DDS to PNG. Additionally mask textures are now placed into a subfolder using the original mlmask file name. When exporting .mlmask files WolvenKit will automatically generate a file within the raw directory. The content of the masklist is automatically generated for convenience. Masklist files now accept absolute and/or relative paths. For example: Absolute Path Q:\projects\Judy\files\source\raw\base\characters\main_npc\judy\textures\ml_s1_001_wa_shoe__judy_masksset.mlmask\0.png Relative Path ml_s1_001_wa_shoe__judy_masksset.mlmask\0.png

Texture I/O

• Default export format is now TGA After careful consideration the Import/Export tool will now export TGA by default. The flow chart below demonstrates the necessity of this change. DDS imports and exports remain unchanged in version 8.5.

• Keep is now disabled by default Starting with version 8.5 textures will no longer be rebuilt by default. Standalone textures that don't require an original XBM will be created instead. There are numerous benefits: - Texture resolution/size will be updated automatically on import - Standalone TGA imports work flawlessly - Checking DDS compression is not necessary - High quality 32bpp RGBA compression is always used The drawback is that standalone textures will not preserve the isGamma boolean. This boolean must be set true for all color texture imports.

• Support for isGamma Standalone texture imports now expose the isGamma boolean, meaning color textures can be correctly displayed as sRGB. The isGamma boolean is set to false by default, meaning the user should manually check the box for color textures. We plan to automate this process with an upcoming patch.

Development

Dependencies

• Upgraded to Visual Studio 2022 Visual Studio 2022 is now required to compile WolvenKit.

• Upgraded to .NET 6 The .NET dependency was upgraded from .NET 5 to .NET 6. Users can download .NET 6 from the following link:

File Editor

What's New

• Support for editing buffers Buffers can now be edited and saved with WolvenKit! Currently .app and .ent buffer editing is supported. All properties can be modified including floats, strings, and paths. This opens the doors to countless new modding possibilities.

• True native file editing WolvenKit is now capable of adding and removing elements of REDengine files within the document editor. Various options for adding or removing elements have been added.

• Improved file handling Numerous quality of life enhancements have been implemented: - An asterisk (*) is added to the file name tab when unsaved changes are present - A confirmation dialogue has been added for closing edited files without saving - A Save As

Redesigned File View

• Tree View replaces List View The left-hand navigation panel now uses a beautiful and intuitive tree view. Tree view elements are organized in a sensible way, rather than a flat list.

• Collection Editor has been removed The Collection Editor introduced with version 8.4 has been removed. The right-hand properties panel now displays editable-content efficiently without a floating window.

• Default engine values are now displayed Properties that are not written to file display REDengine default values. These values are automatically inserted by the game at runtime when left unset. Inherited default values are marked with italic font and darkened text.

Fixes

Miscellaneous

• Fixed bugged mesh previews for new installations of WolvenKit

Mod Projects

• Packing and Installing have been separated into separate actions Pack Project - Compiles mod project without installing (New) Pack & Install - Compiles mod project and installs to Game Directory

• The tweak directory folder structure is preserved Any user-created folder structures for tweaks are preserved by the WolvenKit installation process. Tweaks and folders are installed exactly as they appear within the tweak project directory.

UI/UX

Project Explorer

• Added filtering to Project Explorer The Project Explorer can now be filtered by directory. SOURCE | All project directories (default) archive | Archive directory raw | Raw directory scripts | Script directory tweaks | Tweaks directory PACKED | Internal WolvenKit folder for mod deployment. Can be used to install extra files.

• Added flat file view to Project Explorer A flat file list toggle button has been added to the Project Explorer which displays all project files in a simple alphabetical list without folders.

Miscellaneous

• WolvenKit mod projects (.cpmodproj) can be opened directly Mod projects can now be opened natively from Windows Explorer. The WolvenKit installer will automatically assign mod projects to be opened with WolvenKit. For WolvenKit portable, double-click any .cpmodproj file from Windows Explorer, then locate wolvenkit.exe.

• Replaced Ribbon with menu bar (optional) Added a streamlined menu bar as an alternative to the Ribbon. Moved contextual actions to their respective editors.

• Streamlined Home view The Home page has been restyled and refined further. A new transition effect has been added when switching to Home.

What is the Project Explorer?

The Project Explorer is primarily a tool for organizing and navigating mod project files. The Project Explorer gives a constant tree view of all mod project files which streamlines the modding workflow significantly. There are four main WolvenKit directories inside the Project Explorer.

Project Explorer Tabs

You can switch between different tabs at the top of the project explorer (see the red arrow on the screenshot below). Their function (and content) will be explained in the next sections.

Archive

Only shows you files under your_wolvenkit_project/source/archive.

Contains files that will be bundled into your mod's .archive file. For more information, check the documentation under ->

Raw

Location: your_wolvenkit_project/source/raw.

Your (dirty?) working directory. Contains files that will not be part of your mod, as well as exported files. For more information, check the documentation under ->

Resources

Location: your_wolvenkit_project/source/resources

Contains control files for your mod. For more information, check the documentation under ->

Source

Location: your_wolvenkit_project/source

Will show you everything under your project's source folder. No context sorting.

Using the Project Explorer

WolvenKit features a bespoke which is capable of opening and modifying any REDengine file. Double-click any file within the archive directory of the Project Explorer to open the document viewer. Non-REDengine files which are typically stored in the raw directory can be accessed with the Project Explorer as well. Files such as blend, psd, png, and many more can be opened with the preferred system application. For example, double-clicking a .tga file will open the file with the users system preferred image application.

Any file within the Project Explorer can be moved by dragging and dropping. Additionally files can be copied by holding Control while dragging and dropping.

Context Menu

Right-click any file within the Project Explorer to explore the Context Menu.

Open in MLSetupBuilder

Requires MLSetupBuilder plugin for WolvenKit. Install by navigating to the Toolbar panel.

Export to JSON/Import to JSON

Writes any REDengine file within the archive directory to human readable JSON format, as a mirrored file within the raw directory. JSON files can then be modified and converted back to REDengine format from the context menu by right-clicking the JSON file.

Delete

Moves any project file to the OS/system Recycle Bin.

Rename

Opens a dialogue box which allows any project file to be renamed.

The Update in project files option will make WolvenKit update all references in your source and resources folder.

Copy

Select any project file to be copied.

Paste

Pastes copied project file.

Copy relative path

Copies the selected file path to OS/system clipboard, trimming off all folders outside the game directory. Extremely useful for modifying paths while using the File Editor.

Replace with original

Replaces the selected file with the original unmodified version from the game archives. (archive directory only)

Open in File Explorer

Find the selected file with the OS/system file explorer.

Filtering

The Project Explorer can be filtered by directory.

SOURCE | All project directories (default) archive | Archive directory raw | Raw directory resources | Mirrors the game directory, use it to place additional files PACKED | Internal WolvenKit folder for mod deployment. Will be wiped before packing the project! Additionally the rightmost hamburger-style button can be used to toggle a flat file list without folders.

Summary

Created: Sep 01 2025 by mana vortex Last documented update: Sep 01 2025 by mana vortex

This page documents the editor menu bar.

Editor Mode

Here you can toggle the . Please see the corresponding wiki page for details.

Search Bar

There's a search bar on the right side of the editor, which will search through all nodes in the tree:

Materials

Only visible in .mesh and .mi files.

Copy materials from other mesh

Only visible in .mesh files. Lets you copy appearances, material definitions, and materials from a different file.

You have the following options:

• From ArchiveXL patch mesh: Requires the mod to be installed. Will read the .xl file and find the corresponding patch mesh, then copy all materials and definitions. This does not work if you custompathed your file already.

• From project mesh: The dropdown lets you select a project mesh

• Enter by hand: Put a depot path here. Order of evaluation is project files > mod files > game files. If you have multiple mod files at the same depot path, the first match will be used.

Generate missing materials

If you have chunk materials that do not yet have material entries, you can use this button to generate localMaterialInstances for them.

Toggle "EnableMask"

Only visible with one or more materialEntries selected. Will toggle IsMasked flag for all of them.

Toggle "IsLocalInstance"

Only visible with one or more materialEntries selected. Will toggle IsLocalInstance flag for all of them.

Add material dependencies

NPV modders love it: This button collects all required .mi files and textures into a directory in your mod, then updates the internal paths. made easy!

Clean up

Only visible in .mesh, .json, .app

Mesh files

Delete unused materials

Hold Shift for Clear all materials (for ArchiveXL material patching)

Run this directly after you deleted appearances. Will delete material definitions and materials, adjusting the index properties.

Convert preload materials to local

Only visible if you have materials in preloadLocalMaterialInstances or preloadExternalMaterialInstances - will move them to materials.localMaterialInstances instead.

Delete chunk by submesh index

If you deleted a submesh in Blender, use this to remove all the corresponding chunks (e.g. you deleted submesh_02 out of 11)

Adjust submesh counts

Useful for cleaning up those ancient template meshes: this will make sure that the chunkMaterials of each appearance will have an entry for every submesh. This will ignore empty chunkMaterials - use to expand)

App files

Delete unused animated components

Will remove animated components that aren't used as skinning or parentTransform by other components

Find unused files in project

Does the same as Project -> Clean Up -> Find Unused Files, but will only consider file extensions that can be used in .app files (.mesh, .rig, .animgraph, .morphtarget). Will let you find those backup files you forgot to delete.

JSON files

Delete duplicate entries

Will delete translation entries that have the same secondaryKey.

ArchiveXL

Only visible in .mesh files.

Un-dynamify appearances

Will un-do the effect of . This is useful for NPVs and personal ports.

Clear chunk materials

Deletes the chunk materials for multiple selected appearances (quickly convert something to )

Convert hair to CCXL material

Convert a vanilla hair mesh to be CCXL-ready. You should have the corresponding .mi files in your project already.

Appearances/Components

Only visible in .app and .ent files

Generate CRUIDs in selection

Regenerate visual controllers

Regenerates the visualControllers array. This is required for e.g. vehicle mods.

Regenerate resolved dependencies

Regenerates the resolvedDependencies array. Use this to make the game preload the files in your mod.

Edit Components -> Change mesh component properties

Only visible in .app files

Quickly edit component properties over multiple appearances:

Edit Components -> Create new component from existing

Only visible in .app files

Create a new component by duplicating an existing one across multiple appearances. You can use after.

Delete... -> Delete component by name

Only visible in .app files

Delete a component across multiple appearances.

Clear PartsOverrides

Only visible in .app files

Deletes everything in the partsOverrides array.

Clear PartsValues

Only visible in .app files

Deletes everything in the partsValues array.

Connect to .ent file

Only visible in .app files

Registers all appearances in the .app file in the selected .ent file. You can use that to quickly update your NPV entities.

Force LOD level 0

Change all components to be always visible.

Change facial animations

Only visible in .app files

Change a characters's facial animation setup by picking from a dialogue.

Generate CRUID(s)

Generates new CRUIDs for all components in the selection / for all nested components. The game tells things apart via name and id, so if your stuff isn't unique enough, consider running this.

File Validation

Run WScript

Will run script on the active tab

Find broken references

Will scan the current file for broken references (depot paths that are neither in the game files nor in your project)

Summary

Last documented update: Jun 17 2024 by mana vortex (Wolvenkit 8.14 Nightly)

This page documents Wolvenkit's settings menu, and what the individual entries mean.

TL;DR

You must make sure that your Game Executable Path is set. Wolvenkit will not work otherwise.

Settings: Overview

For a textual explanation of the seettings, see

Cyberpunk

Game Executable Path

The path to your Cyberpunk2077.exe , inside under bin\x64.

Launch Command

The path to your Cyberpunk2077.exe , inside . Will be auto-generated from .

You can also put the path to the REDLauncher here, if you want that (but why would you?)

Launch Options

Arguments for the executable. You can find a list in on the page.

Depot Path

The Depot Path is a WolvenKit system folder for caching game assets. It serves as a cache for mesh exports with materials. WolvenKit builds a repository of visual assets within the Depot for usage with external applications such as MLSetupBuilder or Blender.

By default, it is set to C:\Users\yourusername\AppData\Roaming\REDModding\WolvenKit\Depot, but you can pick any location. It does not need to be on an SSD, although Wolvenkit might load faster if it is.

Learn more about the .

Additional Mod Directory

A directory for .archive mods outside of your game directory, for example for resources that you want to load for multiple projects. Mods inside this folder will show up in the after your installed mods.

Display

Show CName hashes as hex

Display hashes for CNames as hexadecimal (rather than decimal)

Show ResourcePath hashes as hex

Display hashes for ResourcePaths as hexadecimal (rather than decimal)

Show NodeRef hashes as hex

Display hashes for NodeRefs as hexadecimal (rather than decimal)

Show TweakDBID hashes as hex

Display hashes for TweakDBID entries as hexadecimal (rather than decimal)

Show reference graph

Game language used for LocKeys

Lets you customize the language for the . Default: en_us

Show Graph Editor Node Properties

Graph Editor: Detailed display?

File Editor

Group Large Collections

Toggles limited collections for improved performance within the File Editor when working when navigating large files.

Group Size

Adjusts the amount of elements of in a limited collection within the File Editor.

Default to Simple Mode

Starting with 1.14, Wolvenkit offers multiple editor modes. You can find details under .

Ignored Extensions

File extensions that you want to open in an external editor

General

Do not check for updates

Will disable Wolvenkit's auto-update

Show Guided Tour

UNKNOWN FUNCTIONALITY This toggle may not work in the latest WolvenKit build.

Update Channel

The update channel determines which type WolvenKit updates are received.

• Stable WolvenKit will only show prompts when new releases are published (recommended)

• Nightly WolvenKit will show the latest development builds which may be unstable