Lighting

Lighting : Instance

Overview

게임 내 전체 조명 효과를 관리하는 시스템으로, 조명 설정을 통해 게임의 분위기를 정교하게 연출할 수 있습니다.

Atmosphere와 함께 사용하면 안개, 색상 조절 등 사실적인 대기 효과를 구현할 수 있습니다.

Properties

Ambient

Color3

씬 전체의 주변광 색상을 설정합니다. 어두운 영역이나 그림자 안의 기본 밝기에 영향을 줍니다.

Code Samples

AmbientSkyBrightness

number

낮과 밤 전역의 주변광 밝기를 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.AmbientSkyBrightness = 7

AmbientSkyColor

Color3

낮과 밤 전역의 하늘색을 지정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.AmbientSkyColor = Color3.fromRGB(255, 0, 0)

AutoTimeCycle

boolean

낮과 밤의 주기를 자동으로 순환시키는 기능입니다.

활성화하면 Time Flow Speed에 따라 시간이 자연스럽게 변화합니다. 단, 시간 흐름은 런타임 환경에서만 적용됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.AutoTimeCycle = true

Brightness

number

전역 조명의 밝기를 설정합니다. 값이 클수록 씬 전체가 밝아집니다.

Code Samples

ClockTime

number

시간 설정을 통한 낮/밤 표현이 가능하며, 시간에 따라 전역 조명의 방향과 밝기가 조정됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.ClockTime = 20

Contrast

number

하늘의 명암 대비를 조정하여 구름, 대기층, 색상의 깊이감을 높이고 시각적인 몰입도를 강화합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.Contrast = 1.6

GroundReflectionColor

Color3

지면에서 반사되는 빛의 색상을 조정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.GroundReflectionColor = Color3.fromRGB(255, 0, 0)

MoonBrightness

number

달빛의 밝기를 조정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonBrightness = 0.5

MoonCastShadow

boolean

달빛에 의해 그림자가 생성될지 여부를 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonCastShadow = false

MoonLightColor

Color3

달빛의 색상을 지정합니다. 밤 시간대의 자연광 색감을 구현할 수 있습니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonLightColor = Color3.fromRGB(255, 0, 0)

MoonMaterialColor

Color3

달의 표면 색상과 구름 색상을 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonMaterialColor = Color3.fromRGB(255, 0, 0)

MoonMaxHeight

number

달이 도달할 수 있는 최대 고도를 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonMaxHeight = -60

MoonPathAngle

number

달이 이동하는 경로의 각도를 설정합니다. 달의 궤도 변화나 위치를 표현할 때 사용됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonPathAngle = 120

MoonPhase

number

달의 위상(보름달, 반달, 초승달 등)을 조정하여 달의 형태를 변경합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.MoonPhase = 7.5

NightBrightness

number

야간 시간대의 전체 조명 밝기를 설정합니다. 어두운 분위기나 달빛 효과 연출 시 사용됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.NightBrightness = 1.6

RealTimeDayDuration

string

현재 설정된 Time Flow Speed에 따른 실제 낮/밤 주기 지속 시간입니다. (읽기 전용, 예: 20 m / 00 s)

Code Samples

Saturation

number

전역 색상의 채도 수준을 조정합니다. 낮은 값일수록 흐릿하고 높은 값일수록 선명한 색감을 제공합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.Saturation = 0.2

ShadowDetailLevel

Enum.ShadowDetailLevel

씬에 렌더링되는 그림자의 전체 디테일 수준을 설정합니다. 값이 높을수록 더 정교한 그림자를 표현할 수 있지만, 환경에 따라 성능 비용이 증가할 수 있습니다.

Code Samples

SkyColorInfluence

number

안개가 하늘 색상을 얼마나 반영할지를 조절합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Atmosphere.SkyColorInfluence = 0.8

StarsBrightness

number

별의 밝기를 설정합니다. 밤하늘의 별이 얼마나 잘 보이는지를 결정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.StarsBrightness = 2

StarsColor

Color3

별빛의 색상을 지정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.StarsColor = Color3.fromRGB(255, 0, 0)

SunBrightness

number

태양광의 밝기를 설정합니다. 값이 높을수록 더 강한 일광 효과를 냅니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.SunBrightness = 10

SunCastShadow

boolean

태양광이 그림자를 생성할지 여부를 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.SunCastShadow = false

SunLightColor

Color3

태양광의 색상을 지정합니다. 낮 시간대의 자연광 색감을 구현할 수 있습니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.SunLightColor = Color3.fromRGB(255, 0, 0)

SunMaxHeight

number

태양이 도달할 수 있는 최대 높이(고도)를 설정합니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.SunMaxHeight = 100

SunPathAngle

number

태양이 이동하는 경로의 각도를 설정합니다. 계절별 태양 고도나 일조 방향 표현에 사용됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.SunPathAngle = 120

TimeFlowSpeed

number

낮/밤 주기의 진행 속도를 설정합니다. 값이 높을수록 시간 변화가 짧은 주기로 반복됩니다.

Code Samples

local Lighting = game:GetService("Lighting")

Lighting.TimeFlowSpeed = 500

Methods

Events

See also

조명