Instalación
Dependencias
| Dependencia | Obligatoria | Por qué |
|---|---|---|
| ox_lib | Sí | 3.22.0 o más reciente. Menús, text UI y archivos de idioma |
| hz_lib | No, recomendada | Gratis. 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-TextUi | No | Prompts 3D en los surtidores. Sin él, los prompts se muestran con el text UI de ox_lib |
| Framework (ESX / QBCore / Qbox / ox_core) | No | Se detecta solo. También funciona en standalone, consulta Pago |
| Un inventario | No | Solo para los bidones de gasolina. Consulta Bidón de gasolina |
| Base de datos | No | Ninguna. El servidor guarda el stock de las gasolineras y el nivel de los bidones, sin SQL |
Pasos
- Coloca la carpeta
hz_fuelen tu directorioresources. - 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.
- 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
- Fija tus precios en
config.lua(fuelTypes) y reinicia el servidor.
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:
| Framework | Qué pasa |
|---|---|
| QBCore / Qbox | Se 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 antiguo | Ejecuta una vez el SQL de abajo |
| ox_core | Crea 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.
| Mapa | Estado |
|---|---|
| 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 Department | Compatible, no hay nada que hacer |
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.