Links

MLSETUP Builder

Editing item materials

Introduction

MlsetupBuilder is a Cyberpunk 2077 modding tool used to edit and build .json versions of .mlsetup files, allowing easy access to data used to edit different, and special styles for the game models, with 3d viewport to display where the materials are to applied to each part of the model.

Download

MLSB can be downloaded from the releases section on GitHub, the latest release this documentation refers to is the version 1.6.6

Setup of export and preview function

MLSB lets you edit mlsetup files without doing this, but you'll have neither auto-generated mlsetup files, nor previews and material previews.
Before you do this, you should have extracted a partial depot.
This process requires WolvenKit CLI (not identical to normal WolvenKit). ATTENTION: For MLSB versions <= 1.6.6, you need to use WolvenKit.Console Version 1.5.2
Open the preferences via "File" -> "Preferences".
Set the following values:
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"
Wolvenkit Depot Path
You can find this folder in your WolvenKit's settings as "Depot Path"
Wolvenkit-CLI.exe
The executable file under the extracted WolvenKit CLI directory
Uncook Folder and Wolvenkit Depot Path have to be the same folder!
For MLSB versions <= 1.6.6, you need to use WolvenKit.Console Version 1.5.2
Starting with version 1.6.5, adding the WKit.CLI enables the auto-export function, where MLSB will generate an *.mlsetup file when you save an *.mlsetup.json

Library and preview

To take advantage of the Preview function, you need a folder with the meshes in *.glb and the materials and mask layers. This takes about 20GB of disk space
Open the menu "Build" and select first "Repository" to uncook the archives:
For editing material, "Appearance" and "Decal materials" are most relevant, maybe "gamedata" as well.
Click "Uncook". A file selector will open.
Navigate to the same path you set under "Game archives folder", and press OK.
This process can take several hours!
After the process is complete, select "Microblends" to extract the microblends, normals, decals and layer masks.
There is also a dedicated thread on the Cyberpunk 2077 Modding Discord Server with the latest software updates.

Video Guides

Credits to EzioMavericks for the video