Dressing a level with dirt, leaks and wear one Decal node at a time is slow. Select a layer, switch on Paint, and drag across your walls and floors.
THE BRUSH (Decal Painter dock)
- click to stamp, drag to paint a line of decals, Shift + drag to erase - every stroke is one Undo step
- a ring in the 3D view shows where the decal lands
- size, angle, spacing, scatter, decals per click, depth, tint - each with random variation
- pick one decal, or several for a random mix
- works on any mesh and CSG - no collision shapes needed
- Folder... turns any folder of PNGs into a decal set (normal maps are paired by name)
DECAL OR STICKER - per layer
- Decal mode: Godot's own Decal nodes (Forward+ and Mobile, and Compatibility from Godot 4.8)
- Sticker mode (mesh decals): the piece of surface under the decal is cut out as a mesh - every renderer, the web, Godot 4.7
- Auto picks the right one for your renderer
- Godot 4.8 Compatibility draws at most 8 decals per object and 64 per frame: decals past that become stickers automatically, so nothing silently disappears
- decals are stored as data in the layer, the scene file stays small
FROM CODE
- paint_ray() / paint_at() / remove_near() for bullet and blood decals at runtime (your own textures), procedural dirt, level generators and in-game editors
Included
- the editor plugin, the PDDecalLayer node, brush and decal set resources
- 12 grime decals with normal maps: oil stain, dirt splat, rust streak, water ring, scorch mark, crack, leak drips, moss, paint splash (white - tint it any color), scuff marks, puddle, boot prints
- a playable warehouse demo: paint and erase with the mouse, dress the room with grime from code, switch modes
- README with setup, FAQ and limits, AGENTS.md for AI coding assistants
Every script was written for this kit - safe to use in a game you sell.
Tested in Godot 4.7 (Compatibility renderer) and Godot 4.8 beta 2 (Decal nodes in Compatibility).
No AI-generated images. Code written with AI assistance.
License: use in personal and commercial projects. Do not resell or redistribute the files.
Own our 68 Sci-Fi & Military Decals or the Sci-Fi PBR Decal Atlas? Press Folder... on their texture folder and paint with them.
