Instalación

Dependencias

DependenciaObligatoriaPor qué
ox_libSí3.22.0 o más reciente. Menús, text UI y archivos de idioma
hz_libNo, recomendadaGratis. Detecta por ti tu framework, tu inventario y tus notificaciones, y trae el cuadro de diálogo, los objetivos en pantalla y la tablet de despacho
HZ-TextUiNoPrompts 3D en los surtidores. Sin él, los prompts se muestran con el text UI de ox_lib
Framework (ESX / QBCore / Qbox / ox_core)NoSe detecta solo. También funciona en standalone, consulta Pago
Un inventarioNoSolo para los bidones de gasolina. Consulta Bidón de gasolina
Base de datosNoNinguna. El servidor guarda el stock de las gasolineras y el nivel de los bidones, sin SQL

Pasos

  1. Coloca la carpeta hz_fuel en tu directorio resources.
  2. Quita el script de gasolina que usabas (LegacyFuel, ox_fuel, qb-fuel, cdn-fuel, ps-fuel…). Tus demás scripts siguen funcionando: HZ-Fuel responde en su lugar.
  3. Añade HZ-Fuel a tu server.cfg, después de ox_lib, tu framework, tu inventario y hz_lib:
ensure ox_lib
# your framework and inventory here
ensure hz_lib
ensure hz_textui   # optional
ensure hz_fuel
  1. Fija tus precios en config.lua (fuelTypes) y reinicia el servidor.
Un solo script de gasolina a la vez. Dos sistemas de combustible vacían y llenan los mismos vehículos. Si otro script de gasolina sigue en marcha, la consola del servidor lo avisa en rojo al arrancar.

Lo que deberías ver

  • Al arrancar, la consola del servidor muestra el framework, el inventario y el modo de pago que ha encontrado HZ-Fuel.
  • Los blips de las gasolineras en el mapa.
  • Aparca junto a un surtidor moderno y bájate: aparece el prompt Coger la manguera, y la pantalla del surtidor muestra los precios.
  • En las gasolineras rurales (Sandy Shores, Grapeseed, Harmony, Route 68, Paleto Boulevard…), el gasolinero espera junto a los surtidores.
  • Los cargadores eléctricos muestran su pantalla de bienvenida.

Actualizar

Tras una actualización, reinicia el servidor entero, no solo restart hz_fuel. Cuando HZ-Fuel se reinicia por separado, los jugadores ya conectados ven los nombres que reemplaza (LegacyFuel, ox_fuel…) como detenidos hasta que se reconectan. Es un límite de FiveM, y los scripts que comprueban esos nombres, como el control de crucero o algunos HUD, pierden el nivel de combustible mientras tanto.

config.lua, data/ y locales/ son tuyos: guarda una copia antes de reemplazar la carpeta.


El trabajo de reparto

Solo los miembros del trabajo fueldelivery pueden coger un turno de reparto. HZ-Fuel añade el trabajo a tu framework cuando falta:

FrameworkQué pasa
QBCore / QboxSe añade en memoria en cada arranque. No se escribe nada en tus archivos, y un trabajo fueldelivery en tu shared/jobs.lua tiene prioridad
ESX (con ESX.CreateJob)Se escribe una vez en las tablas jobs y job_grades
ESX antiguoEjecuta una vez el SQL de abajo
ox_coreCrea el grupo tú mismo
INSERT INTO jobs (name, label) VALUES ('fueldelivery', 'Fuel Delivery');
INSERT INTO job_grades (job_name, grade, name, label, salary, skin_male, skin_female) VALUES
  ('fueldelivery', 0, 'trainee', 'Trainee', 20, '{}', '{}'),
  ('fueldelivery', 1, 'driver', 'Driver', 35, '{}', '{}'),
  ('fueldelivery', 2, 'senior', 'Senior Driver', 50, '{}', '{}'),
  ('fueldelivery', 3, 'supervisor', 'Supervisor', 65, '{}', '{}');

Los jugadores obtienen el trabajo como cualquier otro: añade fueldelivery a la lista de trabajos de tu ayuntamiento (qbx_cityhall config/shared.lua > employment.jobs, qb-cityhall Config.AvailableJobs), un menú de jefe, o /setjob. Para que todo el mundo pueda trabajar, pon delivery.jobs = false. Todo el trabajo se explica en Trabajo de reparto de combustible.


Mapas que reemplazan los surtidores

HZ-Fuel funciona con los modelos de surtidor del juego. Algunos mapas de pago los cambian por su propio modelo: esa gasolinera se queda sin pantalla, sin pistola y sin prompt. La carpeta [compatibility] incluida con el recurso explica cómo devolverle a ese mapa los surtidores del juego.

MapaEstado
Gabz ESB LTD (Grove Street LTD, Davis)Reemplaza los 6 surtidores: sigue [compatibility]/[gabz-esbltd]/readme.txt (6 líneas que cambiar en un archivo del mapa)
Gabz Harmony, Gabz Fire DepartmentCompatible, no hay nada que hacer
¿Otro mapa? Abre sus archivos de mapa cerca de la gasolinera en CodeWalker, mira el modelo de cada surtidor y vuelve a poner el modelo del juego: prop_gas_pump_1a / 1b / 1c / 1d, prop_gas_pump_old2 / old3 o prop_vintage_pump. Añadir el modelo del mapa a pumpModels no basta: la manguera, la pantalla y la ranura de la tarjeta están ajustadas a cada modelo. Pregúntanos en Discord y añadimos el mapa a la carpeta.