Blender add-on · User guide

Make every surface yours.

Place artwork on your models, wrap it around curved surfaces, build overlapping designs, and add procedural wear. Start with one image and keep adjusting your decals directly in Blender.

01 · Get set up

Install once. Start creating.

Use the same DecalWrap ZIP for either installation method. You do not need to unpack it.

Compatibility: Blender 3.6–5.2 is the target range. Render checks cover Blender 4.4, 5.1 and 5.2; Blender 3.6 remains a compatibility target rather than a runtime-verified release.

02 · Your first decal

Choose an image. Place it on a model.

1. Open your model in Object Mode. Use Material Preview or Rendered shading to inspect the decal material.
2. Open DecalWrap. With your pointer in the 3D Viewport, press N and choose the DecalWrap sidebar tab.
3. Load your artwork. Expand New Decal and open or select an image. A PNG with a transparent background is a useful choice for a shaped sticker.
4. Choose your starting settings. Set the size, Box Depth (Thickness), and mode. Start with vertex-free projection for painted graphics, or surface wrap for curved sticker overlays.
5. Click Place Decal. Move your pointer over the target surface. The decal follows the surface normal. Use the wheel to size it and Ctrl + wheel to rotate.
6. Left-click to drop the decal. Fine-tune it with the rotation ring, corner scale handles, or on-screen buttons.
7. Confirm. Press Enter or Space. Use Shift + Enter to confirm and immediately place another.

To edit it later, select its entry under All Decals or the target object's decal list. Expand its settings, then click Move / Rotate / Scale with Widget.

03 · Viewport controls

Adjust without leaving the viewport.

Use the Rotation slider for an exact angle, Flip to mirror the image, and Fit Aspect to restore its proportions. The rotation ring spins the decal; corner handles resize it.

04 · Choose a surface workflow

Project or conform.

Choose the mode before placement, press W during placement, or use Switch Mode in the decal settings.

05 · Build your design

Stack, blend, and personalise.

1. Select the target mesh and open its decal list. Entries are displayed top layer first.
2. Use the up/down arrows to bring a decal forward or send it backward within its stack. New decals and duplicates start at the top.
3. Choose a Blend Mode and adjust Blend Amount directly in the row. Lower amounts reveal the layers below.
4. Expand the decal settings to adjust its colour tint, transform, image, and wear.

Available blending includes Normal, Multiply, Screen, Overlay, Add, Soft Light, Darken, and Lighten. Try Multiply for darker printed graphics, Screen for lighter graphics, or Normal for straightforward sticker coverage.

Use Duplicate Decal to reuse a design. Shift + D duplication is also supported; duplicated decal materials and shader groups are made independent.

Mixed modes have separate stacks: surface overlays sit above shader projections. Arrows reorder decals of the same type on the same target. Use the same mode for layers you want to freely interleave.

06 · Add character

From pristine to weathered.

Select a decal and expand Damage / Wear. Choose a preset, click Apply, then open an effect section to tune the result. Wear works with both decal modes.

Pick a starting preset

Clean / Reset, Subtle Handling, Faded Sticker, Chipped Paint, Scratched Vinyl, Peeling Sticker, Dirty / Aged, Street / Skate Wear, Heavy Industrial, Weathered Outdoor, Battle Damaged, and Wasteland / Derelict.

Clean / Reset resets wear while preserving the image, tint, global opacity, transform, and wrap settings. Applying a preset is undoable. Mask images remain selected, but wear-mask strength resets to zero.

Control exactly where wear appears

• Wear Mask: white removes the decal; black keeps it. Choose an image, increase its strength, and invert it if needed.
• Protection Mask: white protects areas from wear, fading, and grime; black allows those effects. Use it to preserve lettering or a central graphic.

The masks follow the original decal UVs, keeping protected artwork aligned when you move the procedural pattern.

07 · Create a texture

Bake projected colour to an image.

1. Save a copy of your editable project before replacing a live decal setup.
2. Select the target mesh. It needs a UV map and a material suitable for baking.
3. Open Bake in the DecalWrap sidebar and choose the texture resolution.
4. Review Replace Decals with Bake. Leave it disabled if you want to retain the current material setup while inspecting the bake.
5. Click Bake Decals. The operator uses Cycles for a diffuse colour bake and restores the previous render engine afterward.
6. Find the image named after your object with the suffix _Decals in Blender's Image Editor. It is packed into the blend file; save the blend file to keep it. Save the image separately if you need an external texture.

Before applying: the apply option connects the baked image to Base Color and removes live projection groups and child decals. This is a diffuse colour workflow, not a complete PBR export. Separate surface-wrap overlays are not guaranteed to be included by this bake; inspect the output before replacing your editable setup.

08 · Quick answers

Keep creating.

DecalWrap · Place. Adjust. Create. · Guide based on the add-on's current controls and documented features.