> For the complete documentation index, see [llms.txt](https://studio-docs.sandbox.game/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://studio-docs.sandbox.game/the-editor/how-to-set-up-fog.md).

# How to set up fog

Add a Fog Node so distant objects fade into haze. This is scene-wide fog: it is not a cloud you place in the world. Position in the Outliner does not matter. If you add a second Fog Node, it replaces the first.

Some projects also place painted fog cards. Those are a different object. This page is the Fog Node.

{% embed url="<https://youtu.be/MqFAN2bPiYE?si=rO8xSeRBD1NObeej>" %}

{% stepper %}
{% step %}

## Open the Add menu

Select the plus button in the Outliner to open the menu for adding content to the scene.
{% endstep %}

{% step %}

## Add a Fog Node

Choose Component, find **Fog Node**, and select it. Its settings appear in the Inspector.

{% hint style="info" %}
*NOTE: New fog is mid-grey and starts close to the camera, so the view can look fully grey. Raise Fog Far or change Fog Color until you can see the scene again.*
{% endhint %}
{% endstep %}

{% step %}

## Choose the fog mode

Open Fog Mode.

* **Linear** — fog starts at Fog Near and is full at Fog Far. Use this when you want a clear distance.
* **Exponential** — fog fills the whole view by density. Use this for even haze.

Those are the only two modes.
{% endstep %}

{% step %}

## Set the fog colour

Adjust Fog Color so the haze matches the lighting: grey for natural mist, a tint for night or stylized light.
{% endstep %}

{% step %}

## Set the linear fog distance

If Fog Mode is Linear, Fog Near is where fade begins and Fog Far is where it is strongest.

{% hint style="info" %}
*TIP: If the fade looks like a hard wall, increase the gap between Fog Near and Fog Far.*
{% endhint %}
{% endstep %}

{% step %}

## Adjust the fog density

If Fog Mode is Exponential, Fog Density controls thickness. Lower it for a light haze. Raise it for thicker fog. Change it in small steps while watching the viewport. Near and Far do not apply in this mode.
{% endstep %}

{% step %}

## Test and reset the effect

Enter Play mode and check the fog from the gameplay camera. Use the reset arrow beside a value to restore its default.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
*TIP: Agents: the class is `ENGINE.FogNode`. Fields are `fogMode` (`linear` / `exponential`), `fogColor`, `fogNear`, `fogFar`, `fogDensity` (0–1).*
{% endhint %}

## What You've Done

The scene fades with distance or density, in a colour that matches the lighting. Next: [How to set up a light](https://studio-docs.sandbox.game/the-editor/how-to-set-up-a-light.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://studio-docs.sandbox.game/the-editor/how-to-set-up-fog.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
