Requirements

  • Windows, MacOS or Linux
  • Blender 2.83 (LTS), Blender 2.90 (stable)

Experimental Builds

Experimental Blender builds are not supported, and fixing any issues related to them, will not be a priority, but reporting them is still encouraged.

Blender on MacOS

MacOS users should install Blender properly, by following the official instructions.
Avoid running it just from the Downloads folder!
Note that, for dragging of files and folders, you need to hold down the COMMAND key.
This will ensure AppTranslocation1 is avoided.

Blender on Arch Linux

Arch Linux users and users of other Arch based or similar rolling release distros are advised to use the official Blender builds.
The Blender package in the Community repository does not supply its own Python, and does not follow official recommendations.

Latest DECALmachine

The latest version of DECALmachine is 2.0.1 - available on Gumroad and Blender Market.
See this page to learn what's new in the latest versions, or see the changelog for the full release history.

PIL/Pillow

For more advanced usage of DECALmachine, a python module called PIL/Pillow is required.
PIL enables DECALmachine to manipulate images, and so is required for Decal and Trim Sheet Creation, as well as for Atlasing and Baking.
Installation is covered below, and some additional information can be found the FAQs.

Updating

Decal Backup

Attention

If you are updating from a previous version, for instance from 1.9 to 2.0, you are at risk of loosing any Decals you may have created or any Bakes you may have done.

If you have not chosen a decal assets location outside the DECALmachine folder(in Blender's addons folder), you should backup your decals as described in the video, and outlined below.

Uninstallation

As a result of this Blender/Python issue, you need to uninstall your old version of DECALmachine first, before installing a new one..
You can find two approaches to do this in the Installation video, and outlined below.

Keep in mind

This is especially important for feature updates, such as from version 1.9 to 2.0.
For bug fix updates, such as from version 2.0 to 2.0.1, uninstallation can be skipped, but installation in Blender from the zip on top of the already installed version 2.0 will still not work.
Instead you should close Blender, extract the DECALmachine_2.0.1.zip file, and copy the extracted DECALmachine folder to Blender's addon directory, replacing the extising files.

Installation

this video covers installation, decal backup, PIL, external assets path, support and more


The same instructions as in the video, but in text form:

1. Fresh Installation

NO previous version of DECALmachine installed

  • start Blender, bring up preferences
  • switch to the Add-ons tab and click the Install... button at the top right
  • locate the downloaded DECALmachine_2.0.1.zip file and double-click it
  • activate the addon by ticking the checkbox
  • ensure your preferences are saved (by default done automatically)
  • optionally, switch to the Decal Creation + Export tab, and install PIL
  • close preferences and in the 3D View press the D key to bring up the DECALmachine pie menu

2. Update Installation

previous version of DECALmachine installed already

2a. Update Installation in Blender

  • start Blender, bring up preferences
  • switch to the Add-ons tab and use the search input at the top right to find your currently installed DECALmachine version
  • unfold DECALmachine and shift click on the folder icon of the assets path
  • in your filebrowser copy your old decals to a safe location
  • back in Blender, deactivate your currently installed DECALmachine version
    • DO NOT click on the Remove button just yet
  • ensure your preferences are saved (by default done automatically)
  • quit and restart Blender
  • back in the DECALmachine addon preferences, with DM now deactivated, click the Remove button
  • with DM uninstalled, click the Install... button at the top right
  • locate the downloaded DECALmachine_2.0.1.zip file and double-click it
  • activate the addon by ticking the checkbox
  • ensure your preferences are saved (by default done automatically)
  • optionally, switch to the Decal Creation + Export tab, and install PIL
  • close preferences and in the 3D View press the D key to bring up the DECALmachine pie menu

2b. Update Installation in the File Browser

Attention

Never install DECALmachine in Blender's program folder.
On Windows, that would be C:\Program Files\... DECALmachine needs write access to its installation folder, so you need to install it into Blender's addons folder.

  • with Blender closed, navigate to Blender's addons folder
  • find DECALmachine, and copy the DECALmachine/assets/Decals folder to a save location to backup your existing decals
  • remove the DECALmachine folder
  • in your Downloads location, extract the DECALmachine_2.0.1.zip file
  • copy the DECALmachine folder from the zip file to Blender's addons folder
    • note, if you have a DECALmachine_2.0.1 folder after extraction, don't copy this one, instead copy the DECALmachine folder contained in it
  • start Blender and check if the pie menu (D key) comes up
  • if your previous DECALmachine version had its decals stored externally, so not in the DECALmachine folder in Blenders addons directory do the following:
    • go to the addon preferences, find DECALmachine and check the assets location
    • reset it using the backwards arrow next to the folder icon
    • ignore the error that pops up and MAKE SURE your preferences are saved
    • start Blender and check if the pie menu (D key) comes up
  • optionally, switch to the Decal Creation tab, and install PIL if it isn't already

Blender's Addons Folder

Addons Folder (in user scripts location)

Linux: /home/name/.config/blender/2.83/scripts/addons
MacOS: /Users/name/Library/Application Support/Blender/2.83/scripts/addons
Windows: C:\Users\name\AppData\Roaming\Blender Foundation\Blender\2.83\scripts\addons

Depending on your Blender version, replace 2.83 accordingly.


  1. Learn more about AppTranslocation