> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-es/escenas-sdk7/interactividad/skybox-control.md).

# Control del skybox

Puedes cambiar cómo ve un jugador el skybox siempre que esté de pie en tu escena; esto también afecta al tono y la dirección de la iluminación global.

El cielo en Decentraland sigue un ciclo predeterminado de día/noche que tarda 2 horas en completarse, así que hay 12 ciclos completos cada día real. Si la escena no impone una hora fija del día, los jugadores también pueden cambiar a una hora concreta del día moviendo un control deslizante en su UI.

Cada vez que los jugadores entran en una escena con una hora del día diferente, o la escena cambia la hora del día de forma dinámica, el skybox hace una transición suave durante unos segundos a este nuevo valor.

## Hora fija del día

Puedes establecer una hora del día fija para tu escena. Todos los jugadores verán la escena con esta hora del día, y el skybox no seguirá el ciclo de día/noche.

En Creator Hub, abre la configuración de la escena y haz clic en el **Settings** pestaña para encontrar la **Skybox** sección. Desmarca la **Auto** opción y establece la hora del día que quieras.

![](/files/63ea08d1e2b88d4cb4065a5bbd49abecd7819f75)

También puedes establecer la hora del día del skybox en el código de tu escena. Para ello, añade la siguiente sección a tu `scene.json` en el nivel raíz:

```json
 "skyboxConfig": {
    "fixedTime": 36000
  }
```

El número se refiere a la cantidad de segundos desde el inicio del día, con un rango de 0 (que se refiere a *00:00*) hasta 86400 (que se refiere a *24:00*). Cualquier número mayor que 86400 también se interpreta como medianoche.

Aquí hay algunos ejemplos más de valores válidos:

* 0 segundos => *00:00*
* 21600 segundos => *06:00*
* 43200 segundos => *12:00*
* 64800 segundos => *18:00*
* 86400 segundos => *24:00*

## Leer la hora del día

Puedes leer la hora del día desde el código de tu escena usando el `getWorldTime()` función.

```ts
import { getWorldTime } from '~system/Runtime'

executeTask(async () => {
  let time = await getWorldTime({})
  console.log(time.seconds)
})
```

La función devuelve un número entre 0 y 86400, donde 0 es medianoche y 86400 es 24:00. Este valor se actualiza si la escena cambia la hora del día de forma dinámica o si el jugador cambia la hora del día en la UI. De lo contrario, devuelve el valor relativo al ciclo predeterminado de día/noche.

## Cambiar la hora del día de forma dinámica

Puedes cambiar la hora del día de forma dinámica usando el `SkyboxTime` componente. Este componente solo puede añadirse a la RootEntity de la escena `engine.RootEntity`.

```ts
import { SkyboxTime } from '@dcl/sdk/ecs'

function main() {
  SkyboxTime.create(engine.RootEntity, { fixedTime: 36000 })
}
```

El `fixed_time` la propiedad es un número entre 0 y 86400, donde 0 es medianoche y 86400 es 24:00. Cualquier número mayor que 86400 también se interpreta como medianoche.

Cada vez que este componente se agrega, se elimina o la `fixed_time` propiedad cambia, la hora del día del skybox hace una transición suave durante unos segundos a este nuevo valor. Lo mismo ocurre cuando el jugador sale o entra en la escena. Mientras la hora del día del skybox esté fija, el skybox ya no seguirá el progreso de su ciclo de día/noche y los jugadores no podrán cambiar la hora del día a través de la UI.

De forma predeterminada, la transición siempre ocurre en dirección hacia adelante, pero puedes cambiar esto configurando el `transitionMode` propiedad a `TransitionMode.TM_FORWARD` o `TransitionMode.TM_BACKWARD`.

```ts
import { SkyboxTime, TransitionMode } from '@dcl/sdk/ecs'

function main() {
  SkyboxTime.create(engine.RootEntity, { fixedTime: 36000, transitionMode: TransitionMode.TM_BACKWARD })
}
```


---

# 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 dynamically by asking a question.

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

```
GET https://docs.decentraland.org/creator/content-creator-es/escenas-sdk7/interactividad/skybox-control.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
