Los problemas más habituales después de instalar Cuxial Gas Stations, con la causa y la solución de cada uno.

El recurso no arranca

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:

server.cfg

ensure ox_lib
ensure oxmysql
ensure cuxial_bridge
ensure sleepless_interact
ensure cuxial_gas_assets
ensure cuxial_gasstations

La pistola de presión desaparece nada más cogerla

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:

server.cfg

setr inventory:ignoreweapons ["WEAPON_PRESSURE1"]

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

Las hidrolimpiadoras, la furgoneta de detailing o la pistola no se ven o no existen

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.

/gasadmin dice que no tengo permiso

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:

server.cfg

add_ace group.admin cuxial_gasstations.admin allow

El panel o el panel de administración no se abre, o sale en blanco

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.

Los textos salen en otro idioma

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.

Se vende combustible pero el stock y la caja de la gasolinera no cambian

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. Si solo fallan algunos surtidores, amplía el radio (cuarto valor) de pumps de esa gasolinera en data/stations.lua.

Un contrato dice «No hay ningún destino a esa distancia»

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í.

El vehículo del viaje desaparece nada más aparecer

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.

El conductor no puede arrancar el vehículo del viaje o la furgoneta

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.

La página Lavado dice que no se han colocado hidrolimpiadoras

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.

Nunca llegan clientes NPC

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.

Un cambio en config.lua no tiene efecto en una gasolinera

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.

Un dueño ha perdido su gasolinera

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.

Los avisos no llegan al teléfono

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.

Los logs de Discord no llegan

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.