Skip to Content
Kinemium

SurfaceLight

Light an area outward from one face of a part.

SurfaceLight emits from the surface of a part face rather than from a point. It's useful for glowing panels, screens, and ceiling fixtures.

Getting started

local light = Instance.new("SurfaceLight")
light.Face = Enum.NormalId.Bottom
light.Angle = 120
light.Range = 24
light.Brightness = 2
light.Parent = ceilingPanel

Properties

PropertyTypeAccessDefaultDescription
BrightnessnumberRead/write1Light strength, clamped to 0 or above.
ColorColor3Read/writeWhiteLight color.
EnabledbooleanRead/writetrueWhether the light is emitted.
ShadowsbooleanRead/writefalseWhether the light casts shadows.
AnglenumberRead/write90Spread angle in degrees, clamped to 0 through 180.
FaceEnum.NormalIdRead/writeFrontFace of the part the light emits from.
RangenumberRead/write16Falloff distance in studs, clamped to 0 or above.

Notes

  • The light origin sits on the chosen face, at the face's center offset by half the part size.
  • Unlike SpotLight, the emitter is placed on the surface, which suits panels and signs.
  • The parent must be a Part inside the workspace.
  • Cloning copies the angle, face, range, and shared light settings.

See also

  • SpotLight for a light pulled back to the part center.
  • PointLight for omni-directional light.
  • Light for the shared settings.

On this page