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.

Exporting

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

2. Edit the TGA file with software such as Photoshop or Krita.

3. Choose the textures you wish to repack and copy them to another folder (e.g. MODDED), keeping the subfolder structure (the \base folder needs to be the first folder inside the MODDED folder)

Importing

1. Import

   Run import -p "MODDED FOLDER PATH" -k this will apply the new TGA texture to the XBM.

2. Pack

   Run

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

… or join us on .

Quick Links

Websites & Community

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 or find the list of ).

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.

WolvenKit 8.7

Published October 22 2022

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.

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.

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.

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.

Where can I submit feedback or bugs?

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

• Check out the page to view, track, and submit new issues.

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.

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's a Home good for?

Welcome

Summary

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

Summary

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

This page describes Wolvenkit's Editor Difficulty Mode.

Entity Preview

To be done

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 in CET to locate a weapon , 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.

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.

Depot Generator

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

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

It looks like this:

Adding scripts

Enter a name in the box at the bottom of the panel and click the "Add" button. That will create a new script file in your .

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.

How do I use the Blender integration features?

If the Export Materials checkbox in the mesh export settings is enabled, WolvenKit will create a Material.json file under raw. You can find it in the same directory as the mesh.

Audio

Voice-overs & music

Voice-overs and most music are stored as .wem

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 \

• xbm ↔ png, tga, dds, jpg, bmp, tiff

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.

MultilayerMask

You can export and import MultilayerMasks via Wolvenkit.

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:

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.

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 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")

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 Cyber Engine Tweaks 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 ->

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

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.

Using the Properties viewer

Mesh Preview

Mesh files can be previewed by selecting them within the Asset Browser or Project Explorer.

Controls

• Hold and drag Left Mouse Button to rotate the mesh

• Hold and drag Right Mouse Button or use Mouse Scroll to zoom

• Hold and drag Middle Mouse Button to pan

Image Preview

Image files can be previewed by selecting them within the Asset Browser or Project Explorer. The image previewer is capable cropping, flipping, and markup. While the markups will not get saved to original file, they can be exported by using the save button.

Audio Preview

Audio files can be previewed by selecting them within the Asset Browser or Project Explorer.

Video Preview

Double click BK2 files in the Project Explorer or right-click them in the Asset Browser

Space to play / pause Esc = End video Use the bottom bar to scrub through the video.

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

See Script Manager -> Adding scripts

Script file path

Any .wscript files you have created or edited will be stored in the following location:

You can delete or edit them via .

Editing Scripts

The editor shows your source code with code formatting and includes code suggestion for the Wolvenkit api.

For questions or suggestions about the scripting interface please visit the #wolvenkit-scripts channel on the .

API Commands

Documentation of the API can be found at

Utility Functions

There is also a utility library called Logger.wscript shipped with wolvenkit that assists with writing messages to the wolvenkit Log. It can be included with the following statement:

it provides the following functions:

Logger.Info(obj)

Prints the supplied object or text in yellow in the log window.

Logger.Warning(obj)

Prints the supplied object or text in purple in the log window.

Logger.Error(obj)

Prints the supplied object or text in red in the log window.

Logger.Success(obj)

Prints the supplied object or text in light blue in the log window.

Logger.Debug(obj)

Prints the supplied object or text only to the log file.

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.

Exporting sound effects

In order to export sound effects, you need to have the sfx_container.opusinfo file in your project. Find it in the Asset Browser and add it to your project.

With the opusinfo selected in the Export tool (if you don't see the file, press Refresh), you should now see the export options on the right.

The important field for us here is "Selected for Export". Click the three dots on the right to open a selection window where you can choose which hashes to export. Click the hash you want and press the arrow button pointing right to add it to selection.

Once you've selected what you want, press Finish to confirm the selection and back in the Export tool press "Export Selected". The sounds you've chosen should now be in the raw folder of your project. You will find two files for each of the sounds, one is origin .opus and the other is .wav. You can usually ignore the .opus file.

Importing sound effects

To import back a sound effect, all you need is the sound file in .wav format with the exact same filename it had when you exported it. It should also be in the same folder (raw).

You can usually leave the default settings as they are. After pressing "Import selected", your project's archive folder should now contain a new modified sfx_container.opusinfo and one or more sfx_container_XXX.opuspak (XXX being a number). The opuspak contains your new sound (and other sounds too).

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!

Drag and drop

You can drag and drop files and folders to move them. Hold the Ctrl key to copy them instead.

Rename and refactor

You can call up the rename dialogue by pressing f2, as long as you have a node in the project browser selected.

If you check the Update in project files? box, Wolvenkit will automatically try to update all references in your project to the new file path.

Copy relative path

The context menu's Copy Relative Path action will show you other options if you hold Shift and/or Ctrl:

Collapse/expand a folder and its children

By holding the Ctrl key when you click on a folder, you can collapse or expand the whole folder and its children.

File Editor

The file editor's context menu and menu bar react to Shift and Ctrl, making other operations available. Check it out!

Difficulty mode

Check for the full documentation.

Delete all but selection

Holding the Shift key while an array element is selected will offer you Delete all but selection instead of Delete selection.

Overwrite with selection

Holding the Shift key while pasting into an array will let you overwrite the current selection with your clipboard.

Holding down the Ctrl key as well will let you overwrite the entire array with your clipboard.

Shift: Recursively fold/unfold

By holding Shift while expanding a node, you can fold/unfold all of its children (and their children) according to specified rules for the most common node types:

Double-Click: Fold/unfold all siblings

Double-clicking a node in an array will toggle the expansion state of all siblings to the expansion state of the node.

f2: Search and replace in selection

You can search and replace in selection by using the context menu or pressing the f2 key.

Clean up

Especially in mesh files, the Clean Up menu is your friend.

Clean up empty submeshes will delete extra chunks from old templates.

Delete unused materials will drop any material entries that aren't used by any of your appearances.

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

• For further instructions on using it, see

Installing WolvenKit Console

As a dotnet tool

For a global install, you can install it as a dotnet tool. Open up the windows command line (Windows+R, type cmd, hit return) or Powershell, then enter the following:

Verify if the installation was successful:

By downloading it from the repository

You can download WolvenKit Console from the Releases page on the GitHub repository ( | ). Select the download starting with WolvenKit.Console.

Extract it to a directory of your choice (for example C:\Cyberpunk_Modding\WolvenKit.Console).

You can run WolvenKit Console from that directory, for example:

To make the command globally available, add the directory to your .

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:

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.

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 can I do with WolvenKit?

The Overview page provides a broad look at what's possible to achieve with WolvenKit.

How do I download WolvenKit?

Follow the instructions on the .

Where can I get help with WolvenKit?

Browsing this wiki is the best place to start! Follow the Getting Started pages, especially the guide for . For additional help from other WolvenKit users, check out our information.

How can I open or browse archive files?

WolvenKit is capable of directly reading the .archive format. Archives do not need to be dumped or exported for use. The Asset Browser is capable of browsing any archive with instant previews for assets such as textures and models. Learn more on the . Do you need help learning how to use WolvenKit? Try following the guide for !

How can I import or export textures with WolvenKit?

WolvenKit is capable of exporting textures to common formats such as TGA, DDS, PNG, JPG, etc. Additionally formats such as TGA and DDS are supported for importing textures. Check the to learn more. Do you need help learning how to use WolvenKit? Try following the guide for !

How can I import or export models with WolvenKit?

WolvenKit is capable of exporting models natively to glTF, and other formats such as FBX through conversion. Additionally the glTF format is supported for importing models. Check the to learn more. Do you need help learning how to use WolvenKit? Try following the guide for !

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.

You can find the toolbar below the .

Toolbar options

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.

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 will break Wolvenkit's mod packing.

We decided to show you a warning at every startup, because

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

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.

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 .

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 !

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 Project Explorer. The Asset Browser eliminates the need for uncooking the entire game installation, as individual files can be pulled directly from archive files.

Where is it?

In the default view (as of 8.11), you will find it pinned to the right side of the viewport.

If it isn't there, check the View menu and make sure that it's enabled.

Using the Asset Browser

Navigation

The left-side breadcrumb navigator can be used to quickly navigate through game directories. Game files are displayed in the right-side panel, in addition to folders. Folders in the file list can also be navigated by double-clicking.

Mod Browser

You can switch the Asset Browser to Mod Browsing mode via button. The will no longer consider base game files and search in your loaded .archives instead.

Wolvenkit will search any installed mods and anything under the . There is no way to browse an .archive file in a different folder — if you insist on doing that, check .

Adding files to projects

• Double-click files to add them directly to the Project Explorer

• To select multiple files hold shift and then left click two separate files. These two files and all files between them will be selected. Right-click any of the highlighted files to open the context menu. Then choose Add Selected Item(s) to Project.

Context Menu

As of 8.11.1, the context menu has the following entries:

Add selected items to project

See above

Open without adding to project

What it says — you can browse a file in the without adding it to your project. Saving (Hotkey: Ctrl+S) lets you save it to disk, though.

Find used files

Will make the Asset Browser display a list of everything your current file is linking to.

Find files using this

Like , but the opposite: will make the Asset Browser display a list of everything that links to your current file.

Browse to asset folder

Will navigate the asset browser to the current selection's path in the game files (if it is a game file).

Copy Relative Path

Copies the selection's relative path to clipboard.

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 in the same file, including all its properties, but with a new unique ID and no connections.

• Copy Node: Copies the selected node to the clipboard. The copied node can then be pasted in the same file or a different questphase or scene file by right clicking -> Paste Node in the target file.

• Goto Node: Navigates the graph editor view and selects the specified node ID

• 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

Summary

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

Wait, this is not what I want!

• To find the game files from an item's code (e.g. Items.Q005_Johnny_Pants), please check on the yellow wiki.

Wolvenkit's search bar

You can use the search bar at the top of the asset browser to search the game files:

To search in your currently installed mods instead, switch to Mod Browser:

Operators

You can chain the search operators below with the > character, which will run the results of the first search through the second search.

Examples:

Let's get to the meat of the matter.

By archive

This is mostly useful for the mod browser, as it allows you to e.g. retrieve files from your other mods without switching projects or digging through your mod directory.

Use the archive switch to show only files in a certain archive (name or path):

By full / partial path

Full

This is the default search behaviour, and you don't need to include these operators.

Search will only show you files under this path.

Partial

To limit your search to a certain folder, you can put the folder path and the search term:

You don't need to include slashes. These search terms below will yield the same results:

File Extension

You can limit your search to certain file extensions:

Hash

If you only know a file's hash, you can still search for it:

Or

You can search for multiple terms by using the | operator:

Not

You can exclude terms from the search by prefixing them with !:

Regular Expression

Wolvenkit lets you search for regular expressions. The main limitation is that you can't use spaces:

.* will work by default.

Section Brief

UI/Workflow documentation

This section contains general information and workflow documentation about importing and exporting files with Wolvenkit.

• For a documentation of the UI, check :

  • ->

  • ->

File Structure: the raw folder

When exporting a resource, Wolvenkit puts the exported file into your project's raw folder. In the UI, you can find it in your project explorer:

The relative paths (starting under archive/raw) are the same, as will the file name (without extensions).

These files are connected:

You can import your_file.glb via Import Tool.

These files are not connected:

You can not import your_file_mesh_export.glb via Import Tool, because Wolvenkit won't know where to put it.

Exporting

Wolvenkit knows to ways of exporting files: , or via the .

Exported files will be created in your project's raw folder. The relative path will be the same.

Importing

Unless importing , Wolvenkit can't create files.

When using the , we can only import into already existing containers (see for more information)

The easiest way to do that is:

1. export an existing file

2. overwrite the new file in raw with your changes

3. import the file

Import from JSON

This option is in the right-click menu.

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.

What to do with an error

If you ended up on this page, you ran into a problem that needs to be fixed inside WolvenKit. You now have the following options:

Install the Nightly

If you are on the stable release, you should try . There's a good chance that your problem is already solved.

Update all tools involved

Make sure that you are on the most recent version of whatever tool's you're using. This includes, but is not limited to, the and .

Find support on Discord

Find our and hit up the #wolvenkit-support channel. (If you aren't on the Nightly yet, you should really do that now, because it's the first thing everyone will tell you).

Create a ticket

If your error still happens in the Nightly, you need to tell us about it. It's easy: bugs that don't get reported don't get fixed.

Head to Wolvenkit's github page and (you need a github or Google account, but they won't send you spam).

To fix the bug, we need to watch it in action. Please include everything we need to make it happen — at the very least, we need the most recent log file:

Error code list

0x2000: Type not supported (8192)

WolvenKit ran into a problem during internal conversion. Here's what you can do:

1. Install

2. Re-create whatever file you were trying to work on at that time:

   1. A game file from an earlier patch: Add it to your project again

0x3002: Resources plugin

The may have become corrupted. Open Home -> Plugins and remove it, then restart Wolvenkit, reinstall the plugin, and try again.

0x5000: Invalid settings

You have an unspecified issue with your settings. Double-check them and make sure that everything is configured correctly.

If that doesn't help, remove or re-name your settings file and restart WolvenKit:

0x5001: Invalid Game File Executable

Check your -> and make sure that it points at your Cyberpunk2077.exe. For more information, check the wiki link.

0x5002: Failed to launch game executable

Check and make sure that all your settings are valid. If that doesn't fix your problem, you may have to reset your settings, see for detes.

MTO requirement

You are here because a popup in Wolvenkit told you about Material and Texture Override.

The mod is necessary because Cyberpunk caches all of the base game's .mlsetup files, so your changes won't be visible without it. You can .

To avoid the dependency, you can use .

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.

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!

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.

What are the Import Export tools?

To edit a REDengine file, it first needs to be converted to a more accessible format. This is where the Import/Export tools come in.

Before moving files (or in cases of OCD), please note the section.

As of Wolvenkit 8.9.0, you can find both the import and the export tool in the menu "Tools":

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 first tab is the Node Properties tab where properties are dynamically shown and edits are synced with the Graph Editor. This is likely where you'll spend most of your time in.

Special nodes like a Section node (which are probably the most used node in scenes, used to orchestrate dialogue, animations, workspots, vfx etc) will also show up with a timeline where you can drag, rearrange, and extend events.

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.

Use the 'Add Actor' and 'Add Prop' buttons to add new actors and props to your scene. These buttons automatically create corresponding entries in the actors/props arrays as well as debugSymbols > performerDebugSymbols. After creation, you can rename the actors and define them (for instance you will need to specify how the actor is going to be spawned for the actor to actually work and show up)

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, NotablePoints and other structures that define how the scene starts, ends, and progresses.

When looking at big scenes, it can be useful to look through the entries here to identify the major points in the scene.

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.

Use the 'Add Dialogue' button to add a new dialogue entry that can be used in Section nodes to play dialogue. You will need to provide a Locstring ID and optionally, an embedded text to display within the editor. Once created and before you try to use it, you will need to fill out more details such as the lipsync animation names, speaker, addresee, etc for the dialogue to work.

Similary the 'Add Option' button adds a new option entry that can be used in a Choice node.

Asset Library

This tab serves as a central library for all external assets referenced within the scene file. This includes animations, effects, workspots. Each of these resource also have buttons to add new entries to.

Markers & Metadata

This tab displays misc metadata associated with the scene, including scene category, localMarkers, version, etc

Right-click context menu

Common actions:

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

• Copy Node: Copies the selected node to the clipboard. The copied node can then be pasted in the same file or a different scene or questphase file by right clicking -> Paste Node in the target file.

• Goto Node: Navigates the graph editor view and selects the specified node ID

• 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.

Shortcuts

Summary

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

This page documents the editor menu bar.

Summary

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

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