https://github.com/theworkshopwarrior/uberpaint

Blender addon for efficient material layer painting
https://github.com/theworkshopwarrior/uberpaint

addons blender graphics layer materials painting texturing

Last synced: 3 months ago
JSON representation

Blender addon for efficient material layer painting

• Host: GitHub
• URL: https://github.com/theworkshopwarrior/uberpaint
• Owner: theworkshopwarrior
• License: gpl-3.0
• Created: 2025-07-14T23:06:51.000Z (5 months ago)
• Default Branch: master
• Last Pushed: 2025-09-16T02:02:34.000Z (3 months ago)
• Last Synced: 2025-09-16T02:35:04.045Z (3 months ago)
• Topics: addons, blender, graphics, layer, materials, painting, texturing
• Language: Python
• Homepage:
• Size: 354 KB
• Stars: 4
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# UberPaint Guide

**Overview** 

UberPaint is an open-source Blender addon intended to dramatically simplify the process of painting materials.  Whereas it was previously necessary to make materials into node groups, manually add image textures, and blend it all together, UberPaint automatically handles all of that and provides a simple layer-based solution.  It supports both texture painting and vertex painting, and has advanced features such as displacement falloff blending.

**Usage:**

1. Add source materials into your scene.  These could be asphalt, plaster, or anything you intend to paint. ![Materials](https://github.com/user-attachments/assets/eab95670-706f-45f6-8d48-93dc677eb371)

2. Select the target object to be used, using the eyedropper at the top.

3. Add layers in UberPaint and assign them to corresponding materials.

![Layers](https://github.com/user-attachments/assets/d2af9ad4-c413-4118-9e0b-ae9e300161c5)

5. Choose weather to use image textures or vertex colors.  Image textures are ideal for low-poly objects, but do not allow for real-time painting in Cycles.  On the other hand, vertex colors are ideal for high mesh density objects where performance is more of a priority. Once you have decided, generate a blend material.

6. Click the "Paint Layer" button at the far right of each layer in the list to paint it, and click once again to exit paint mode. 

7. Tweak layer properties as needed, such as displacement falloff blending.

![dis_maps](https://github.com/user-attachments/assets/4dba5008-aaac-4412-984a-2df49740fe75)

**Full Tutorial:**

https://www.youtube.com/watch?v=meX3cbtdVbI&t=8s

**⚠ Current Limitations**

- When a source material is edited, the changes are not reflected in UberPaint objects until the blend material is updated once again.

- Updating/building blend materials can cause lag depending on quantity and complexity.

  

If you'd like to try something new, test the new alpha release!  [UberPaint 0.9.8 Alpha](https://github.com/theworkshopwarrior/uberpaint/tree/release/v0.9.8-alpha)

Enjoy!