> 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/troubleshooting.md).

# Problemas frecuentes

Problemas habituales de Cuxial Anuncios, con su causa y su solución.

Los problemas más habituales después de instalar Cuxial Anuncios, con la causa y la solución de cada uno.

<details>

<summary>El recurso no arranca</summary>

**Causa.** Falta una dependencia o arranca después que el script. Cuxial Anuncios necesita `ox_lib`, `oxmysql` y `cuxial_bridge`.

**Solución.** Arranca primero las dependencias:

{% code title="server.cfg" %}

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_anuncios
```

{% endcode %}

</details>

<details>

<summary>/anuncio responde que el trabajo no tiene un estilo de anuncio</summary>

La notificación dice `Tu trabajo no tiene un estilo de anuncio configurado.`

**Causa.** No hay un estilo para el trabajo actual del jugador, o el estilo se guardó con otro nombre de trabajo. El nombre se compara de forma exacta, mayúsculas y minúsculas incluidas.

**Solución.** Abre el panel y crea o edita el estilo. En el campo del trabajo escribe el nombre interno, por ejemplo `police`, no su etiqueta.

</details>

<details>

<summary>/crearanuncio responde que no tienes permisos</summary>

La notificación dice `No tienes permisos para usar este comando.`

**Causa.** Tu cuenta no tiene el permiso indicado en `adminPermission`.

**Solución.** Dale ese permiso a tu cuenta en tu framework, o cambia `adminPermission` en `shared/config.lua` por uno que ya tengas. En ESX, el valor por defecto `'admin'` cubre los grupos `admin` y `superadmin`.

</details>

<details>

<summary>/anuncio le pide al jugador que espere</summary>

**Causa.** El jugador envió un anuncio hace menos de `cooldown` segundos.

**Solución.** No hace falta ninguna. Para acortar la espera, baja `cooldown` en `shared/config.lua`.

</details>

<details>

<summary>El anuncio sale sin logo o sin fondo</summary>

**Causa.** El campo de la imagen tiene un nombre de archivo que no está en el recurso, o un enlace que no empieza por `http://` o `https://`.

**Solución.** Pon los logos en `web/build/images/icons/` y los fondos en `web/build/images/background/`, escribe el nombre del archivo con su extensión y reinicia el recurso. Si es un enlace, usa la URL completa.

</details>

<details>

<summary>El anuncio no suena</summary>

**Causa.** El archivo de sonido no está en `web/build/sounds/`, el enlace no es accesible o el volumen del estilo es `0`.

**Solución.** Deja vacío el campo del sonido para usar el sonido por defecto, o revisa el nombre del archivo y el volumen en el estilo. El panel tiene un botón para probar el sonido.

</details>

<details>

<summary>El panel no se abre, o los anuncios nunca aparecen</summary>

**Causa.** La interfaz no está cargando. La carpeta `web/build` falta o está incompleta, normalmente tras una subida a medias.

**Solución.** Comprueba que `web/build/index.html` existe dentro del recurso. Si no está, vuelve a copiar el recurso desde el paquete original y reinicia el servidor.

</details>

<details>

<summary>Los estilos se pierden tras un reinicio, o no se pueden guardar</summary>

**Causa.** La tabla `cuxial_anuncios` no se pudo crear o leer. La consola del servidor muestra `[CuxialAnuncios] error al cargar estilos desde la base de datos` o un error de `oxmysql`.

**Solución.** Revisa la conexión de `oxmysql` y que el usuario de la base de datos pueda crear tablas. Después reinicia el recurso.

</details>

<details>

<summary>Un anuncio aparece con retraso</summary>

**Causa.** Los anuncios van en cola. Cada uno espera a que termine el anterior.

**Solución.** No hace falta ninguna. Para acortar la cola, baja `duration` o sube `cooldown`.

</details>


---

# 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/troubleshooting.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.