menu_bookDocumentation

Decal Component: Projected Surface Effects with Random Variety

calendar_today May 20, 2026 schedule ~1 min read person PatrickJr verified 50

The s&box Decal component draws decals in the game world. It supports multiple DecalDefinitions for random variety without extra code.

Setup

Add a Decal component to a GameObject. Define one or more DecalDefinition assets — when multiple are defined, one is chosen at random on spawn.

Randomizing Properties

Certain properties support range-based randomization. For example, set rotation to a range of 0-360 and each spawned decal picks a random angle. This creates variety and avoids visible patterns without requiring code.

Usage

Decals project onto surfaces within their volume. They're commonly used for:
  • Bullet holes and impact marks
  • Blood splatters
  • Graffiti and environmental storytelling
  • Damage indicators on surfaces
The component works well as a prefab — create a decal prefab with multiple definitions and randomized properties for reusable, varied environmental effects across your scenes.
Was this helpful?