Skip to Content
Kinemium

SpotLight

Shine a cone of light from a face of a part.

SpotLight emits a cone from one face of its parent part. Aim it with Face, widen it with Angle, and set how far it reaches with Range.

Getting started

local light = Instance.new("SpotLight")
light.Face = Enum.NormalId.Front
light.Angle = 60
light.Range = 30
light.Brightness = 3
light.Shadows = true
light.Parent = fixturePart

Properties

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

Notes

  • The light starts at the parent part's center and points along the chosen face.
  • Angle is the full cone angle; a value of 0 produces a very narrow beam.
  • The parent must be a Part inside the workspace.
  • Cloning copies the angle, face, range, and shared light settings.

See also

  • SurfaceLight for a light spread across a whole face.
  • PointLight for omni-directional light.
  • Light for the shared settings.

On this page