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

# Problemas frecuentes

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

Los problemas más habituales tras instalar Cuxial Gang App, 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 la app. Cuxial Gang App necesita `ox_lib`, `oxmysql`, `qbx_core`, `lb-phone` y `cuxial_gang`.

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

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

```cfg
ensure ox_lib
ensure oxmysql
ensure qbx_core
ensure lb-phone
ensure cuxial_gang
ensure cuxial_gang_app
```

{% endcode %}

</details>

<details>

<summary>La app no está en el teléfono</summary>

**Causa.** Una de estas:

* `DefaultApp` es `false`, así que la app espera en la tienda de apps del teléfono.
* lb-phone ha rechazado la app. La consola del cliente (F8) muestra `AddCustomApp failed` con el motivo.

**Solución.** Instálala desde la tienda de apps del teléfono, o pon `DefaultApp = true` en `shared/config.lua`. Si la consola muestra el error, el motivo que da lb-phone aparece junto a él.

</details>

<details>

<summary>La app se abre en blanco</summary>

**Causa.** La interfaz no carga. La carpeta `ui/dist` falta o está incompleta, normalmente tras una subida parcial.

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

</details>

<details>

<summary>Un miembro de una banda no ve «Mi Banda»</summary>

**Causa.** La app no ha podido obtener el rol de Cuxial Gang y ha caído en la pantalla de un jugador sin organización. Cuxial Gang está parado, no ha arrancado bien, o el personaje es una mula activa, que tiene prioridad sobre la pertenencia a una organización.

**Solución.** Comprueba que `cuxial_gang` arranca sin errores y antes que `cuxial_gang_app`.

</details>

<details>

<summary>Las notificaciones de la banda o los mensajes del chat no llegan al teléfono</summary>

**Causa.** Se ha cambiado `Identifier` en `shared/config.lua`. Cuxial Gang los envía a la app `cuxial-gang`.

**Solución.** Vuelve a poner `Identifier = "cuxial-gang"` y reinicia el recurso.

</details>

<details>

<summary>La reserva se rechaza por falta de dinero</summary>

**Causa.** El precio completo se cobra por adelantado de `PaymentAccount`, que por defecto es `'cash'`. Con `DirtyPayout = true` la app cobra el ítem `black_money` a través de `ox_inventory`.

**Solución.** Pon en `PaymentAccount` la cuenta que quieras. Con `DirtyPayout = true`, comprueba que `ox_inventory` está en marcha y que el ítem `black_money` existe.

</details>

<details>

<summary>La acompañante no sube al vehículo</summary>

**Causa.** Tiene que cumplirse todo esto a la vez:

* El jugador es el conductor.
* El vehículo está más cerca que `MaxDistance` y va más despacio que `MaxVehicleSpeed`.
* El asiento del copiloto está libre.
* La clase del vehículo no está en `BlackListedVehicleClasses` y el modelo no está en `BlackListedVehicles`.
* La bocina se mantiene durante `HornHoldTime` milisegundos.

**Solución.** Para junto a ella con un coche que tenga libre el asiento del copiloto y mantén la bocina. Un aviso en pantalla indica cuándo el vehículo no sirve o el asiento está ocupado.

</details>

<details>

<summary>La acompañante se marcha antes de que empiecen los servicios</summary>

**Causa.** Tras la recogida el jugador tiene `FindAreaTimeout` (dos minutos por defecto) para parar al menos a `MinSecludedDistance` metros, en un lugar donde ningún otro ped a menos de 75 metros vea el vehículo. También se marcha si el jugador se baja del vehículo.

**Solución.** Conduce a un sitio vacío y para. Para hacerlo más fácil, sube `FindAreaTimeout` o baja `MinSecludedDistance` en `data/kokka.lua`.

</details>

<details>

<summary>La acompañante no aparece en el punto de encuentro</summary>

**Causa.** La `zone` del perfil no tiene entrada en `MeetPoints`, o `pedModel` no es un modelo válido.

**Solución.** Revisa ese perfil en `data/kokka.lua`. Cada `zone` tiene que coincidir exactamente con una clave de `MeetPoints`.

</details>

<details>

<summary>Un perfil añadido a data/kokka.lua no aparece en la app</summary>

**Causa.** La lista de perfiles que ve el jugador forma parte de la interfaz. `Escorts` solo define el modelo, la zona, el nivel y los servicios de los perfiles que ya existen.

**Solución.** Edita las entradas existentes en lugar de añadir claves nuevas.

</details>

<details>

<summary>/kokkaduo responde que no hay permiso, o no pasa nada</summary>

**Causa.** El comando está restringido a `group.admin`. Si se ejecuta pero no se reproduce ninguna animación, uno de los dos jugadores no está en su asiento: el cliente conduce y el escort va en el asiento del copiloto del mismo vehículo.

**Solución.** Añade al staff a `group.admin` en `server.cfg` y sienta a los dos jugadores antes de ejecutar el comando.

</details>

<details>

<summary>Compartir una ubicación con un contacto no hace nada</summary>

**Causa.** La app envía el punto marcado en el GPS del jugador, y no hay ninguno.

**Solución.** Marca antes un punto en el mapa.

</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-app/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.