Installation
Dépendances
| Dépendance | Obligatoire | Pourquoi |
|---|---|---|
| ox_lib | Oui | 3.22.0 ou plus récent. Menus, texte d'interface et fichiers de langue |
| hz_lib | Non, 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-TextUi | Non | Invites 3D aux pompes. Sans lui, le texte d'interface d'ox_lib affiche les invites |
| Framework (ESX / QBCore / Qbox / ox_core) | Non | Détecté tout seul. Le standalone marche aussi, voir Paiement |
| Un inventaire | Non | Seulement pour les jerricans. Voir Jerrican |
| Base de données | Non | Aucune. Les stocks des stations et le niveau des jerricans sont gardés par le serveur, sans SQL |
Étapes
- Déposez le dossier
hz_fueldans votre dossierresources. - 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.
- 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
- Réglez vos prix dans
config.lua(fuelTypes), puis redémarrez le serveur.
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 :
| Framework | Ce qui se passe |
|---|---|
| QBCore / Qbox | Ajouté 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 ancien | Lancez une fois le SQL ci-dessous |
| ox_core | Cré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 Department | Compatibles, rien à faire |
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.