Installation

Dependencies

Steps

1. Drop the hz_fuel folder into your resources directory.
2. Remove the fuel script you were using (LegacyFuel, ox_fuel, qb-fuel, cdn-fuel, ps-fuel…). Your other scripts keep working: HZ-Fuel answers in its place.
3. Add HZ-Fuel to your server.cfg, after ox_lib, your framework, your inventory and hz_lib:

ensure ox_lib
# your framework and inventory here
ensure hz_lib
ensure hz_textui   # optional
ensure hz_fuel

1. Set your prices in config.lua (fuelTypes), then restart the server.

What you should see

• At startup, the server console prints the framework, the inventory and the payment mode HZ-Fuel found.
• Station blips on the map.
• Park at a modern pump and get out: the Take the nozzle prompt appears, and the pump's screen shows the prices.
• At the country stations (Sandy Shores, Grapeseed, Harmony, Route 68, Paleto Boulevard…), the attendant waits by the pumps.
• The electric chargers show their welcome screen.

Updating

After an update, restart the whole server, not restart hz_fuel alone. When HZ-Fuel is restarted on its own, players already connected see the names it replaces (LegacyFuel, ox_fuel…) as not running until they reconnect. That is a FiveM limit, and scripts that check for those names, like cruise control or some HUDs, lose the fuel level in the meantime.

config.lua, data/ and locales/ are yours: keep a copy before you replace the folder.

The delivery job

Only members of the fueldelivery job can take a delivery shift. HZ-Fuel adds the job to your framework when it is missing:

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, '{}', '{}');

Players get the job like any other: add fueldelivery to your city hall's job list (qbx_cityhall config/shared.lua > employment.jobs, qb-cityhall Config.AvailableJobs), a boss menu, or /setjob. To let everyone work, set delivery.jobs = false. The whole job is in Fuel delivery job.

Maps that replace the pumps

HZ-Fuel works on the game's pump models. A few paid maps swap them for their own model: that station then has no screen, no nozzle and no prompt. The [compatibility] folder shipped with the resource explains how to give such a map the game's pumps back.