Troubleshooting
Messages and symptoms you may meet, grouped by task, with what to do about each. Messages appear in Blender's status bar and as pop-ups.
Panel and placement
| Message or symptom |
What to do |
| Place on Surface is grayed out |
Choose a library entry and select a plain mesh. A placed decal, or the decal canvas itself, cannot be a target |
| No mesh surface under the cursor |
Move the cursor over a mesh while placing |
| No mesh surface to place the decal on |
Select a mesh first |
| The decal is off its surface; move the cursor onto the support |
Bring the cursor back over the support mesh |
| The support mesh is hidden; show it to adjust the decal |
Show the mesh, then use Adjust again |
| Cannot project this decal: ... |
The message ends with the reason. Check the support mesh and the placement settings |
| Create or resume a decal first |
Click Create Decal or Resume Editing, then try again |
| The source decal project is missing |
The editing scene of this decal no longer exists. Use Replace with the library entry, or edit the entry from the library |
| Cannot update the library entry: ... |
Update Library Entry only works for decals placed from an editable library entry |
See Place on Surface and Colors and Library Update.
Creating from a selection or a surface
| Message |
What to do |
| Select faces or edges |
Select at least one face or edge in Edit Mode |
| The selected edges touch no face |
Select edges that belong to a face |
| The selection has no usable outline |
Choose a different selection |
| Warning about an overlapping or stretched unwrap |
Mark a seam on cylinders and rings, then run the tool again |
| Draw on Surface needs a 3D viewport |
Start the tool with the mouse over the 3D viewport |
| A closed path covers most of the object |
The path encloses no region. Draw it again, closed around the faces you want |
See Decal from Selection and Draw on Surface.
Junctions
| Message |
What to do |
| Select two meshes: the active one receives the decal |
Select both meshes, with the receiving one active |
| Select a DW Junction object |
Select the junction before using Replace or the options |
| Select a junction decal in the library (Junctions category) |
Choose an entry in the Junctions folder |
| Could not apply the junction modifier |
The bake failed. Check that the meshes still intersect |
| Nothing appears |
The two meshes must actually cross each other |
See Junctions.
Layers, groups and locks
| Message |
What to do |
| Unlock ... before ... (several) |
A lock protects the layer or group. Click its lock in the layer list, then try again |
| Select at least one group or shape |
Select what you want to group first |
| Select groups and shapes with the same parent before grouping |
The selection must share the same parent group |
| A group cannot move into itself |
Drop the group somewhere else |
| Disable or remove group modifiers before ungrouping |
Turn the group's modifiers off first |
| Disable the group bevel before ungrouping |
Set Group Bevel to zero first |
| Disable ancestor member effects and modifiers before grouping baked shapes |
Turn off the member effects and modifiers of the parent groups |
| Select the active shape and at least one other shape |
Boolean and align tools need a second shape |
| Make the result shape active, then select one other shape |
The active shape keeps its relief and color. Pick the right active shape |
| Choose two shapes in the same group, or two ungrouped shapes |
A boolean needs operands at the same level |
| The active shape already has another mask; clear it first |
One operand per result is supported |
| Use a shape without clipping or a stack-mask effect as the operand |
Pick another operand |
| Use masks instead of editable Booleans for raster sources |
Image layers use Mask layers with Cut or Keep |
| Unlock the source before editing modifiers; baked sources have no editable modifiers |
Merged Image layers cannot take modifiers |
See Layers and Groups.
Merge Down
| Message |
What to do |
| Unlock both shapes and their group first |
Unlock them |
| Merge Down needs two visible shapes, not mask-only sources |
Show both layers and pick two non-mask layers |
| Remove clipping and Boolean dependencies before merging |
Merging would change other layers |
| Another shape or group uses one of these sources as a mask |
Remove that mask link first |
| A targeted mask depends on these sources; remove its target before merging |
Change the mask target |
| Remove Clip to Below links before freezing the stack |
Turn Clip to Below off |
| Disable stack masks affecting these shapes before merging |
Turn those masks off |
| Disable group masks, bevel, member effects and group modifiers before merging |
Turn them off on the group |
Modifiers
| Symptom |
What to do |
| An error under the modifier buttons, the preview stops updating |
The stack is too big: at most 256 instances for one shape and 512 for the decal. Reduce Count or disable a modifier |
| Ungroup is refused |
A group modifier is active. Disable or remove it |
See Modifiers.
Images, 3D objects and masks
| Message |
What to do |
| Missing / archived only (under 3D source) |
The source object was deleted. Click Restore Source Object |
| Source missing: choose a mesh when recapturing, or restore its archive |
Choose a mesh in the dialog, or restore the archive |
| The source collection is excluded from every view layer |
Include the collection in a view layer, then use Edit Source Object |
| Flat mesh error on capture |
The mesh must be a closed volume with thickness |
| A mask is already being painted |
Finish the current mask with Done |
| Go back to Object Mode on the decal board first |
Leave Edit or Sculpt Mode, and keep the decal board active |
| Paint the mask from a 3D View |
Use the Paint Mask button while the mouse is over a 3D viewport |
| Cannot load font: ... and Choose a .ttf or .otf font file |
Pick a valid font file |
| No image to paste: ... or Cannot read the clipboard image: ... |
Copy an image or a screenshot again, or use the open button instead |
See Relief, Bevel Profiles and Quality and Wear, Dirt and Effect Masks.
Materials
| Message |
What to do |
| The active layer has no material |
Give the layer a material before saving it to My Materials |
| My Materials: ... |
The message ends with the reason: a name that is not valid, or a folder you cannot write to. Check My Materials Folder in the preferences |
| Emission Color is black: nothing glows |
Set the Emission Color to a brighter color |
| Material cannot be picked |
Only compatible Principled materials with constant values are offered |
See Materials and Finishes.
Library
| Message |
What to do |
| Choose the entry to replace |
Select an entry before Replace Entry |
| This name already exists; choose another name or Replace Entry |
Save As never overwrites. Pick another name |
| Choose another name |
The name is not valid or already used |
| Choose a folder to remove |
Select a folder. All and Top Level cannot be removed |
| Folder cannot be removed |
It must be empty. Move or delete its decals first |
| Add a personal library folder in the addon preferences |
Add a User Library in the Preferences |
| No decal images found (color, height or normal) |
Add Images to Library found no matching PNG maps |
| Studio thumbnail failed; asset saved with the fast preview ... |
The entry was saved. Check studio.blend keeps one dw_thumbnail_subject mesh, an active camera, and Cycles or Eevee |
| GPU rendering failed; the studio thumbnail was rendered on the CPU. |
Only a warning. Saving is slower |
| Decal has no visible surface at studio map resolution |
The decal is empty or too small to render a Studio thumbnail |
See The Library.
Export
| Message |
What to do |
| Choose a library folder and an export folder |
Fill in both fields |
| The library folder does not exist |
Fix the path |
| Choose an export folder outside the library folder |
Pick a folder elsewhere |
| Choose a new or empty export folder |
Pick a new folder, or empty it |
| A library export is already running |
Wait for it, or press Esc |
| No editable Decal Workshop decals found in this folder |
The folder has no editable entries |
| DECALmachine is not installed or could not be enabled in this Blender version |
Install DECALmachine, or choose PBR or Atlas |
| PBR atlas export requires Pillow |
Install the Pillow Python module in the Python used by Blender |
| Entry ... does not fit ... atlas ... |
Raise Atlas Size |
| Export failed: ... See log in ... |
Open the log file in the export folder |
| Export cancelled; partial files kept |
Normal after Esc. The files already written stay in the folder |
See Export.
Preferences
| Message |
What to do |
| Set the Settings File path first |
Choose a file in the Settings File field |
| Settings File not found |
Check the path |
| Not a Decal Workshop settings file |
Pick a file saved by the Save button |
See Preferences.
Still stuck?
- Check the Blender system console for details of an error.
- Use the Support on Discord button in the Preferences for customer support.
Next steps