# Textures: Custom .mlmask ## Summary **Created & Published**: April 12 2023 **by @manavortex** This tutorial will teach you how to create your own MultilayerMask for an item and then assign an own MultilayerSetup to it. Difficulty: You know how to read. {% hint style="info" %} To find out what an MLMask does, see [here](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/materials/multilayered#what-is-the-mlmask).\ To learn about MLSetups, see [here](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/materials/multilayered#what-is-the-mlsetup).\ To learn about [multilayered](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/materials/multilayered "mention"), check the corresponding page. {% endhint %} ## Export the MultilayerMask Start by adding any .mlmask file to your WKit project. It doesn't matter which one, but you can start with this (6 white layers): ``` base\characters\cyberware\player\a0_005__strongarms\entities\meshes\textures\white.mlmask ``` Then, export it via the Export Tool. This will give you the following file structure:

- name_of_your_mlmask_file.masklist    // file containing a list with relative paths to the images
- name_of_your_mlmask_file_layers      // folder containing the images 
  - name_of_your_mlmask_file_0.png
  - name_of_your_mlmask_file_1.png
  - name_of_your_mlmask_file_2.png
  - name_of_your_mlmask_file_3.png
  - name_of_your_mlmask_file_4.png
  - name_of_your_mlmask_file_5.png

## Blender: Painting the MLMask 1. Add the mesh that's supposed to hold your material to your project and [export it](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/3d-modelling/exporting-and-importing-meshes#exporting-the-mesh). 2. Import it into Blender and select the **Texture Paint** perspective. 3. Switch into **Edit Mode** 4. Select those parts of the mesh that you want to color. 5. Duplicate them (Ctrl +D, ESC) and split off a new submesh (P -> Split Selection). 6. Switch back into Object Mode. 7. Select the new submesh; hide the old one. 8. Create a new image. It can be 512x512 for now; only upscale if you find that you can't get it un-pixelated in-game. Most CDPR layer masks are really low resolution!

9. Switch the right viewport into "Texture Paint" 10. Find the "Texture Slots" dropdown in the menu (you may have to scroll) 11. Set `Mode` to `Single Image` 12. Select your new black image from the list below.

12. In either of the panels, set your brush foreground color to white (or gray). This determines the transparency of the layer. I recommend that you use white and regulate transparency via mlsetup, but if you want to paint e.g. clothing folds or wear\&tear, you might want to paint greyscale. 13. Optional: Set these properties under "Options":

14. Paint!

15. Rinse and repeat until all parts of your mesh that should have your material are white on the left-hand image. 16. Now for the annoying part: On the right side, make sure the mask is more or less smooth, as you will see this in-game. Now, save the image: overwrite one of the layers from the mlmask that you have exported. If you run out of layers, you can just add them at the end. {% hint style="danger" %} The game assumes that layer 1 is white, so start exporting over layers >0 {% endhint %}

Do this as often as necessary. ## Import the MultilayerMask Once you're done, open the masklisk and make sure that you have exactly as many entries as you have images in your folder (adding or deleting them as needed). Then, in Wolvenkit, import the masklist via **Import Tool**. {% hint style="danger" %} All images in the multilayer mask need to have the same resolution. Otherwise, it will crash your game. {% endhint %} You can now assign your new Masklisk to your mesh and use it together with custom [MultilayerSetups](https://wiki.redmodding.org/cyberpunk-2077-modding/for-mod-creators-theory/materials/multilayered#what-is-the-mlsetup).

--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.redmodding.org/cyberpunk-2077-modding/modding-guides/textures-and-luts/custom-multilayermasks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.