Lo que falla con más frecuencia, qué significa realmente y qué hacer al respecto. Para cualquier cosa que no aparezca aquí, establece Config.Debug = true, reinicia el recurso y lee las consolas del servidor y F8: cada carga, sincronización y rechazo queda registrado.
Instalación y acceso#
La consola se cierra diciendo que qs-fuelstations cambió de nombre
Se cambió el nombre de la carpeta del recurso. Debe llamarse exactamente qs-fuelstations: devuélvele su nombre y actualiza la línea ensure.
No hay estaciones, o la consola dice "Could not read `fuel_stations`"
No se importó el SQL, o se importó en una base de datos distinta de la de tu mysql_connection_string. Importa sql/database.sql en la correcta y reinicia. Un aviso "No stations in `fuel_stations`" significa que la tabla existe pero está vacía: importa la semilla o coloca estaciones con /fuelcreator.
"You are not allowed to use the fuel creator"
El jugador no tiene ninguno de los permisos de Config.Creator.aces y no es administrador del framework. Añade add_ace identifier.license:… fuelstations.creator allow a server.cfg y reinicia el servidor para que se lea la línea. En vRPex, ACE es la única vía.
La pantalla del surtidor o el creador nunca aparece
La interfaz viene lista para usar en web/build. Si esa carpeta falta o está incompleta (a menudo tras una subida por FTP que omitió archivos), descarga el recurso de nuevo desde el CFX Portal y reemplaza la carpeta. Abre F8 y busca un error que mencione un archivo que falta.
Cambié precios o consumo en config.lua y no pasó nada
Es el comportamiento correcto. Config.FuelPrices, Config.Economy, Config.ElectricModels y Config.VehicleFuelTypes solo rellenan una tabla fuel_settings vacía. Cámbialos en /fuelcreator → Economy.
Avisos "Locale xx is missing key …"
A la traducción elegida le falta una línea que sí tiene el inglés. Mientras tanto, el script usa la línea en inglés, así que nada se rompe. Añade la clave a tu archivo de idioma para silenciarlo.
Surtidores y repostaje#
No pasa nada en un surtidor
Un surtidor solo funciona cuando pertenece a una estación. Comprueba, en este orden:
El surtidor está dentro del radio de una estación. Abre el creador, selecciona la estación más cercana y aumenta su radio, o crea una estación ahí.
Esa estación vende el tipo adecuado: un surtidor de combustible necesita una estación que venda gasolina o diésel; un cargador, una que venda electricidad.
El modelo del prop está en
Config.PumpModels. Los surtidores de mapas personalizados deben añadirse ahí.Con
Config.UseTarget = trueno hay aviso[E]: usa el ojo del target.
Los cargadores son invisibles, o "Pump model electric_charger … could not be loaded"
Los modelos de los cargadores no están en streaming. Añade ensure fuelstations-props a server.cfg antes de qs-fuelstations, y asegúrate de que la carpeta se subió con sus archivos stream/.
"Your vehicle does not take this grade"
El vehículo está registrado para otro tipo de combustible. Todo modelo que no aparece usa gasolina, así que un vehículo eléctrico addon o un camión diésel debe añadirse en /fuelcreator → Economy → Vehicles por su spawn name, con el tipo correcto.
La estación está vacía
Su stock llegó al 0%. Un repartidor la rellena, o un administrador puede volver a poner Fuel in stock en 100 en el creador. Si las estaciones se vacían demasiado rápido, aumenta Config.DivideStationLevel; para desactivar el stock por completo, establece Config.EveryStationHasFuelLevel = false.
La pistola se acopla en el lugar equivocado de un vehículo
Ese modelo no tiene el hueso petroltank, así que el tapón del depósito se calculó a partir de las ruedas traseras. Añade el modelo a Config.CustomOffsets con un punto izquierdo y uno derecho, relativos al centro del vehículo:
Config.CustomOffsets = {
['mycar'] = { vec3(-0.9, -1.6, 0.4), vec3(0.9, -1.6, 0.4) },
}"The hose broke"
El jugador se alejó más de Config.CableMaxLength (7 m) del surtidor. Aparca más cerca o aumenta el valor. Con Config.AddExplosion = true, romper la manguera también provoca una explosión en el surtidor.
Al jugador se le cobró menos que el total
La cuenta que eligió no podía cubrir la factura, así que se cobró lo que había en ella. Deja solo bank activado en Config.FuelPaymentMethods si quieres estaciones que solo acepten tarjeta.
Consumo y precios#
El combustible se agota demasiado rápido o demasiado lento
Abre Economy → Consumption Model y empieza con un preset: Casual, Balanced o Hardcore. Las lecturas muestran cuánto dura un depósito estacionado, a velocidad de crucero y a fondo. Para una sola clase o modelo, usa Vehicle Classes o Vehicles. Desactivar el modelo devuelve el consumo a GTA.
El combustible sube y baja, o se reinicia
Otro script también está estableciendo el depósito: normalmente un segundo script de combustible o un garaje que restaura un valor antiguo. Elimina los demás recursos de combustible y haz que los garajes guarden y restauren el combustible mediante GetFuel / SetFuel (consulta Integraciones).
Los precios nunca cambian
Config.PriceMode es 'static', o la volatilidad del tipo de combustible en Config.Market.types es 0. El mercado se mueve cada tickMinutes (30) con pequeños pasos; ejecuta fuelmarket tick en la consola para verlo moverse ahora.
El trabajo de reparto#
No hay capataz ni blip de Fuel Delivery
Config.EnableJob es false. Si es true, busca en la consola "Job ped … could not be loaded": Config.PedType debe ser un modelo de ped válido.
"Every station is full right now"
Config.JobRespectStock es true y todas las estaciones están al 100%. Espera a que los jugadores compren combustible, o establécelo en false para ofrecer trabajo siempre.
El camión o la cisterna no aparece
La consola dice "Job vehicle … is not a vehicle model on this server": Config.TruckToSpawn o Config.TrailerToSpawn indica un modelo que no está en streaming. Asegúrate también de que los puntos de aparición estén libres de otros vehículos.
El conductor no puede arrancar el camión del trabajo
No se detectó tu sistema de llaves, así que no se entregaron llaves. Asegúrate de que se inicie antes de qs-fuelstations, o establece Config.Vehiclekeys a mano.
Una entrega no se contó
El servidor solo acepta una entrega realizada a menos de 75 m del punto de entrega de la estación, y no dos veces en poco tiempo. Si el punto de entrega de una estación está lejos de donde aparece el marcador, vuelve a establecerlo en el creador en Placement → Delivery point.
No se devolvió la fianza
Es el comportamiento correcto. La fianza es el precio del contrato; el salario se paga por cada estación entregada. Reduce Config.TruckPrice y Config.TankPrice si te parece demasiado elevada.
¿Sigues atascado? Abre un ticket e incluye tu framework, el orden de carga de tu
server.cfgy la salida de las consolas del servidor y F8 conConfig.Debug = true.