Ucupaint

Common Use Cases

• Create detailed textures for 3D models with multiple layers.
• Paint vertex color masks directly in sculpt mode.
• Set up real-time displacement layers for dynamic surface details.
• Use vector displacement maps as sculpt layers for intricate designs.
• Integrate Ucupaint nodes into any existing node setup for flexible material design.

How To Install

1. Open Blender and go to the Edit menu, then Preferences.
2. Select the Add-ons tab and click on Install.
3. Navigate to the downloaded Ucupaint ZIP file and select it.
4. Enable the add-on by checking the box next to its name in the list.

First Steps After Installing

• Open the Shader Editor in Blender and add a new material to your object.
• Locate the Ucupaint node in the Add menu and integrate it into your shader setup.
• Begin painting by creating and stacking texture layers within the Ucupaint interface.
• Experiment with different layer effects to achieve the desired material look.

Scene Prep Checklist

Complete these steps before uploading your scene to a render farm.

1. 1

   Install the same add-on version on every render worker

   Required
2. 2

   Include all .blend asset files referenced by the add-on

   Required
3. 3

   Confirm all external tools are available on render workers

   Required
4. 4

   Run all bake and cache steps locally before uploading

   Required
5. 5

   Upload all external textures, presets, and asset files

   Required
6. 6

   Test that the add-on works without internet on a worker

   Recommended
7. 7

   Run a 1-frame test render on the farm before full submission

   Recommended

Things To Watch Out For

• Network-related code was detected. Any online lookups, licensing checks, or downloads should be tested before relying on farm execution.
• Subprocess or external executable calls were detected. External binaries may not exist on remote workers by default.
• Local path or asset-library signals were detected. Paths that work on the artist machine can still fail on remote workers.
• Bake or cache signals were detected. Generated outputs may need to be prepared before upload.

Common Mistakes

• Forgetting to upload local assets or helper files, leading to incorrect renders.
• Not running bake or cache steps locally before farm submission, causing render discrepancies.

Recommended Workflow

• Bake caches or precompute outputs before sending a long render job.
• Open the scene in desktop Blender and run any interactive setup steps.
• Save the file and validate a small background render before scaling up.
• Test that the add-on works without internet on a worker to avoid network issues.

Declared Permissions

• files: Access to filesystem for loading and saving images
• network: Access to the network to update contributors and sponsors list