> For the complete documentation index, see [llms.txt](https://docs.cuxial.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cuxial.com/scripts/es/interfaz/cuxial-anuncios/configuration.md).

# Configuración

Todas las opciones de Cuxial Anuncios: el archivo de configuración y los estilos creados en el juego.

Cuxial Anuncios se ajusta en dos sitios: `shared/config.lua` para los comandos y los tiempos, y el panel dentro del juego para el aspecto de los anuncios de cada trabajo.

## Archivo de configuración

Reinicia el recurso después de cualquier cambio.

| Opción            | Tipo         | Por defecto      | Qué hace                                                                                                                                                                |
| ----------------- | ------------ | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `command`         | string       | `'anuncio'`      | Nombre del comando con el que los jugadores envían un anuncio.                                                                                                          |
| `adminCommand`    | string       | `'crearanuncio'` | Nombre del comando que abre el panel de estilos.                                                                                                                        |
| `adminPermission` | string       | `'admin'`        | Permiso necesario para abrir el panel y para crear, editar o borrar estilos. Consulta [Comandos y permisos](/scripts/es/interfaz/cuxial-anuncios/commands.md#permisos). |
| `cooldown`        | number       | `30`             | Segundos que un jugador debe esperar entre dos anuncios. `0` quita la espera.                                                                                           |
| `duration`        | number       | `15000`          | Tiempo que cada anuncio permanece en pantalla, en milisegundos.                                                                                                         |
| `accentColor`     | string (hex) | configurable     | Color de acento del panel de estilos. No cambia los anuncios.                                                                                                           |

### Ejemplo

Cambiar el nombre de los comandos y permitir un anuncio por minuto:

{% code title="shared/config.lua" %}

```lua
return {
    command = 'announce',
    adminCommand = 'announcestyles',
    adminPermission = 'admin',
    cooldown = 60,
    duration = 15000,
    accentColor = '#e53935',
}
```

{% endcode %}

## Estilos de anuncio

Los estilos no están en un archivo. El staff los crea dentro del juego con el comando del panel, y se guardan en la tabla `cuxial_anuncios` de la base de datos. Un cambio se aplica al siguiente anuncio; no hace falta reiniciar.

Hay un estilo por trabajo. Guardar un estilo nuevo para un trabajo que ya tiene uno lo sustituye.

### General

| Campo                            | Qué es                                                                                                                                                                             |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Título                           | Texto que aparece como encabezado del anuncio. Obligatorio. Hasta 100 caracteres.                                                                                                  |
| Trabajo                          | Nombre interno del trabajo, por ejemplo `police`. Obligatorio. Tiene que coincidir exactamente con el nombre del trabajo en tu framework, no con su etiqueta. Hasta 50 caracteres. |
| Imagen del logo                  | Un nombre de archivo o una URL `http(s)` completa.                                                                                                                                 |
| Capa, tamaño y posición del logo | Dónde va el logo: dentro de la plantilla, delante de la tarjeta o detrás; su tamaño y su desplazamiento.                                                                           |
| Imagen de fondo                  | Un nombre de archivo o una URL `http(s)` completa, con su opacidad.                                                                                                                |
| Colores                          | Color del título, fondo del título, color del texto y color de fondo.                                                                                                              |

### Diseño

| Campo                | Qué es                                                                                                                                                        |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Plantilla            | Una de las 11 disposiciones de la tarjeta.                                                                                                                    |
| Posición en pantalla | Uno de los 8 anclajes: las cuatro esquinas, arriba al centro, abajo al centro, centro izquierda y centro derecha.                                             |
| Animación            | Una de las 16 animaciones de entrada.                                                                                                                         |
| Máscara del logo     | Forma que recorta el logo: círculo, hexágono, estrella y otras.                                                                                               |
| Fuente               | La fuente de la plantilla o una de las 8 alternativas.                                                                                                        |
| Sonido y volumen     | Un nombre de archivo o una URL `http(s)` completa, y un volumen de 0 a 100. Vacío reproduce el sonido por defecto.                                            |
| Efectos              | Degradado de fondo, borde animado, destello, línea de acento, líneas diagonales y resplandor. Cada uno se activa por separado y tiene su color y sus ajustes. |

### Usar tus propias imágenes y sonidos

Un valor que empieza por `http://` o `https://` se carga como URL. Cualquier otro se trata como un nombre de archivo dentro del recurso:

| Campo           | Carpeta                        |
| --------------- | ------------------------------ |
| Imagen del logo | `web/build/images/icons/`      |
| Imagen de fondo | `web/build/images/background/` |
| Sonido          | `web/build/sounds/`            |

El paquete incluye el fondo `background.jpg` y el sonido por defecto `anuncio.ogg`. Crea la carpeta `web/build/images/icons/` para tus logos si no existe. Después de añadir archivos, reinicia el recurso para que los jugadores los descarguen.

{% hint style="warning" %}
Actualizar el script sustituye la carpeta del recurso. Guarda una copia de las imágenes y los sonidos que hayas añadido y vuelve a ponerlos después de cada actualización. Los estilos no se pierden: están en la base de datos.
{% endhint %}


---

# 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://docs.cuxial.com/scripts/es/interfaz/cuxial-anuncios/configuration.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.