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

# Problemas frecuentes

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

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

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

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

```cfg
ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure sleepless_interact
ensure cuxial_gas_assets
ensure cuxial_gasstations
```

{% endcode %}

</details>

<details>

<summary>La pistola de presión desaparece nada más cogerla</summary>

**Causa.** `ox_inventory` quita cualquier arma de las manos que no sea un item del inventario. La consola del cliente (F8) muestra un aviso sobre `WEAPON_PRESSURE1`.

**Solución.** Añádela a la lista de ignoradas y reinicia el servidor:

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

```cfg
setr inventory:ignoreweapons ["WEAPON_PRESSURE1"]
```

{% endcode %}

Si el convar ya existe, añade la entrada a su lista.

</details>

<details>

<summary>Las hidrolimpiadoras, la furgoneta de detailing o la pistola no se ven o no existen</summary>

**Causa.** `cuxial_gas_assets` no está en marcha, o arrancó después del script.

**Solución.** Comprueba que la carpeta está en `resources` y que `ensure cuxial_gas_assets` va antes que `ensure cuxial_gasstations`. Reinicia el servidor: los assets en streaming no se cargan solo con reiniciar un recurso.

</details>

<details>

<summary>/gasadmin dice que no tengo permiso</summary>

**Causa.** Tu cuenta no tiene ni el ACE ni el permiso del framework que hay en `admin`.

**Solución.** Da el ACE a tu grupo:

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

```cfg
add_ace group.admin cuxial_gasstations.admin allow
```

{% endcode %}

</details>

<details>

<summary>El panel o el panel de administración no se abre, o sale en blanco</summary>

**Causa.** Faltan archivos de la interfaz o están incompletos, normalmente por una subida parcial de `web/dist`.

**Solución.** Vuelve a copiar el recurso desde el paquete que descargaste y reinícialo.

</details>

<details>

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

**Causa.** El idioma sigue al convar `ox:locale`. Se incluyen inglés y español.

**Solución.** Pon `setr ox:locale "es"` en `server.cfg` y reinicia el servidor. Los textos están en `locales/en.json` y `locales/es.json`.

</details>

<details>

<summary>Se vende combustible pero el stock y la caja de la gasolinera no cambian</summary>

**Causa.** El script de combustible no comunica las ventas a la gasolinera, o el surtidor está fuera de la esfera `pumps` de la gasolinera.

**Solución.** Usa Cuxial Fuel, o llama a `SellFuel` desde tu script de combustible como se explica en [Exports y eventos](/scripts/es/vehiculos/cuxial-gasstations/developers.md#sellfuel). Si solo fallan algunos surtidores, amplía el radio (cuarto valor) de `pumps` de esa gasolinera en `data/stations.lua`.

</details>

<details>

<summary>Un contrato dice «No hay ningún destino a esa distancia»</summary>

**Causa.** No hay ningún destino activo dentro del `maxDistance` de ese tamaño de contrato, o las ubicaciones de fábrica nunca se cargaron. En el segundo caso la consola del servidor avisa de que `cuxial_gasstations_points` no tiene ubicaciones de fábrica.

**Solución.** Abre `/gasadmin` → **Puntos de carga** y comprueba que hay destinos y que están activos. Si la lista está vacía, asegúrate de que `install/seed_points.sql` está en la carpeta del recurso y reinícialo, o crea destinos con **Nueva ubicación aquí**.

</details>

<details>

<summary>El vehículo del viaje desaparece nada más aparecer</summary>

**Causa.** Una lista negra de modelos de tu servidor lo borra. La consola del cliente avisa de que el vehículo ha desaparecido nada más crearse.

**Solución.** Quita los modelos de la flota de la lista negra, o cambia el `model` de esas entradas en `fleet.catalog`. En QBox, revisa la lista de `qbx_entitiesblacklist`.

</details>

<details>

<summary>El conductor no puede arrancar el vehículo del viaje o la furgoneta</summary>

**Causa.** Las llaves se entregan a través de Cuxial Garages. Sin él, el script no da llaves.

**Solución.** Arranca `cuxial_garages`, o configura tu sistema de llaves para que los vehículos con los prefijos de matrícula `GS` y `GW` se puedan conducir.

</details>

<details>

<summary>La página Lavado dice que no se han colocado hidrolimpiadoras</summary>

**Causa.** Las ranuras de lavado las coloca un administrador. La mejora solo activa ranuras que ya existen.

**Solución.** Abre `/gasadmin` → **Hidrolimpiadoras**, colócate en la gasolinera y usa **Nueva ranura aquí**; después ajústala con el editor. Luego el dueño compra la mejora **Hidrolimpiadoras**.

</details>

<details>

<summary>Nunca llegan clientes NPC</summary>

**Causa.** No se cumple alguna de las condiciones:

* el módulo `npc` y `npc.enabled` están activos, y el dueño ha activado los clientes en la página Lavado;
* hay un empleado en turno a menos de `npc.presenceRadius` de la bahía;
* al menos una ranura de lavado activa tiene bahía, y la bahía está libre;
* la gasolinera tiene jabón y agua para un servicio activo;
* no se ha alcanzado ningún tope por hora, por día o del servidor.

**Solución.** Revisa cada punto. La página Lavado del panel del dueño muestra qué tope o condición lo está bloqueando. Los topes se suben en `/gasadmin` → **Mejoras** → **Límites globales**.

</details>

<details>

<summary>Un cambio en config.lua no tiene efecto en una gasolinera</summary>

**Causa.** Una regla puesta en el panel de administración manda sobre el config en esa gasolinera o en todas.

**Solución.** Abre `/gasadmin` → **Mejoras**, busca la regla y restablécela para que vuelva a heredar el valor del config.

</details>

<details>

<summary>Un dueño ha perdido su gasolinera</summary>

**Causa.** El stock total estuvo por debajo de `abandon.minStockPct` durante `abandon.hours` horas seguidas. El suceso queda anotado en `/gasadmin` → **Registro**.

**Solución.** Devuélvesela con **Otorgar a un jugador** en el detalle de la gasolinera si hace falta. Para suavizar o quitar la regla, cambia `abandon` en el config.

</details>

<details>

<summary>Los avisos no llegan al teléfono</summary>

**Causa.** La integración solo funciona con un teléfono compatible con `cuxial_bridge`, y el jugador debe tener teléfono. Si no, los avisos pasan a la notificación estándar.

**Solución.** No se pierde nada: los avisos también se guardan en la bandeja del panel. Comprueba que `notices.phone` está en `true` y que el recurso del teléfono está arrancado.

</details>

<details>

<summary>Los logs de Discord no llegan</summary>

**Causa.** El convar del webhook está vacío o tiene otro nombre. Se lee una vez, al arrancar el recurso.

**Solución.** Pon `set cuxial_gasstations_webhook "..."` en `server.cfg`, con el nombre de `logs.convar`, y reinicia el recurso.

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