Skip to Content
Kinemium

Decal

Project a texture onto one face of a part.

Decal paints a texture onto one face of a parent part. Use it for signs, labels, grime, posters, and any detail that doesn't need its own geometry.

Getting started

local decal = Instance.new("Decal")
decal.Texture = "textures/sign.png"
decal.Face = Enum.NormalId.Front
decal.Parent = part

Parent the decal to a Part that's in the Workspace. A decal parented anywhere else, or to a part outside the world, doesn't render.

Properties

PropertyTypeAccessDefaultDescription
TexturestringRead/write""Asset path of the texture.
Color3Color3Read/writeWhiteTint applied to the texture.
TransparencynumberRead/write0Transparency, clamped between 0 and 1.
FaceEnum.NormalIdRead/writeEnum.NormalId.FrontThe part face the decal is placed on.
StudsPerTileUnumberRead/write1Horizontal tiling size in studs. Values below 0.001 clamp.
StudsPerTileVnumberRead/write1Vertical tiling size in studs. Values below 0.001 clamp.
OffsetStudsUnumberRead/write0Horizontal offset in studs.
OffsetStudsVnumberRead/write0Vertical offset in studs.
ZOffsetnumberRead/write0.002Distance from the face, used to avoid z-fighting.
EnabledbooleanRead/writetrueWhether the decal renders.
CullingbooleanRead/writefalseWhether face culling applies to the decal.
CastShadowsbooleanRead/writefalseWhether the decal casts shadows.
ReceiveShadowsbooleanRead/writetrueWhether the decal receives shadows.

Color3, not Color, is the tint property on a decal. That's the name to use when reading or writing it.

Positioning on a face

Face selects the surface. StudsPerTileU and StudsPerTileV control how many studs one copy of the texture covers; smaller values repeat the texture more often.

decal.Face = Enum.NormalId.Top
decal.StudsPerTileU = 4
decal.StudsPerTileV = 4
decal.OffsetStudsU = 2

ZOffset nudges the decal off the surface. The default is small; raise it if the texture flickers against the part.

Notes

  • A decal has no methods or events of its own.
  • Only one face is decorated per decal. Use several decals for several faces.
  • Removing the parent part removes the decal with it.
  • Cloning copies the texture, tint, face, tiling, offsets, and shadow settings, but not the loaded renderer texture.
  • Texture accepts asset paths; the loaded texture is resolved through the asset store, and a missing texture leaves the decal invisible.

See also

  • Part, the surface a decal sits on.
  • MeshPart, meshes with their own texture.
  • MaterialVariant, whole-material appearance changes.

On this page