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

# Problemas frecuentes

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

Los problemas más habituales tras instalar Cuxial Chipeo, 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. Cuxial Chipeo necesita `ox_lib`, `oxmysql` y `cuxial_bridge`, además de OneSync.

**Solución.** Activa OneSync y arranca antes las dependencias:

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

```cfg
ensure oxmysql
ensure ox_lib
ensure cuxial_bridge
ensure cuxial_chipeo
```

{% endcode %}

</details>

<details>

<summary>Usar un ítem no hace nada</summary>

**Causa.** Una de estas:

* El ítem no tiene la línea `client.export`, o el export no coincide con `cuxial_chipeo.<nombre del ítem>`.
* El nombre del ítem en el inventario es distinto del de `shared/config.lua`.
* Se cambió el nombre de la carpeta del recurso, así que el export apunta a un recurso que no existe.
* El servidor usa un inventario que no es `ox_inventory`.

**Solución.** Copia las definiciones de ítems de [Instalación](/scripts/es/vehiculos/cuxial-chipeo/installation.md), deja la carpeta con el nombre `cuxial_chipeo` y reinicia el servidor.

</details>

<details>

<summary>«Este vehículo no admite un equipo de sonido»</summary>

**Causa.** El modelo está en `vehicles.blacklist`.

**Solución.** Quita el modelo de la lista.

</details>

<details>

<summary>«Solo el dueño del vehículo puede hacer esto»</summary>

**Causa.** Al instalar: `install.ownerOnly` está en `true` y el jugador no es el dueño del vehículo. Al desinstalar: `install.unmountOwnerOnly` está en `true` y el jugador no es ni el dueño ni quien lo instaló. Un vehículo que no está en la tabla de vehículos de tu framework no tiene dueño.

**Solución.** Pon la opción en `false`, o que lo haga el dueño. Un equipo instalado en un vehículo sin dueño solo lo puede quitar quien lo instaló mientras `unmountOwnerOnly` esté en `true`.

</details>

<details>

<summary>La radio no se abre</summary>

**Causa.** El mensaje indica el caso:

* *No hay ningún vehículo cerca*: vas a pie y no hay ningún vehículo dentro de `remoteRange`.
* *Este vehículo no tiene equipo de sonido*: el vehículo más cercano no tiene equipo. A pie, el comando apunta al vehículo más cercano.
* *No puedes controlar esta radio*: estás fuera y no eres ni el dueño ni quien lo instaló.

**Solución.** Sube al vehículo, o ponte más cerca de él que de cualquier otro.

</details>

<details>

<summary>He cambiado keybind pero la radio se sigue abriendo con la tecla antigua</summary>

**Causa.** `keybind` es solo el valor por defecto. Cuando un jugador ya ha entrado, FiveM recuerda su tecla.

**Solución.** Cada jugador la cambia en los ajustes de GTA, en las asignaciones de teclas de FiveM. Los jugadores nuevos reciben el nuevo valor por defecto.

</details>

<details>

<summary>El enlace se rechaza por no ser válido</summary>

**Causa.** Solo se aceptan enlaces directos a un archivo de audio. El enlace tiene que empezar por `https://`, no llevar espacios ni comillas, no superar `library.maxUrlLength` y acabar en una de las extensiones de `library.allowedExtensions`. La dirección de una página de vídeo o de streaming no acaba en una extensión de audio.

**Solución.** Usa un enlace que apunte al archivo en sí, por ejemplo uno que acabe en `.mp3`. Para aceptar otros formatos, añade la extensión a `library.allowedExtensions`.

</details>

<details>

<summary>La canción suena pero la radio muestra RAW y los bajos y el ecualizador no hacen nada</summary>

**Causa.** El sitio que aloja el archivo no deja que otras páginas procesen su audio (no envía cabeceras CORS). La radio lo reproduce tal cual: el volumen y la distancia funcionan, pero no los bajos, la pegada, el ecualizador, la cabina apagada ni el audio 3D.

**Solución.** Aloja el archivo en un sitio que envíe cabeceras CORS, o usa otro enlace.

</details>

<details>

<summary>La canción se acepta pero no suena nada</summary>

**Causa.** El enlace tiene una forma válida, pero el archivo no se puede cargar: ya no existe, el sitio bloquea el acceso externo o el formato no se puede reproducir. La radio muestra un error de carga.

**Solución.** Abre el enlace en un navegador. Si ahí no suena directamente, tampoco sonará en el juego.

</details>

<details>

<summary>El equipo ha desaparecido de un vehículo</summary>

**Causa.** La instalación se guarda por matrícula. Si la matrícula cambió, el vehículo cuenta como otro distinto.

**Solución.** Recupera la matrícula, o instálalo de nuevo. Desde otro recurso puedes moverlo con los exports `UninstallRadio` e `InstallRadio`. Consulta [Exports y eventos](/scripts/es/vehiculos/cuxial-chipeo/developers.md).

</details>

<details>

<summary>La música se para cuando el vehículo se guarda o desaparece</summary>

**Causa.** La reproducción pertenece al vehículo mientras existe en el mundo. Cuando la entidad desaparece, lo que sonaba se descarta.

**Solución.** Vuelve a darle a reproducir. El equipo, el USB insertado y sus canciones se conservan.

</details>

<details>

<summary>El equipo se fríe demasiado pronto, o las ventanas revientan sin parar</summary>

**Causa.** Los bloques `overheat` y `pressure` son más estrictos de lo que quieres.

**Solución.** Sube `overheat.seconds` u `overheat.bassThreshold`, sube `pressure.seconds` o `pressure.volumeThreshold`, o pon `enabled = false` en cualquiera de los dos bloques. Consulta [Configuración](/scripts/es/vehiculos/cuxial-chipeo/configuration.md).

</details>

<details>

<summary>/repairchipeo dice «No eres mecánico» o lista materiales que faltan</summary>

**Causa.** El trabajo del jugador no está en `mechanic.jobs`, o le falta alguno de los ítems de `mechanic.requirements`. El comando no comprueba si está de servicio.

**Solución.** Añade el nombre del trabajo con `= true` a `mechanic.jobs`, y asegúrate de que los ítems de los materiales existen en el inventario.

</details>

<details>

<summary>Usar un ítem de altavoz no hace nada, o el altavoz no se puede usar</summary>

**Causa.** Una de estas:

* El prop indicado en `items.medusas` no existe en el servidor. El modelo no carga y no se coloca nada.
* No hay ningún target en marcha. El altavoz se coloca pero no ofrece opciones.
* No hay ningún vehículo con equipo dentro de `medusa.pairRange`. El altavoz se coloca sin emparejar y la opción de abrir la radio queda oculta hasta que haya un coche con equipo lo bastante cerca.
* El jugador ya tiene `medusa.maxPerPlayer` altavoces colocados.

**Solución.** Deja en la lista solo props que tu servidor cargue, arranca un target compatible con Cuxial Bridge y coloca el altavoz junto al coche.

</details>

<details>

<summary>El staff no puede usar /removeallchipeo ni /removechipeo</summary>

**Causa.** El jugador no tiene el permiso del framework indicado en `admin.permission`, `'admin'` por defecto.

**Solución.** Da ese permiso a tu staff en tu framework, o pon en `admin.permission` de `shared/config.lua` el permiso que ya tengan, y reinicia el recurso.

</details>

<details>

<summary>La radio no aparece nunca</summary>

**Causa.** La interfaz no está cargando. Falta la carpeta `web/dist` o está incompleta, normalmente por una subida parcial.

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

</details>

<details>

<summary>Los textos salen en otro idioma</summary>

**Causa.** El script sigue la convar `ox:locale`.

**Solución.** Defínela en `server.cfg` y reinicia. Se incluyen `en` y `es`:

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

```cfg
setr ox:locale "es"
```

{% endcode %}

</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/vehiculos/cuxial-chipeo/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.