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.

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

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.

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
A playlist by the original author

Last updated

#386: Expand visual modding

Change request updated