> For the complete documentation index, see [llms.txt](https://juguitostudio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://juguitostudio.gitbook.io/docs/js_loadingscreen/config.md).

# Configuración

Toda la configuración del script se encuentra en dos archivos:

* `config.lua`: Para comportamiento del servidor y control de spawn.
* `web/config.js`: Para el renderizado inmediato del navegador CEF al conectarse.

Ambos archivos contienen exactamente las mismas opciones para que todo esté sincronizado.

***

## 🌐 Configuración General

```lua
Config.Locale = 'es'          -- Idioma: 'es' | 'en' | añade tu propio archivo en locales/
Config.Framework = 'auto'     -- 'auto' | 'esx' | 'qb' | 'qbx' | 'standalone'
Config.Debug = false          -- Logs de depuración en consola
```

***

## 🎨 Estética & Modo Minimalista (`Config.UI`)

| Opción               | Tipo      | Descripción                                                                                       | Por Defecto |
| -------------------- | --------- | ------------------------------------------------------------------------------------------------- | ----------- |
| `AccentColor`        | `string`  | Color principal de realce (hex)                                                                   | `'#5b7cff'` |
| `Minimalist`         | `boolean` | Deja el centro 100% despejado para vídeos                                                         | `true`      |
| `StartWithModalOpen` | `boolean` | Si es `true`, abre una tarjeta al inicio. Si es `false`, inicia con la pantalla totalmente libre. | `false`     |
| `VignetteOnly`       | `boolean` | Elimina desenfoques sobre el vídeo, dejando solo sombra suave en los bordes                       | `true`      |
| `Darkness`           | `number`  | Nivel de oscuridad sobre el fondo (0.0 a 1.0)                                                     | `0.18`      |
| `CinemaModeKey`      | `string`  | Tecla para alternar el Modo Cine (ocultar toda la UI)                                             | `'H'`       |
| `SoundEffects`       | `boolean` | Activar efectos de sonido al interactuar                                                          | `true`      |
| `ShowVisualizer`     | `boolean` | Mostrar u ocultar el mini ecualizador procedural                                                  | `true`      |

***

## 🎬 Fondos & Vídeo (`Config.Background`)

Configuración ultra-limpia sin duplicaciones:

```lua
Config.Background = {
    -- Options: 'video' | 'images'
    Mode = 'video',

    -- [Mode: 'video'] Enable video sound:
    -- true  -> Plays audio directly from video; bottom player controls volume/mute/pause.
    -- false -> Keeps video muted so Config.Audio playlist plays instead.
    EnableAudio = true,

    -- [Mode: 'video'] Video Playlist: Multiple local videos with Title and Author
    -- Video files should be placed inside web/assets/video/
    -- Use the Previous / Next buttons to switch videos in real time!
    Videos = {
        {
            Title  = 'Los Santos Sunset',
            Author = 'Logic Films',
            File   = 'assets/video/video1.mp4',
        },
        {
            Title  = 'HAPPY NEW YEAR!',
            Author = 'Logic Films',
            File   = 'assets/video/video2.mp4',
        },
    },

    -- [Mode: 'images'] Image slideshow list (local paths or external URLs)
    Images = {
        'https://images.unsplash.com/photo-1518709268805-4e9042af9f23?q=80&w=1920&auto=format&fit=crop',
        'https://images.unsplash.com/photo-1509198397868-475647b2a1e5?q=80&w=1920&auto=format&fit=crop',
    },

    -- [Mode: 'images'] Slideshow rotation interval in seconds
    Interval = 6,
}
```

***

## 🎵 Music Player (`Config.Audio`)

```lua
Config.Audio = {
    -- Enable background music player
    Enabled       = true,

    -- Automatically start playing when loading screen opens
    Autoplay      = true,

    -- Default volume percentage (0 to 100)
    DefaultVolume = 30,

    -- Local song playlist: Add as many local audio tracks as you want
    -- Audio files should be placed inside web/assets/audio/
    Playlist = {
        {
            Title  = 'Synthwave Chill',
            Artist = 'Juguito Studio',
            File   = 'assets/audio/song.mp3',
        },
        {
            Title  = 'Night Drive',
            Artist = 'Retro Wave',
            File   = 'assets/audio/song.mp3',
        },
    },
}
```

***

## 🏰 Identidad del Servidor & Enlaces (`Config.Server`)

```lua
Config.Server = {
    Name    = 'JUGUITO ROLEPLAY',
    Slogan  = 'Premium Roleplay Experience & Active Community',
    Logo    = 'assets/images/logo.png',
    Discord = 'https://discord.gg/zXMupaGSRj',
    Website = 'https://juguitostudio.gitbook.io/docs/',
    Store   = 'https://juguitostudio.tebex.store',
    Youtube = 'https://youtube.com/@juguitostudio',
}
```

***

## 🚀 Control de Salida (`Config.Shutdown`)

```lua
Config.Shutdown = {
    -- Si es true, el jugador debe presionar [ESPACIO] o [ENTER] al llegar al 100% para entrar
    -- Si es false, se cierra automáticamente al terminar de cargar
    RequireKeyPress    = true,

    -- Retraso en ms antes de cerrar (si RequireKeyPress = false)
    AutoCloseDelayMs   = 1200,

    -- Duración del desvanecimiento (fade out) de la UI y del audio
    FadeOutDurationMs  = 800,
}
```


---

# 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://juguitostudio.gitbook.io/docs/js_loadingscreen/config.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.
