This is a simple Python app, designed to help you create Mask Maps by combining multiple textures (such as Metallic, AO, Detail, and Smoothness) into a single RGBA image. It’s a powerful solution for optimizing textures in Unity HDRP, where these maps are commonly used to improve material performance.
Download the latest version here
- Drag and drop support for texture files – (Metallic, AO, Detail, Smoothness).
- Automatically resizes and merges the maps into a single RGBA image.
- Supports Unity HDRP conventions – (Metallic in Red, AO in Green, Detail in Blue, and Smoothness in Alpha).
- Supports inversion of Roughness maps to Smoothness – (HDRP needs it).
- Missing channels are automatically filled with black (0) – avoiding broken maps or crashes.
- Path selection for output files.
- Python 3.11+
- Pillow for image processing
- tkinterdnd2-universal for drag and drop
- tkinter for the GUI
git clone https://github.com/cfrBernard/MaskMapWizard.git
cd MaskMapWizard
pip install -e .
# or
pip install -e .[dev]
Note: Using a .venv is highly recommended.
python -m MaskMapWizard
python build.py
pre-commit run --all-files
- Drag and Drop the Metallic, AO, Detail, and Smoothness textures into their respective fields. (If you don’t have a texture for one of the channels, leave it empty)
- Select the Export Path where you want the final Mask Map to be saved.
- Hit Build to create your combined Mask Map.
- Check the Console for messages and updates.
- Support for other engines: Introducing presets for different game engines like Unreal Engine (ORM), with configurable channel order.
- Customizable Mask Map settings: Ability to invert Smoothness to Roughness, select channel order, and tweak other settings for flexibility.
- Advanced Mapping Options: Define exactly which maps go into which RGBA channels.
- Improved UI: A more polished user interface with intuitive features and better error handling.
- This tool is currently Unity HDRP-focused, but it will evolve to support more engines.
- Feel free to contribute by adding engine-specific presets, new features, or bug fixes!
- For additional tips and troubleshooting, refer to the tips & troubleshooting section.
- For more information about the version, please refer to the changelog section.
- This project is licensed under the MIT License. See the LICENSE file for details.
- For additional build informations, refer to the build_instructions file.
For issues, suggestions, or contributions, feel free to open an issue on the GitHub repository.