PaintLayer Pro
PaintLayer Pro — Documentation
v1.1.1 · Blender 4.2 LTS and later · Windows / macOS / Linux
1. Install
- Download the add-on archive and leave it zipped. In Blender open Edit → Preferences → Add-ons, press the arrow button in the top right corner, choose Install from Disk, pick the ZIP and tick the checkbox next to PaintLayer Pro.
- Press N in the 3D Viewport → PaintLayer tab.
After installing, press N in the 3D Viewport: a tab named PaintLayer appears in the sidebar.
2. Quick start
- Select an object with a material.
- Pick a Channel (Albedo / Roughness / Metallic / Normal).
- Pick a Resolution.
- Click Add Layer to add a new paint layer.
- Paint with Blender's built-in paint tools — your strokes land on the active layer.
- Adjust opacity / blend mode / visibility per layer.
3. Layer stack
Layers stack bottom-to-top exactly like Photoshop / Krita. Move them with the up/down arrows. The composite is built by walking the stack from bottom to top, applying each layer's blend mode and opacity.
4. Blend modes
Fourteen modes: Normal, Multiply, Screen, Overlay, Add, Subtract, Darken, Lighten, Color Dodge, Color Burn, Soft Light, Hard Light, Difference, Exclusion.
5. Masks
Each layer can have a mask. Add Mask → paint in mask mode → the layer is constrained to the painted area. Invert Mask swaps black and white. Apply Mask bakes the mask into the layer image.
6. Groups
Add Group adds a named group entry to the layer list. In this version a group is a label in the stack: layers are not moved into it, and its visibility, opacity and blend mode do not change the composite.
7. Live Preview
Toggle Live Preview in the main panel. When on, changing opacity / blend mode / visibility re-composites the layer stack instantly so the viewport texture updates as you drag sliders. Recommended for stacks under ~30 layers; on heavier stacks turn it off and click Composite manually to avoid lag.
8. Direct vs Stencil paint
- Direct — strokes land on the current layer using Blender's brush.
- Stencil — paint through an image stencil (useful for projecting decals / dirt maps).
9. Undo
The addon keeps a per-image snapshot history independent of Blender's global undo. Undo / Redo undoes only your paint strokes, leaving other Blender state alone.
10. Export / Import
Export a finished material as a flattened PNG / JPG / EXR. Import a single image as a new layer (auto-rescaled to the layer resolution if needed).
11. Troubleshooting
"Nothing shows on my object" — after painting, press Composite; the result is now wired into the material's Base Color automatically (v1.1.0+). Set the viewport shading to Material Preview or Rendered (top-right of the viewport) to see it, and make sure the object has a UV map.
"Live Preview makes Blender sluggish" — turn it off and click Composite manually after a batch of changes.
"My strokes don't show up on the layer" — verify the layer is selected (highlighted in the list) and not locked. Direct mode requires the canvas to be active in Texture Paint mode.
"Import resized my image" — imports larger than the layer resolution are auto-scaled. Bump Resolution in the main panel before importing 4K assets.
12. Limitations
- Layer history lives in memory; opening a heavy stack on a 4K canvas can spike RAM.
- Auto-save interval declared in preferences but not currently used by an auto-save event.
13. Support & License
Through marketplace messaging. GPL-3.0.
14. Changelog
v1.1.1 — maintenance release. Minimum Blender is now 4.2 LTS. The package ships the full licence text and an updated README. No changes to the tools.
v1.1.0 — Paint now shows on your object.
- Composited paint is now wired into the material. The addon filled the texture but never connected it to the shader, so nothing showed on the object. Compositing now links the image into the Principled BSDF (Base Color / the matching channel) automatically. Set the viewport to Material Preview or Rendered to see it.
- No more crashes on mixed resolutions — compositing, merging, and masks resample layers to a common resolution instead of raising an error when sizes differ.
- Correct blend math — a bottom-most Multiply/Darken layer rendered black instead of its own colour; the compositing formula is fixed.
- Export Flattened no longer fails on a filename without a directory.
v1.0.0 — Initial release.
Discover more products like this
projection-painting pbr-painting symmetry-paint non-destructive stencil Substance Alternative layer-mask undo system blend modes texture-artist Texture Painting paint-layers