Export¶
A decal can leave Decal Workshop in two ways: saved in the library with its maps, or exported in bulk for other tools with Export Library.
Maps written with every library save¶
When you use Save As, Replace Entry or Save Asset, the entry folder holds the editable decal and its maps. This is the decal export. You pick the resolution (512, 1024 or 2048) and the anti-aliasing in the save dialog. See The Library.
| File | Content |
|---|---|
decal.json |
The editable layers and settings. It makes the decal editable again, and tells other tools how to read the maps |
normal.png |
16-bit RGB normal map, tangent space, OpenGL (+Y) |
ao_curv_height.png |
16-bit RGB. R = ambient occlusion, a neutral placeholder. G = curvature, a neutral placeholder. B = height, 0.5 is neutral |
masks.png |
16-bit RGB. R = footprint of the visible shapes. G and B = weights of the first and second material |
color.png |
8-bit sRGB color with alpha, written only when a layer paints |
materials_N.png |
Weights of the third material and up, three per file, written when a layer paints |
decal.png |
A 256 x 256 thumbnail used by the library |
Keep the whole folder
A decal folder may also contain image and font files the editable layers need. When you copy or move a decal, copy the whole folder, not only the PNG maps. An exported bitmap alone cannot be edited again.
Export Library¶
Export Library converts a whole library folder for other tools, in one go.
Click the Export button, at the bottom of the icon column beside the library thumbnail. It exports the folder you are browsing.

How to export¶
- In the library, browse the folder you want to export (or All).
- Click the Export button.
- In the dialog, check the Library Folder and choose a new Export Folder.
- Pick what to export with the four buttons: PBR, DECALmachine, Atlas or All.
- Set the Map Resolution and Anti-aliasing.
- Confirm.
| Option | Default | Notes |
|---|---|---|
| Library Folder | The browsed folder | Folders inside it are included |
| Export Folder | A new DecalWorkshop_Exports folder next to your library |
Must be new or empty, and outside the library folder |
| Export (mode) | All | See below |
| Map Resolution | 1024 | 512, 1024 or 2048 |
| Anti-aliasing | 2 x 2 | 1 x 1, 2 x 2 or 4 x 4 |
| Atlas Size | 4096 | 2048, 4096 or 8192. Only for Atlas and All |
| Padding | 16 px | Border around each decal in an atlas page |
| Trim Transparent Borders | On | Crops empty borders before packing |
It runs in the background¶
The export runs in a separate Blender process, so Blender stays usable. The panel and the status bar show the current step and a progress bar.
Cancel with Esc
Press Esc to cancel. The files already written are kept in the export folder. Your library is never modified.
When it finishes, a message tells you where the files are. If it fails, the message gives the reason and points to the log file in the export folder.
The four modes¶
| Mode | What you get |
|---|---|
| PBR | Generic material textures for every decal, for use in any tool. The editable sources are kept next to them |
| DECALmachine | Native DECALmachine assets built from its installed template |
| Atlas | PBR atlases: many decals packed into pages of textures |
| All | Individual PBR decals, the DECALmachine library and the atlases |
What each output contains¶
PBR (PBR/<decal>/)
| File | Content |
|---|---|
basecolor.png |
Real base color, 8-bit sRGB with straight (not premultiplied) alpha |
normal.png |
OpenGL normal map that includes the material's detail |
roughness.png, metallic.png, opacity.png |
Linear 16-bit maps |
ao_curv_height.png |
Encoded height in the blue channel. AO and curvature are neutral placeholders, marked as such |
emission.png |
Only when the decal glows |
pbr.json |
Describes every channel, color space and how to decode the height |
source/ |
A copy of the original library entry, untouched |
DECALmachine (DECALmachine/Decals/.../<decal>/)
- A native asset built with your installed DECALmachine, with its PBR image links kept through insertion, material matching and projection.
- The parallax Amount is converted for DECALmachine, so there is no stepped distortion at oblique angles.
Atlas (Atlases/)
atlas_000_<channel>.png, one image per channel and page, andatlas.jsondescribing every decal in them (identifiers, UV bounds, how to decode the height).- Deterministic pages, with transparent-border trimming and padding. Tiles are never rotated or downscaled.
At the root of the export folder, report.json and conversion.json list what was exported.
Limits and things to know¶
DECALmachine must be installed
DECALmachine and All modes need the DECALmachine add-on installed and enabled. Without it, the export stops with an error.
DECALmachine and PBR links
The extra PBR image links in a DECALmachine export are an extension from Decal Workshop. DECALmachine's own Add to Library, rebuild, update or atlas operations can replace them. To keep every PBR map, use the Decal Workshop Atlas output, and keep the PBR folder as your master copy.
- The atlas needs the Pillow Python module. If it is missing, an error says so.
- Atlas PNGs are 8-bit per channel. The manifest records any reduction from 16-bit source maps.
- Atlas data is Decal Workshop's own format. It is not a claim of DECALmachine atlas import compatibility.
- AO and curvature are placeholders: they are not baked.
- An entry too large for the atlas size (with padding) stops the export. Raise Atlas Size, since images are never downsampled.
- Only editable Decal Workshop entries are exported. Image-only entries are skipped. A folder with none stops with No editable Decal Workshop decals found in this folder.
- Shader-specific features (coat, specular) are not fully reproduced by the basic PBR channels.
- Ready-made Unreal and Unity importers are not part of the export yet. You get portable textures and atlas data.