Installation

Dépendances

DépendanceObligatoirePourquoi
ox_libOui3.22.0 ou plus récent. Menus, texte d'interface et fichiers de langue
hz_libNon, recommandéGratuit. Trouve votre framework, votre inventaire et vos notifications, et apporte la boîte de dialogue, les objectifs à l'écran et la tablette du répartiteur
HZ-TextUiNonInvites 3D aux pompes. Sans lui, le texte d'interface d'ox_lib affiche les invites
Framework (ESX / QBCore / Qbox / ox_core)NonDétecté tout seul. Le standalone marche aussi, voir Paiement
Un inventaireNonSeulement pour les jerricans. Voir Jerrican
Base de donnéesNonAucune. Les stocks des stations et le niveau des jerricans sont gardés par le serveur, sans SQL

Étapes

  1. Déposez le dossier hz_fuel dans votre dossier resources.
  2. Retirez le script d'essence que vous utilisiez (LegacyFuel, ox_fuel, qb-fuel, cdn-fuel, ps-fuel…). Vos autres scripts continuent de marcher : HZ-Fuel répond à sa place.
  3. Ajoutez HZ-Fuel à votre server.cfg, après ox_lib, votre framework, votre inventaire et hz_lib :
ensure ox_lib
# your framework and inventory here
ensure hz_lib
ensure hz_textui   # optional
ensure hz_fuel
  1. Réglez vos prix dans config.lua (fuelTypes), puis redémarrez le serveur.
Un seul script d'essence à la fois. Deux systèmes de carburant vident et remplissent les mêmes véhicules. Si un autre script d'essence tourne encore, la console du serveur le signale en rouge au démarrage.

Ce que vous devez voir

  • Au démarrage, la console du serveur affiche le framework, l'inventaire et le mode de paiement trouvés.
  • Les blips des stations sur la carte.
  • Garez-vous à une pompe moderne et descendez : l'invite Prendre la buse apparaît, et l'écran de la pompe affiche les prix.
  • Aux stations de campagne (Sandy Shores, Grapeseed, Harmony, Route 68, Paleto Boulevard…), le pompiste attend près des pompes.
  • Les bornes électriques affichent leur écran d'accueil.

Mise à jour

Après une mise à jour, redémarrez tout le serveur, pas restart hz_fuel seul. Quand HZ-Fuel redémarre seul, les joueurs déjà connectés voient les noms qu'il remplace (LegacyFuel, ox_fuel…) comme arrêtés jusqu'à leur reconnexion. C'est une limite de FiveM, et les scripts qui vérifient ces noms, comme le régulateur de vitesse ou certains HUD, perdent le niveau de carburant en attendant.

config.lua, data/ et locales/ sont à vous : gardez-en une copie avant de remplacer le dossier.


Le job de livraison

Seuls les membres du métier fueldelivery peuvent prendre un service de livraison. HZ-Fuel ajoute le métier à votre framework quand il manque :

FrameworkCe qui se passe
QBCore / QboxAjouté en mémoire à chaque démarrage. Rien n'est écrit dans vos fichiers, et un métier fueldelivery dans votre shared/jobs.lua a la priorité
ESX (avec ESX.CreateJob)Écrit une fois dans les tables jobs et job_grades
ESX plus ancienLancez une fois le SQL ci-dessous
ox_coreCréez le groupe vous-même
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, '{}', '{}');

Les joueurs obtiennent le métier comme n'importe quel autre : ajoutez fueldelivery à la liste des métiers de votre mairie (qbx_cityhall config/shared.lua > employment.jobs, qb-cityhall Config.AvailableJobs), à un menu patron, ou utilisez /setjob. Pour laisser tout le monde travailler, mettez delivery.jobs = false. Tout le job est dans Job de livraison.


Cartes qui remplacent les pompes

HZ-Fuel fonctionne sur les modèles de pompes du jeu. Quelques cartes payantes les remplacent par leur propre modèle : cette station n'a alors ni écran, ni pistolet, ni invite. Le dossier [compatibility] livré avec la resource explique comment rendre à ces cartes les pompes du jeu.

CarteÉtat
Gabz ESB LTD (LTD de Grove Street, Davis)Remplace les 6 pompes : suivez [compatibility]/[gabz-esbltd]/readme.txt (6 lignes à changer dans un fichier de la carte)
Gabz Harmony, Gabz Fire DepartmentCompatibles, rien à faire
Une autre carte ? Ouvrez ses fichiers de carte près de la station dans CodeWalker, regardez le modèle de chaque pompe et remettez celui du jeu : prop_gas_pump_1a / 1b / 1c / 1d, prop_gas_pump_old2 / old3 ou prop_vintage_pump. Ajouter le modèle de la carte à pumpModels ne suffit pas : le tuyau, l'écran et la fente à carte sont ajustés à chaque modèle. Demandez-nous sur Discord et nous ajoutons la carte au dossier.