Skip to content

Latest commit

 

History

27 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎯 Mask Map HDRP Lit - Unity Shader Texture Packer

Welcome to Mask Map HDRP Lit - Unity Shader Texture Packer! 🎨🚀

This tool allows you to create a Mask Map compatible with Unity's High Definition Render Pipeline (HDRP) by combining different textures into a single RGBA image. Now with a modern, intuitive UI and advanced new features!

Mask Map Generator Screenshot
Mask Map Generator Screenshot


🖥️ Unity Workflow

Unity Workflow

From Unity's documentation: Mask Map and Detail Map


✨ Features & Updates

  • Drag & Drop for fast texture loading 🎯
  • Invert channels with a single click ⚡
  • Automatic generation of Mask Maps and Detail Maps 🎨
  • Real-time previews of loaded images 👀
  • Custom resolution support 📏
  • One-click PNG export 💾
  • Fully compatible with Unity HDRP for advanced PBR rendering 🎮
  • Normal Map support: Automatically extract X (A) and Y (G) for the Detail Map!
  • Directly insert Detail Map into the Mask Map

🎨 Mask Map Channels

Channel Content
R (Red) Metallic ⚙️
G (Green) Ambient Occlusion 🌿
B (Blue) Detail Map (Optional) 🔍
A (Alpha) Smoothness ✨

💡 If an image is not loaded for a channel, a default white fill will be used.


📥 Download (No Python Required)

Download the standalone executable for your platform:

Platform Download
Windows MaskMapGenerator.exe
macOS MaskMapGenerator.app

💡 Just download and run - no installation required!


🏰 Installation & Setup (From Source)

If you prefer to run from source code:

  1. Ensure you have Python 3.x installed 🐍
  2. Install the required packages:
    pip install -r requirements.txt
  3. Run the application:
    python MaskMapHDRP.py

🔨 Building Executables

To build standalone executables yourself:

  1. Install PyInstaller:
    pip install pyinstaller
  2. Run the build script:
    python build.py
  3. Find your executable in the dist/ folder

🎮 How to Use

  1. Drag and drop or select images for R, G, B, and A channels.
  2. (Optional) Invert channels if needed using the checkboxes.
  3. Set the desired resolution.
  4. Click "Generate Mask Map" to preview the result.
  5. Click "Save Mask Map" to export the final image!
  6. (Optional) Load a Normal Map to automatically extract X and Y channels for the Detail Map.
  7. (Optional) Insert the Detail Map directly into the Mask Map with one click.
  8. Import the Mask Map into Unity and use it in your HDRP material! 🏆

Unity Workflow


📌 Notes

  • If you want to add a Detail Map, you can generate it separately and insert it into the B channel of the Mask Map.
  • The tool supports .png, .jpg, and .tga formats.
  • Normal Map loading is supported for generating Detail Maps.
  • A desaturation feature helps you convert an image to grayscale directly from the interface.

🚀 Contributions & Support

Found a bug? Have a feature suggestion? Open an Issue or a Pull Request on GitHub! 🎉

💬 For any questions or support, feel free to reach out! 😊


💬 Join Our Community!

Need help or want to learn more about game development and 3D modeling?
Join our Discord community for support, discussions, and exclusive tutorials! 🎮🔥

Join our Discord


🛠️ Created with ❤️ by San Liuk

🚨 For important stuff, contact me at: info@sanliuk.com ✉️