Ucupaint

Changelog

What’s New

• Blender 5.0 Alpha support
• Normalize option for pointiness baking
• Use Cage option for baking other objects' data
• New option for ramp modifier to affect only color or alpha
• Other Object Emission bake option is replaced with Other Object Color since it can also work with Principled or Diffuse BSDF materials
• Active Mask / Override option for layer preview mode is renamed to Active Mask / Custom Data

Bugfixes

• Fix: Artifacts around the alpha area when using baked other object color as bump
• Fix: Refresh UV does not correspond to the custom channel source image, and sometimes can cause an error
• Fix: Expandable subitems do not list non-image/vertex color custom channel source
• Fix: Wrong vector displacement scale on Blender 4.5+

Baking pointiness with Normalize enabled has less banding and is easier to control

Changelog

Maintenance release of Ucupaint, contains only bugfixes.

Bugfixes

• Fix: Creating a solid color layer with a vertex color mask in edit mode can cause missing data that cannot be resolved
• Fix: Baked layer/mask sometimes won’t use the correct UV Map
• Fix: Edge detect and Ambient Occlusion layer use wrong icons
• Fix: Removing Ambient Occlusion channel while Preview Mode is enabled is causing a disconnected node
• Fix: Moving channel order does not also move layer channel input properties
• Fix: Adding a new layer when the active layer is a disabled group on index 0 will make the newly created layer have weird indentation
• Fix: Cannot sculpt VDM image when the scene world is empty
• Fix: A pure black color on the color channel can affect the bake result of the normal channel

Changelog

New Features

• Rebake all baked layers and masks
• Paste layer(s) has an option to rebake baked images
• New layer and mask type, realtime Ambient Occlusion
• Realtime Edge detect can now also be used as a layer
• Realtime Edge Detect, AO, and Fake lighting layers are now bakeable as an image
• New Dither option (for bake channels) to avoid banding color
• New OSL option (for bake channels) to avoid Out of SVM stack error when the material is too complex
• Fill selected geometry option when ColorID or vertex color is added in edit mode
• Copy & Paste custom bake target
• Open Images from Material now will check the node connection by default rather than checking the image names
• Paste layer now works with ucupaint node with a different channels list

Youtube video demo of realtime AO and rebake all layers/masks

Comparison of baked channel result with dithering on and off

Changes

• New float image will use Premultiplied alpha by default since it has better alpha handling.
• Enabling displacement setup will use Displacement and Bump mode rather than Displacement Only

Byte image with straight alpha has outline artifacts compared to float image with premultiplied alpha

UI Update

• All baked channel data is now displayed at the same time
• A bake button is added for some realtime AO/Edge Detect/Fake Lighting layer/mask for easier access
• Most Ucupaint operators now can be assigned to a custom shortcut key.
• Tree name can now be customized from the quick node setup popup
• Remove button is added for baked layer/mask
• Open Image in Explorer is added to the image layer/mask/channel source dropdown (263)
• Toggle Eraser button will be switched to red Disable Eraser button when the active brush is an eraser.

New baked channels UI

Bugfixes

• Fix: Misaligned internal nodes location on Blender 4.4+
• Fix: Replacing a mask type to Backface will create unnecessary nodes
• Fix: Baking with denoise enabled can make the bake result even noisier in some cases
• Fix: Group panel shows unused properties
• Fix: Open Image as channel source always uses an absolute path
• Fix: Duplicate layer won't duplicate its vertex color data
• Fix: Open image to layer channel source sometimes uses incorrect colorspace
• Fix: Bake All Channels causesan error when there's a normal enabled layer with a fake lighting mask
• Fix: Duplicate/Paste multiple layers did not recognize multi-user images and decal objects
• Fix: Bake Bevel Normal sometimes produces wrong result
• Fix: Float image uses wrong gamma color
• Fix: Wrong base color of float baked normal
• Fix: Bake other object channels with SSAA enabled produce wrong results on Blender 4.5

Changelog

This release includes a significant UI redesign that aims to resolve some of the previous UI issues.

Updated UI

Collapsible Group

It's now possible to collapse a layer group

New dropdown icons

Dropdownable UI panels now have distinct arrow icons and are easier to click.

Layer channel source

Previously you needed to enable override toggle (hidden by default) to change layer channel value, now you can just change the layer channel source.

Other UI changes

• Vector option is now outside of layer dropdown
• Use lock icon toggle for Uniform Scale
• Object index is now consistently labeled Object index instead of Pass Index
• Layer and mask sources are now directly integrated into the UI
• Experimental display list option to make mask/override images to have their own entries on the layer list
• Rebake button is added beside Use Baked button

Changes

• Preview mode is now will disable compositor by default since it can change the actual color
• Toggle Eraser on texture paint mode in Blender 4.3+ won't create a new brush but select the available eraser brush asset
• Smoother Bump option is now only available if the experimental option is enabled since it's been deprecated

Bugfixes

• Fix: Images won't autosave when using EXR format
• Fix: Manually created UDIM images sometimes don't get packed correctly
• Fix: Apply sculpt to VDM produces wrong result when view transform is not Standard
• Fix: UI shows old alpha settings on Blender 4.2+ with cycles renderer
• Fix: Wrong bake results with multiple objects with the same material if there are mismatched attribute data types
• Fix: Move layer in or out of group can't be undo-ed
• Fix: Renaming layer also renames image atlas mask
• Fix: Missing UI when other objects bake data are not found
• Fix: Toggle eraser is not working on Blender 4.4
• Fix: Manipulating main channels can cause wrong keyframed/driver data

Changelog

Object Space normal

Ucupaint can now bake and use an object space normal map. This is very useful for hand painting a stylized normal map.

Bugfixes

• Fix: Cannot enable channel's alpha on Blender 4.3+
• Fix: Transferring image masks sometimes will use wrong base color
• Fix: Cannot bake channel when there are multiple materials in a single object and the active object is in edit mode
• Fix: Opening images from other material can accidentally delete unrelated images
• Fix: Cannot preview the override normal when using layer preview mode
• Fix: Images get Packed after Saving them externally

Changelog

Bugfixes

• Fix: Opening images to single layer with Add Mask enabled is causing error
• Fix: Misaligned mask UI on Open Images to Single Layer popup
• Fix: Duplicated decal object does not use the same collection as the original decal

Changelog

New Features

• Quick resolution toggle when creating a new image layer/mask
• Gabor layer/mask type (Blender 4.3+) (Showcase)
• Exclusion blend type
• Flip G option for loaded normal map when opening images to a single layer
• New button to open an image as a mask for a new layer
• Individual color channel (R/G/B) as vertex color mask inputs

New resolution toggle on new image layer popup

Bugfixes

• Fix: Some bake types (cavity, pointiness, bevel) does not take into account solidify modifier
• Fix: Baking other object channels does not read the alpha channel
• Fix: Toggle eraser on vertex paint mode cannot go back to original brush (Blender 4.3+)
• Fix: Cannot set some of transition effect properties
• Fix: Cannot go back to original UV when using image atlas on edit mode
• Fix: Adding a new vertex color mask resets the extension mode of a previous decal image mask back to clip
• Fix: Layer with Flip Y enabled still flips the G/Y channel after changing layer type to non-image
• Fix: Error when replacing UDIM atlas layer to another type
• Fix: Using vertex color alpha as a mask will cause missing UI
• Fix: Blender 2.80+ uses the wrong icons for channel selection on the new layer popup

Label Renames

For more clarity, some labels in Ucupaint are renamed

• Image’s Flip Yis renamed to Flip G
• Spread Fix is renamed to Divide RGB by Alpha
• RGB to Intensity and Intensity to RGB modifiers are renamed to RGB to Alpha and Alpha to RGB

Icon Changes

The show layer channel toggle now uses a new icon for a better representative of what it does

New icon for show layer channel toggle

Changelog

What’s new

• Uniform vector scaling
• Preference option to enable/disable auto UDIM detection
• Now there’s a warning popup when trying to delete/merge unsaved layer/mask images
• No more single option confirmation popup to move a layer outside of a group

Bugfixes

• Fix: Copying a layer doesn't copy layer parameters
• Fix: Trying to bake Fake Lighting throws an error when it's used in certain layer stacks
• Fix Ucupaint Multi-User Node breaks the node setup when Use Baked and Enable Baked Outside is active
• Fix: Incorrect image paths if the blend file is saved after images were imported to Ucupaint
• Fix: Missing UI after using image alpha as a mask
• Fix: Missing icons can happen randomly
• Fix: Driver can be wrongly assigned after changing layer parameters

Changelog

New features

• Ucupaint uses modern blender icons by default (legacy icons still can be selected in the addon preferences)
• Open Image as Decal in the file browser
• New preference setting to skip some popups (shift + click the button will still show the popup when necessary)
• New preferences setting to use Enable baked outside by default (useful for exporting assets to other apps)
• New operator to set position decal to 3d cursor
• New image menu to Save an Image Copy

Changes

• Decal object will use the same collection as the parent object
• SSAA is disabled by default for baking other objects' data since it will quadruple the memory usage

Full release notes: https://github.com/ucupumar/ucupaint/releases/tag/2.1.1

Changelog

• Decal mapping (Demo)
• Load images from material
• Load images from asset browser right-click menu (Demo)
• Load image from file browser right-click menu
• Partial Arabic Localization
• Use Layer Vector mapping for mask
• Option to use float image for baked normal and custom bake target
• Option to change default bake device on preferences
• Denoise option for baking bevel grayscale
• Interpolation option when baking to a layer
• Supports for ACES or any custom OCIO profiles
• Tons of bugfixes!

Full release notes: https://github.com/ucupumar/ucupaint/releases/tag/2.1.0

Video Demo

Changelog

Maintenance release of Ucupaint, contains small changes and bugfixes.

Bugfixes

• Fix: When using multiple materials in a single mesh, painting an image layer will also paint another material’s image layer
• Fix: Some older files can’t be updated to version 2.0
• Fix: Crash can happen when opening a file created using older ucupaint
• Fix: Merging image layers will add .001 prefix to the image result

Changes

For future compatibility, distutils module is no longer used since it will be removed in Python 3.12.

Changelog

Ucupaint went on a huge refactor on this release, so it skipped version 1.x and went straight into version 2.0. This refactor opens up new possibilities while adding performance improvements.

What's New

• Driver support (Demo)
• Per-layer opacity/intensity (Demo)
• Realtime displacement on Blender 4.2+ (Demo)
• Vector displacement layers on Blender 4.2+ (Demo)
• Bump midlevel is now editable.
• And many more..

Full release notes: https://github.com/ucupumar/ucupaint/releases/tag/2.0.0

Changelog

• Added more descriptions of various UI buttons
• Interpolation option is an option when baking the channel
• Some icons are tweaked in size to make the collapsible triangle more visible
• More bugfixes!

Full release notes: https://github.com/ucupumar/ucupaint/releases/tag/1.2.10

Changelog

• Smooth bump is now disabled by default and 'Cubic' interpolation will be used .automatically for bump maps. The performance improvements because of this change are huge!
• Quick setup now will switch viewport to material view by default.
• More bugfixes!

Full changelog: https://github.com/ucupumar/ucupaint/releases/tag/1.2.9

Changelog

• Remove all custom update functions
• Image interpolation option when adding a new image layer or mask
• Various bugfixes

Full release notes: https://github.com/ucupumar/ucupaint/releases/tag/1.2.8