Skip to content

SpotLight

Supported Class World & Effects

A light source that emits light directionally in the shape of a cone with a spherical base.

Description

A Spotlight emits light of a specified Color and Brightness in the shape of a cone with a spherical base. This object is ideal for directional light sources like flashlights and headlights.

Range controls the distance of illumination and Angle defines the angle of light emission from the cone's apex as illustrated below.

A spotlight must be a direct child of a BasePart or Attachment and will exhibit the following behavior:

  • When the spotlight is parented to a BasePart, the Face property determines the face of the part from which light emanates.

  • Although Attachments don't have faces, the Face property determines the axis of the attachment from which light emanates; -Z is front, +X is right, +Y is top, etc.

See also SurfaceLight and PointLight.

Inheritance

Object → Instance → Light → SpotLight

Nova inheritance: Instance → Light → SpotLight

Properties

Angle Supported Property The angle of which the light is shone from the SpotLight.
Angle: float

The angle of which the light is shone from the SpotLight.

Roblox documentation

Face Supported Property Sets the side of the parent that the SpotLight comes from.
Face: NormalId

Sets the side of the parent that the SpotLight comes from.

Roblox documentation

Range Supported Property The size of the area that the SpotLight will illuminate.
Range: float

The size of the area that the SpotLight will illuminate.

Roblox documentation

Inherited members

Inherited from Light: 12 properties, 36 methods, 7 events. They are documented on the base class page.

Roblox reference: SpotLight

Generated from Nova's API dump and Roblox creator-docs. Nova-only members come from the engine's reflection metadata.