Skip to content

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