# Lighting

Lighting : `Instance`

## Overview

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

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

## Properties

### Ambient

`Color3`

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

#### Code Samples

### AmbientSkyBrightness

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.AmbientSkyBrightness = 7
```

### AmbientSkyColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### AutoTimeCycle

`boolean`

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

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.AutoTimeCycle = true
```

### Brightness

`number`

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

#### Code Samples

### ClockTime

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.ClockTime = 20
```

### Contrast

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.Contrast = 1.6
```

### GroundReflectionColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### MoonBrightness

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonBrightness = 0.5
```

### MoonCastShadow

`boolean`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonCastShadow = false
```

### MoonLightColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### MoonMaterialColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### MoonMaxHeight

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonMaxHeight = -60
```

### MoonPathAngle

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonPathAngle = 120
```

### MoonPhase

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.MoonPhase = 7.5
```

### NightBrightness

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.NightBrightness = 1.6
```

### RealTimeDayDuration

`string`

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

#### Code Samples

### Saturation

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.Saturation = 0.2
```

### ShadowDetailLevel

`Enum.ShadowDetailLevel`

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

#### Code Samples

### SkyColorInfluence

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Atmosphere.SkyColorInfluence = 0.8
```

### StarsBrightness

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.StarsBrightness = 2
```

### StarsColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### SunBrightness

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunBrightness = 10
```

### SunCastShadow

`boolean`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunCastShadow = false
```

### SunLightColor

`Color3`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

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

### SunMaxHeight

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunMaxHeight = 100
```

### SunPathAngle

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.SunPathAngle = 120
```

### TimeFlowSpeed

`number`

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

#### Code Samples

```lua
local Lighting = game:GetService("Lighting")

Lighting.TimeFlowSpeed = 500
```

## Methods

## Events

## See also

{% content-ref url="/pages/cGsZavn2X2duf7ngJaV6" %}
[조명](/korean/manual/studio-manual/object/lighting.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/development/api-reference/classes/lighting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.