by MACHIN3 in Scripts and Addons

A 2.80 version is under development.

DECALmachine is a blender addon - a set of tools to simplify and automate working with mesh based decals, which  in turn facilitates quick design thinking, iteration and exploration. It does all that in a very non-committal, non-destructive way.

DECALmachine is supposed to be used with Blender's Cycles renderer.

Since v1.4 decals can be exported to Unity3D, Unreal Engine 4, etc.

Check out the release trailer, the 1.3.5. trailer and crate demo above or on youtube.

See What's New in v1.4.2


See the installation guide for instructions.

Go over the detailed documentation, including a custom decal creation guide and FAQs.


  • new Reconsruct Panel Cutter tool
  • new Surface Fix tool
  • Principled BSDF support
  • Match Material
  • decal atlas creation
  • decal export to Unity3D, Unreal Engine 4, Substance Painter, Sketchfab, etc.
  • bake decals down: normal, ao, curvature, height and color maps
  • custom vertex normal workflow
  • instant and batch decal creation
  • modal decal height adjustment
  • integrated asset/decal loader (deselect all + press 'd')
  • use decals on flat surfaces and project them on curved surfaces
  • 'cut' decal panel lines in a boolean-like manner
  • parallax adds convincing depth to normal mapped decals
  • retain sharp details at all scales, independent of texture resolution
  • decal and panel UV creation is automatic and base meshes don't need UVs
  • change panel decal width and panel type after a panel has been 'cut'
  • change the panel decal shape and direction after it has been 'cut'
  • retrieve the original un-pojected decal sources at any time
  • retrieve the cutters of panel decals at any time
  • material cutting and material decals
  • separate decal subset materials
  • separate panel materials for each side side and panel flipping to switch those sides
  • panel unwrapping for custom drawn or modified panel decals
  • quickly rotate decals in 45 degree steps without leaving face snapping
  • 111 decal assets supplied


Blender 2.78 or 2.79, 2.79 is recommended. Cycles renderer.
Only stable releases are supported, use the addon at your own risk with the latest builds of blender.

suggested tools for the best experience:

  • MACHIN3tools - a continuously evolving collection of scripts, to simplify and automate a variety of tasks.
  • Hard Ops the go to hard surface modeling tool kit, also quick access to modifiers and material assignments
  • Batch Operations for scene organization
  • Asset Management a general purpose importer to bring in kitbash parts, light setups, etc.
  • filmic

Please see for extensive and up-to-date documentation.


I have no idea how to install this, how is it done?

See the Installation guide and follow it precisely.

Other Addons

Is HardOps or BoxCutter required?

HardOps and BoxCutter are not needed to use DECALmachine. That said, HOps/BC and DM fill different niches. DM is a finishing and detailing tool. While HOps/BC are tools for working with form and generally improve the Blender experience greatly.As such the addons complement each either very well and work great in tandem.

Furthermore it should be noted, that the HardOps and BoxCuter developers have been and continue to be extremely supportive and helpful and DECALmachine would not be what it is, without their contributions and guidance.

Is the Asset Management addon required?

Since version 1.2. DECALmachine has its own asset loader, made possible through HardOps tech being graciously shared, and so Asset Management no longer adds a benefit in terms of bringing decals into the scene.

For all other importing needs(meshes, light setups, materials, etc) I personally still heavily depend on Asset Management and would recommend it to anyone.


Can you bake the decal normal maps to a single normal map?

Out of the box, you can't, there's no support for it yet. That said, aMars on blenderartists has done it using xNormal. Also, Prime8 on polycount suggests it is possible in Blender itself.
I will investigate both of these routes, it looks promising.

For now it's pretty laborious work, as it requires manual decal atlas creation and adjustment of decal UVs to fit the atlas textures accordingly.

With the 1.4 release, which will focus on exporting decal geometry and textures, this process should be simplified and ideally completely automated.

Keep in mind however, that in regards to real time content, the whole point of using decals - in combination with custom/weighted vertex normals - is to stop relying on baked normal maps. The idea is to take the decal geometry into the engine and by utilizing deferred rendering techniques, have the mesh-based decals contribute to the textures of the underlying base mesh.
This is done very successfully and prominently in Star Citizen and Alien Isolation and this is the workflow DECALmachine is aiming at.

For now, the initial release of DECALmachine should be seen as a design tool inside Blender.

How do you export the decals to Unity/Unreal?

There's no export tool with the current 1.3.5 version. You can do it manually, but it's laborious work, as it requires manual decal atlas creation and adjustment of decal UVs to fit the atlas textures accordingly.

1.4 will be the export release and is actively being worked on. Among other things, it will feature automatic atlas creation and auto UV alignment to the atlas.

Is there a way to make decals affect displacement instead of normals?

Technically it's trivial to change the decal node tree to do displacement as the height maps are already supplied. But think about it, a floating decal with actual displacement?
First off, the decal would need to be subdivided a lot, which can be done, but secondly what would happen to the displaced geometry? It would intersect with the base mesh the decals are floating above - you wouldn't see much of the displaced geometry, as it is sunk into the base mesh.

What you could do in theory is bake down the height map of the decals to the basemesh and then use that baked height map, without the decals for displacement.

Using DECALmachine

How do I bring Decals into the scene? Why are the asset loaders missing, when I press the d key?

The asset loaders only show with nothing else selected. Context is important. Space in the pie is tight and most of the other tools already require the proper selection to be made, before they show up. If you have anything selected, press a to deselect followed by d to open the DECALmachine pie menu with the asset loaders.

Why are Decal Project, Decal Slice etc. missing from the pie menu?

Context is important. Select the decal, then the object you want to project on. Then open the pie by pressing d.
Similarly, select one object, then another one to decal slice.

How can I add/create my own Decals to the library?

There are currently two ways to create custom decals:

  1. Instant Decal creation
  2. Batch Decal creation

Make sure you have an up-to-date version installed and see the Custom Decal Creation guide.

How do I snap decals to a surface?

When Decals are imported using the asset loaders, all snap settings are prepared - face snapping, align to surface, etc. Snapping itself is not turned on however. The suggested method to move decals and align them is by holding down CTRL while moving decals via g. This will turn on snapping temporarily for as long as you hold down CTRL.

Why are decals just empty planes?

First, confirm the issue is occuring with the sample blend files in DECALmachine/assets/samplesRender the sample scenes using the shift+ z shortcut.

If it isn't happening in the sample scenes, but is happening in your own scenes:

  • make sure you have set the renderer to Cycles
  • make sure you have set the Viewport Shading to Material

If it's also happening in the sample scenes, get in touch.

When I taper panel decals for a panel transition, the texture get's distorted! What is going on?

You need to enable Correct UVs in the slide tool's properties - either in the T panel or by pressing F6.

Decal Slice is not working! What am I doing wrong?

Decal Slice is heavily depended on topology, so where the cutter intersects the target mesh is extremely important.
Also, the bigger the Panel Width Value is and the denser the target mesh is, the more likely it is for Decal Slice to fail.

The reason it fails is due to intersection of edges at odd angles, it wasn't able to create a quad-only panel strip and so the auto-UVing fails. You have two options in that case:

  1. carefully position your cutter (turn wireframes on) and avoid troublesome intersections
  2. lower the Decal Panel Width value

If it still fails no matter what you do, take the panel strip you get, fix it up - make it all quad - and run Panel Unwrap.

If you've used HardOps or Booleans in general, you know that you can't arbitrarily cut curved geometry without regards to the underlying topology and expect it to work perfectly.

There will be a second slice tool in the 1.4 release, which produces all quad strips guaranteed, but at the expense of not being as close to the base mesh, as it doesn't follow the topology.

Decal Creation

How do I create Info Decals?

Instant Decal creation turns geometry - as opposed to textures - into decals, so for Info Decals use the Batch Decal process instead, even if you have just one image to turn into a decal.


PermissionError: … Permission denied: 'C:\\Program Files\\… paneling.json'

You didn't install the addon to the user scripts folder, but in 'Program Files' instead. Review the Installation guide and follow it precisely.

OSError [Errno 30] Read-only file system: '... paneling.json'

You didn't install the addon to the user scripts folder, but into the package instead. Review the Installation guide and follow it precisely.

ImportError: No module named PIL

You didn't extract the PIL archive for your operating system or didn't move it to the modules folder. Review the Installation guide and follow it precisely.

ImportError: DLL load failed

If you are seeing this error on Windows when activating the addon, you need to install Microsoft Visual C++ Redistributable 2015

ImportError: Cannot import name _imaging

If you are seeing this error on Windows when activating the addon, you need to install Microsoft Visual C++ Redistributable 2015

No FAQ's found for this product.

Item Rating

This item has an average rating of 5 from 20 ratings by the community.

  • darkheron about 2 months ago

    One of the most innovative and essential tools for blender. I miss it so much in 2.8. Hopefully it is ready to test soon.

  • Kor Boerema 3 months ago

    Saw it in action in a Hard Ops video, checked out the other videos of this plugin and was instantly sold on it.

    It really is amazing. Thanks for making this.

  • bob 4 months ago

    I have been lusting over this plugin for years it seems. I final bought it last week. I knew it did amazing things with a simple cool menu. I am blown away with all the extra things it can do. Still learning the limits but I am truly amazed at how much I can accomplish right out of the box.

  • John Joyce 6 months ago

    Wow this plug-in makes it so easy to add those hard-surface details it is just ridiculous. I wouldn't want to do it any other way if I didn't have to. Great tool and well worth it!

  • firman ryan lim 6 months ago

    best addon for game or game machine model.

  • thegreattank 9 months ago

    Excellent product ! Works really well with HardOPS.
    Worth every pennies.

  • hoxolotl 10 months ago

    A little hard to install, but once it runs the results are quite nice.

    • MACHIN3 10 months ago

      Thanks for the review and rating! Much appreciated! The reason for the unusual installation process is the image processing DECALmachine does for Decal Creation and Export. The requires an external python library - PIL - , and can't be done via blender or the supplied library.

  • DCT9000 over 1 year ago

    Got to agree with teralink, feels like cheating. Beautiful results quick and easy.

  • João Santos over 1 year ago

    Super usefull add-on, a must have!

  • korindian77 over 1 year ago

    I switched to Blender because of this addon. I was looking for a tool to help with a mesh decal workflow when I first saw DECALMachine, and have been following its progress since its first release. The developer has been constantly adding new features and supporting it well. DECALMachine has everything that I need to complete the workflow, including atlasing and appropriate shaders for game engines. Really really well done, with comprehensive docs and videos. Thanks for creating this addon.

    • MACHIN3 over 1 year ago

      Thanks, I appreciate that a lot!

  • Monte Drebenstedt over 1 year ago

    Great Tool

  • Monte Drebenstedt over 1 year ago

    Great Tool

  • teralink over 1 year ago

    This makes hard surface modelling so easy! Feels a bit like cheating ;)

  • tofmusik94 almost 2 years ago

    Very Great Work !! Thanks

  • patrick pomian almost 2 years ago

    une tuerie, un truc de dingue, fabuleux ! bravo

  • Georjack almost 2 years ago

    It's an amazing tool!

  • pany112 almost 2 years ago

    Speed up hard surface modeling, it is a must have

  • tcwik almost 2 years ago


  • papasmurf7777 almost 2 years ago

    Great addon!

  • Team Csharp almost 2 years ago

    Greatest tool since that other great tool...

Purchase this item to leave a review!