MLSETUP Builder
The tool of your choice for editing multilayered materials
MLSetupBuilder (commonly referred to as "MLSB") is a Cyberpunk 2077 modding tool to comfortably edit MLSetup files, developed and maintained by Neurolinked.
There is a dedicated channel on the Redmodding Discord and a thread on the Cyberpunk 2077 Modding Discord Server, where you can find a chat history full of undocumented features as well as previews from the most recent development versions.
For integration with Wolvenkit, install MLSB as a plugin:

- 1.Click on "Home" in Wolvenkit's title bar
- 2.Select "Plugins" in the left sidebar
- 3.If MLSB is installed, you'll see an "Update" button, otherwise, it will say "Install". Do that.
We will now launch MLSB and do the initial setup.
- 1.In Wolvenkit's Plugin view, click "Open", this will open a Windows Explorer with the install folder (
Cyberpunk 2077\tools\neurolinked\mlsetupbuilder
) - 2.Navigate to the folder with the higest version (at the time of this guide, that is
MlsetupBuilder-1.6.7
) - 3.Start
MlsetupBuilder.exe
- 4.Optional: You can pin that file to your start menu or create a shortcut if you want to launch MLSB directly.
To make the most of MLSB's features, you will want to configure it first. However, you can start using the tool right away.
Here's how (or scroll down for the screenshot):
- 1.In the project explorer under Wolvenkit's
archive
folder, right-click on am mlsetup file This folder will only be visible in the "source" or "archive" tab of your project explorer - 2.Select "Convert to JSON"
- 3.This will generate an
mlsetup.json
file in your project'sraw
folder. This folder will only be visible in the "source" or "raw" tab of your project explorer - 4.Right-click on the newly created
mlsetup.json
file - 5.Select "Open in MLSetupBuilder"

As of Version 1.6.7, this is what you will see now:

Start by importing the file from the preview. That will populate the Layer Config box with the MLSetup that you just loaded.
The preview was hiding an empty 3d viewport. To use that, you will need to configure MLSB first, but you can already click through the individual layers and assign material properties (such as roughness, normal strength, base material and colour) from the "Material Properties" panel.
Don't forget to hit "Apply" after you have changed a material.
Once you're done:
- select File -> Export
- overwrite the original
mlsetup.json
- switch back to Wolvenkit
- in the "
raw
" folder, right-click on your file - select "Import/Convert from JSON"
Congratulations — you now have an
.mlsetup
! If you pack your mod and launch the game, you should now see your changes.This is where you can load models from the game for a direct preview which layer will affect which parts: simply click on the "Library" button.

Here, you can either browse to your model directly, or use text search:

After selecting a model, you can close the library browser again. Now selecting a layer will show you directly which parts of the mesh it corresponds to.

That's it! Happy recoloring!
- 1.In Wolvenkit, extract a partial depot (Generate Materials). Note that this window shows you the Depot Path for Step 5.
- 2.While it is doing that (it may take a few minutes), download WolvenKit Console and extract it to a folder of your choice.
- 3.Now, switch to MLSetupBuilder.
- 4.Select "File -> Preferences"
- 5.Apply the following settings:
Game archives folder | C:\Your\Path\To\Cyberpunk 2077\archive\pc\content |
uncook folder | You can find this folder in your WolvenKit's settings as "Depot Path" (you've seen it in the window from Step 1) |
Wolvenkit Depot Path | You can find this folder in your WolvenKit's settings as "Depot Path" (you've seen it in the window from Step 1) |
Wolvenkit-CLI.exe | The executable of Wolvenkit Console from Step 2 |
- 6.Press Ctrl+R to reload MLSB and make sure that the settings are applied.
- 1.Open the menu "Build" and select "Repository" to uncook the archives:

- 2.Select the following settings (if you want to uncook everything, this step can take several hours, so we'll only do the essentials for now)

- 3.Click "Uncook".
- 4.Wait. Do not interact with the program in any way until the process has finished - especially interacting with the console might just freeze up the entire windows cmd process. This is not MLSB's fault, but due to a Windows standard implementation.
This process can take some time — if you have selected everything, it can be several hours on slow machines. (You should've listened during step 1, choomba ;))
- 5.When the process is complete, close the Depot Generator window.
- 6.Optional: if you can't see any changes, press
Ctrl+R
to relaod MLSB.
- 1.
- 2.In the bottom left corner, hit "Start"
- 3.Wait.
- 4.When the process is complete, close the Depot Generator window.
- 5.Optional: if you can't see any changes, press
Ctrl+R
to relaod MLSB.
You need to install the most recent version. If that doesn't make the error go away and your most recent version is something with 1.6.7, update the interface.js — download it here from Neurolinked's github repository, then replace the file with the same name in MLSB's install directory, subfolder
resources\app\js
. If you have installed it as a Wolvenkit plugin, that directory will be
Cyberpunk 2077\tools\neurolinked\mlsetupbuilder
.Does the progress bar still move? If yes, then you're good - ignore this.
If not, you haven't left your fingers off MLSB and need to start over. Click "Uncook", then go afk until it's done.
Credits to EzioMavericks for the video
Last modified 15h ago