> 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/help/es/common-errors.md).

# Errores comunes

Errores que pueden aparecer con cualquier script de Cuxial, con su causa y su solución.

Errores que no dependen de un script concreto. Cada entrada da el síntoma, por qué ocurre y cómo se arregla.

## En el lado del jugador

### El cursor aparece pero la interfaz no

**Síntoma.** Un jugador abre un menú y le sale el cursor del ratón, pero no se dibuja nada en pantalla. El resto de jugadores del mismo servidor lo ven bien.

**Causa.** La fecha o la hora del Windows de ese jugador está muy lejos de la real. Con el reloj muy desajustado, las interfaces pueden no mostrarse aunque el script las haya abierto.

**Solución.** Sincronizar la hora de Windows y reiniciar FiveM.

{% stepper %}
{% step %}

## Abre los ajustes de fecha y hora

**Configuración** de Windows → **Hora e idioma** → **Fecha y hora**.
{% endstep %}

{% step %}

## Activa la hora automática

Activa **Establecer la hora automáticamente** y **Establecer la zona horaria automáticamente**.
{% endstep %}

{% step %}

## Sincroniza

Pulsa **Sincronizar ahora**, cierra FiveM del todo y vuelve a entrar.
{% endstep %}
{% endstepper %}

{% hint style="info" %}
Una forma rápida de distinguirlo de un problema del servidor: si le pasa a un solo jugador, es su ordenador. Si les pasa a todos, mira la consola del servidor.
{% endhint %}

## Al arrancar el servidor

<details>

<summary>Could not find dependency ... for resource ...</summary>

**Causa.** Falta un recurso obligatorio, se ha renombrado o arranca después del script.

**Solución.** Instala el recurso que nombra el mensaje y pon su `ensure` por encima del script. Consulta [Requisitos](https://app.gitbook.com/s/c1vTiuxzHZEc7cOaWuML/getting-started/requirements).

</details>

<details>

<summary>Could not find dependency /onesync</summary>

**Causa.** OneSync está desactivado. Todos los scripts de Cuxial lo necesitan.

**Solución.** Activa OneSync en txAdmin, o añade `set onesync on` a la configuración del servidor, y reinicia el servidor.

</details>

<details>

<summary>You lack the required entitlement to use ...</summary>

**Causa.** La clave de licencia del servidor no pertenece a la cuenta de Cfx.re dueña del script.

**Solución.** Usa una clave de licencia generada con la cuenta que lo compró y reinicia el servidor. Más en las [Preguntas frecuentes](/help/es/faq.md).

</details>

<details>

<summary>El script no carga después de subirlo por FTP</summary>

**Causa.** La subida quedó incompleta o los archivos se alteraron por el camino. Los scripts protegidos necesitan todos sus archivos intactos, incluido el archivo `.fxap` de la carpeta del script.

**Solución.** Borra la carpeta en el servidor y vuelve a subirla desde la descarga original. Comprueba que se incluyen los archivos ocultos y los que no tienen una extensión conocida.

</details>

<details>

<summary>[cuxial_bridge] aviso: no se detectó framework, usando fallback "qbox"</summary>

**Causa.** No había ningún framework compatible en marcha cuando cargó el script, así que Cuxial Bridge asumió QBox.

**Solución.** Arranca tu framework antes que `cuxial_bridge` y que los scripts de Cuxial. Si la carpeta de tu framework tiene un nombre no estándar, fuérzalo como se explica en [Cuxial Bridge](https://app.gitbook.com/s/c1vTiuxzHZEc7cOaWuML/getting-started/cuxial-bridge).

</details>

<details>

<summary>Un error menciona @cuxial_bridge/init.lua o @ox_lib/init.lua</summary>

**Causa.** `cuxial_bridge` u `ox_lib` falta, se ha renombrado o arranca después del script.

**Solución.** Conserva los nombres de carpeta originales y arranca los dos antes que cualquier script de Cuxial.

</details>

<details>

<summary>Un error de base de datos dice que una tabla no existe</summary>

**Causa.** No se ejecutó el SQL del script, o se ejecutó en una base de datos distinta de la que usa `oxmysql`.

**Solución.** Ejecuta los archivos SQL de la carpeta `install` del script en la base de datos de tu servidor. La página de instalación del script los enumera.

</details>

## Después de editar archivos

<details>

<summary>El script deja de arrancar después de editar la configuración</summary>

**Causa.** Un error de sintaxis en `shared/config.lua` o en un archivo `data/*.lua`: falta una coma, una comilla o una llave de cierre.

**Solución.** La consola del servidor indica el archivo y la línea. Corrígelo, o restaura el archivo desde tu copia de seguridad, y reinicia el script.

</details>

<details>

<summary>Faltan textos o aparecen como códigos</summary>

**Causa.** El archivo de idioma dejó de ser JSON válido tras editarlo, o el idioma configurado en `ox:locale` no tiene archivo en la carpeta `locales` del script.

**Solución.** Valida el archivo JSON y comprueba que existe el archivo del idioma. Consulta «¿Cómo cambio el idioma?» en las [Preguntas frecuentes](/help/es/faq.md).

</details>

<details>

<summary>Mis cambios no se aplican</summary>

**Causa.** No se reinició el script, o la carpeta editada no es la que carga el servidor.

**Solución.** Reinicia el script o el servidor entero. Si guardas una copia antigua del script dentro de `resources`, quítala: puede que el servidor esté cargando esa.

</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/help/es/common-errors.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.