Cyberpunk Substance Resources

Collection of resources for Substance to streamline Cyberpunk 2077 multilayered assets.

What's included?

Substance Designer

• Python script which automatically creates a Substance Designer Graph of each Cyberpunk material file.

Substance Painter

• All base game Cyberpunk 2077 mltemplates converted to Painter materials (only in release version)
• Painter export templates for batch exporting Cyberpunk-style masks
• Painter project template for setting up batch exports
  

---

Running the Substance Designer Python script

1. Download the source code for this repository, or the Cyberpunk SD Script.py directly.
2. Make sure that you have a full WolvenKit Depot generated (Tools -> Depot Generator -> Unbundle Game)
3. Run the following batch script (if you don't have cp77tools, substitute WolvenKit.CLI.exe instead)

@echo off  
For /R "Q:\77.modding\Wolvenkit_full_extract\base\" %%G IN (*.mltemplate) do cp77tools convert s "%%G"  

4. Run Substance Designer and open the Python Editor window. (Windows/Python Editor)
5. From within the Python Editor window, open the downloaded Cyberpunk SD Script.py file.
6. Use the Python Editor to edit the user input section at the beginning of the Python file: The base path and image format must be set for the script to function correctly.
   The script looks for mltemplate files exported to JSON, and raw format textures (.png, .tga, etc.).
7. Press the Run button. (looks like play icon)

---

To-Do List

• Allow color swapping and other adjustments (some complications with Designer API and Painter Dynamic material shader)
• Implement some interoperability with WolvenKit by import or exporting mlsetup data with Painter

Help

Looking for help using this project? Reach out on the Cyberpunk 2077 Modding Discord.

Interested in contributing? Feel free to submit a pull request. Alternatively, reach out on Discord by using the server invitation link above.