> For the complete documentation index, see [llms.txt](https://docs.realcity.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realcity.dev/script-docs/rc-loadingscreen/configuracion.md).

# Configuración

## Guía de Configuración

Esta guía detalla cómo configurar y personalizar la pantalla de carga `rc-loadingscreen` para tu servidor. La configuración principal se gestiona a través de dos archivos clave: `web/config.js` para los ajustes de funcionalidad y `web/locales.js` para los textos e idiomas.

***

### Configuración General (`web/config.js`)

Este es el archivo principal para ajustar el comportamiento y la apariencia de la pantalla de carga.

#### Idioma

Define el idioma por defecto de la interfaz. Los idiomas disponibles están en `web/locales.js`.

```javascript
const config = {
    language: 'es', // 'es' para español, 'en' para inglés
```

#### Audio

Controla el volumen de los diferentes efectos de sonido de la interfaz.

```javascript
audio: {
    powerOnVolume: 0.5,   // Volumen del sonido de encendido
    switchVolume: 0.5,    // Volumen del cambio de canal
    staticVolume: 0.3,    // Volumen del ruido estático
    humVolume: 0.3,       // Volumen del zumbido de fondo
},
```

#### YouTube

Configura el vídeo de YouTube que se reproduce de fondo en uno de los canales.

```javascript
youtube: {
    videoId: 'FND0z4NF8Pg', // ID del vídeo de YouTube
    volume: 50              // Volumen del vídeo (0-100)
},
```

#### Logo del Servidor

Activa y personaliza el logo de tu servidor.

```javascript
logo: {
    enabled: true,  // true para mostrar, false para ocultar
    url: './logo_server_el_vinculo.png', // Ruta a tu imagen de logo
    style: {
        width: '150px',
        position: 'absolute',
        top: '30px',
        right: '30px',
        opacity: '0.8'
    }
},
```

#### Teletexto

El teletexto es el menú principal de información. Aquí puedes definir el nombre del servidor, el enlace a Discord, el personal y las diferentes páginas de información.

```javascript
teletext: {
    serverName: "RealCity Developments RP",
    discordURL: 'discord.realcity.dev',
    staff: [
        { "class": "red", "text": "[Fundador] xByMarcos" },
        // ... más miembros del staff
    ],
    pages: [
        {
            id: 'p101',
            area: 'status',
            title: 'BIENVENIDO',
            content: [
                'Bienvenido a <span class="cyan">{serverName}</span>!',
                'Jugadores conectados: {playerCount}',
                'Unete a nuestro Discord: <span class="yellow">{discordURL}</span>'
                // ... más contenido
            ]
        },
        // ... más páginas
    ]
}
```

***

### Localización e Idiomas (`web/locales.js`)

Este archivo contiene todas las cadenas de texto utilizadas en la interfaz, separadas por idioma. Puedes editar los textos existentes o añadir nuevos idiomas.

#### Estructura

El objeto `locales` contiene un objeto por cada idioma (`es`, `en`, etc.).

```javascript
const locales = {
    'es': {
        "page_title": "Retro CRT Loader v5.0 - Final Experience",
        "muted": "SILENCIO",
        "connecting_server": "CONECTANDO CON EL SERVIDOR...",
        // ... más traducciones
    },
    'en': {
        "page_title": "Retro CRT Loader v5.0 - Final Experience",
        "muted": "MUTED",
        "connecting_server": "CONNECTING TO SERVER...",
        // ... más traducciones
    }
};
```

#### Añadir un Nuevo Idioma

1. Copia el bloque completo de un idioma existente (por ejemplo, `'en': { ... }`).
2. Pégalo al final del objeto `locales`.
3. Cambia el código del idioma (ej. `'fr'` para francés).
4. Traduce todos los textos al nuevo idioma.
5. Finalmente, actualiza la opción `language` en `web/config.js` para que coincida con el nuevo código de idioma (ej. `language: 'fr'`).