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

# Problemas frecuentes

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

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

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

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure cuxial_gang
```

{% endcode %}

</details>

<details>

<summary>La consola muestra una consulta fallida al arrancar</summary>

**Causa.** El usuario de la base de datos no puede crear o modificar tablas, o la tabla `player_vehicles` no existe porque el framework no es QBox ni QBCore.

**Solución.** Da al usuario permiso para crear y modificar tablas y reinicia. La consola imprime la consulta, sus parámetros y el motivo. Si prefieres crear las tablas a mano, usa los archivos de `install/`.

</details>

<details>

<summary>/crimeadmin no hace nada o no se reconoce</summary>

**Causa.** Al jugador le falta uno de los dos requisitos: el grupo de `commands.panel.restricted` (`group.mod` por defecto) o el ACE de `admin.ace` (`mod` por defecto).

**Solución.** Concede los dos en `server.cfg` y reinicia:

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

```cfg
add_ace group.mod mod allow
add_principal identifier.license:xxxxxxxx group.mod
```

{% endcode %}

</details>

<details>

<summary>Un panel abre el cursor pero no muestra nada</summary>

**Causa.** La interfaz no carga. La carpeta `web/dist` falta o está incompleta, normalmente tras 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 marcadores de la sede no aparecen</summary>

**Causa.** Una de estas:

* Los puntos de la organización nunca se colocaron en el panel de staff.
* El rango del miembro no tiene el permiso de ese punto.
* El servicio necesita una mejora que la organización no ha comprado.
* El servicio está apagado en su archivo (`Disable = true`, o `garage.disabled`).

**Solución.** Coloca los puntos en `/crimeadmin`, revisa el rango en el menú de jefe y compra la mejora.

</details>

<details>

<summary>/crimetablet no existe</summary>

**Causa.** `tablet.asItem` es `true`, así que la tablet solo se abre con el ítem.

**Solución.** Pon `tablet.asItem = false`, o da a los jugadores el ítem indicado en `tablet.item`.

</details>

<details>

<summary>Usar el spray, el quitagrafitis o el móvil desechable no hace nada</summary>

**Causa.** El ítem no existe en tu inventario con el nombre definido en `data/graffiti.lua` o `data/drugselling.lua`, o el inventario no ejecuta el ítem usable que registra el recurso. En los grafitis, `disabled` puede estar en `true`.

**Solución.** Añade los ítems como se indica en [Instalación](/scripts/es/bandas/cuxial-gang/installation.md). Para el spray y el quitagrafitis puedes apuntar el ítem a los exports `cuxial_gang.useSpray` y `cuxial_gang.useRemover`.

</details>

<details>

<summary>No aparece ningún comprador al vender droga</summary>

**Causa.** Una de estas:

* El jugador no lleva ningún ítem de la lista `drugs` de `data/drugselling.lua`.
* Hay menos policías de servicio que `requiredCops`.
* No ha pasado el `cooldown` entre dos usos del móvil desechable.

**Solución.** Pon en `drugs` los ítems de droga de tu servidor y ajusta `requiredCops`.

</details>

<details>

<summary>Las ventas nunca avisan a la policía</summary>

**Causa.** El aviso se envía a través de `cuxial_police`. Sin él en marcha no se envía ninguno.

**Solución.** Arranca `cuxial_police` antes que Cuxial Gang.

</details>

<details>

<summary>Los vehículos de la organización salen sin llaves</summary>

**Causa.** Las llaves se entregan a través de `cuxial_garages`. Sin él en marcha, Cuxial Gang no da llaves.

**Solución.** Arranca `cuxial_garages` antes que Cuxial Gang.

</details>

<details>

<summary>Un vehículo ha desaparecido y el garaje lo muestra como fuera</summary>

**Causa.** El vehículo fue destruido o eliminado mientras estaba fuera.

**Solución.** Un miembro lo recupera desde el garaje pagando `garage.recover.cost`. Tras un reinicio del servidor, los vehículos que estaban fuera vuelven gratis con `garage.returnOnRestart = true`.

</details>

<details>

<summary>El médico clandestino no revive</summary>

**Causa.** El revivir lo hace `cuxial_medical`. Sin él en marcha el médico no hace nada y la consola lo avisa. Además la organización necesita la mejora, y el jugador el precio en el ítem definido en `PriceItem`.

**Solución.** Arranca `cuxial_medical` antes que Cuxial Gang y revisa la mejora y el dinero.

</details>

<details>

<summary>El vestuario no guarda ni pone conjuntos</summary>

**Causa.** El vestuario lee y aplica la ropa a través de `cuxial_appearance`. Guardar y borrar necesitan además el permiso del menú de jefe.

**Solución.** Arranca `cuxial_appearance`, o pon `clothingScript = 'tgiann_clothing'` en `data/clothing.lua` con `tgiann-clothing` en marcha.

</details>

<details>

<summary>El banco del arsenal o de la favela no existe</summary>

**Causa.** Los dos se apoyan en `nextgenfivem_crafting`. Sin él en marcha no hay bancos. Con él, el tipo de banco y las recetas se crean al arrancar, pero los bancos los coloca el staff en el editor de ese recurso.

**Solución.** Arranca `nextgenfivem_crafting` antes que Cuxial Gang y coloca un banco del tipo indicado en `benchType`.

</details>

<details>

<summary>El pase de temporada premium no se puede comprar</summary>

**Causa.** `seasonPass.customCurrency` es `true`, o la organización no tiene el precio en su saldo limpio.

**Solución.** Pon `seasonPass.customCurrency = false` y aporta saldo limpio. El precio se edita en el panel de staff.

</details>

<details>

<summary>/startraid no existe</summary>

**Causa.** Las redadas están desactivadas por defecto.

**Solución.** Pon `enable = true` en `data/raids.lua` y añade tus trabajos de policía a `allowedJobs`.

</details>

<details>

<summary>No se puede iniciar una redada</summary>

**Causa.** Uno de los límites de `data/raids.lua`: la hora está fuera de `raidTime`, el trabajo o la organización están en espera, no hay suficientes jugadores conectados, el grado es demasiado bajo, o `adminMode.enable` es `true` y el staff no la ha aprobado.

**Solución.** Revisa esas opciones. Con el modo admin activado, el staff aprueba con `/approveraid <jobname> <gangid>`.

</details>

<details>

<summary>Nunca cae ningún airdrop</summary>

**Causa.** `enabled` es `false` en `data/airdrop.lua`, la hora está fuera de `SpawnTimeWindow`, o no hay sitios utilizables.

**Solución.** Revisa los sitios en el panel de staff y lanza uno a mano con `/startAirDrop` para probar. La consola dice por qué ha fallado un lanzamiento.

</details>

<details>

<summary>Los horarios se ejecutan a una hora equivocada</summary>

**Causa.** `timeZone` no es la zona de tu servidor, o la API de hora no respondió y se está usando el reloj de la máquina. La consola lo indica al arrancar.

**Solución.** Pon en `timeZone` tu zona IANA. Para saltarte la API y usar siempre el reloj de la máquina, pon `timeApi = ''`.

</details>

<details>

<summary>Los registros no llegan a Discord</summary>

**Causa.** La convar está vacía o tiene un nombre distinto del de `logs.general` o `logs.admin`.

**Solución.** Añade las convars a `server.cfg` antes de que arranque el recurso. Se leen una sola vez, al arrancar:

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

```cfg
set cuxial_gang_webhook "https://discord.com/api/webhooks/..."
set cuxial_gang_webhook_admin "https://discord.com/api/webhooks/..."
```

{% endcode %}

Con la depuración activada, la consola dice si cada webhook está configurado.

</details>

<details>

<summary>Los alijos no se abren, o cachear a un jugador no hace nada</summary>

**Causa.** El inventario no es `ox_inventory`. Los alijos y el cacheo se apoyan en él.

**Solución.** Usa `ox_inventory`.

</details>

<details>

<summary>La tecla de interacción no hace nada</summary>

**Causa.** El jugador no está en una organización, no hay nadie al alcance, o `rope.enabled` es `false`. Un cambio en `rope.keybind.key` solo se aplica a quien entra por primera vez.

**Solución.** Revisa la organización y la distancia. Los jugadores cambian la tecla en los ajustes de GTA, en las asignaciones de teclas de FiveM.

</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/bandas/cuxial-gang/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.