Installation
Abhängigkeiten
| Abhängigkeit | Erforderlich | Warum |
|---|---|---|
| ox_lib | Ja | 3.22.0 oder neuer. Menüs, Text-UI und Sprachdateien |
| hz_lib | Nein, empfohlen | Kostenlos. Erkennt Framework, Inventar und Benachrichtigungen für Sie und bringt das Dialogfenster, die Ziele auf dem Bildschirm und das Dispositions-Tablet mit |
| HZ-TextUi | Nein | 3D-Hinweise an den Zapfsäulen. Ohne HZ-TextUi zeigt die Text-UI von ox_lib die Hinweise |
| Framework (ESX / QBCore / Qbox / ox_core) | Nein | Wird selbst erkannt. Standalone funktioniert auch, siehe Zahlung |
| Ein Inventar | Nein | Nur für Kanister. Siehe Kanister |
| Datenbank | Nein | Keine. Tankstellenvorräte und Kanisterfüllstände speichert der Server, ohne SQL |
Schritte
- Legen Sie den Ordner
hz_fuelin Ihrresources-Verzeichnis. - Entfernen Sie das Tank-Script, das Sie bisher genutzt haben (LegacyFuel, ox_fuel, qb-fuel, cdn-fuel, ps-fuel…). Ihre anderen Scripts laufen weiter: HZ-Fuel antwortet an seiner Stelle.
- Tragen Sie HZ-Fuel in Ihre
server.cfgein, nach ox_lib, Ihrem Framework, Ihrem Inventar und hz_lib:
ensure ox_lib
# your framework and inventory here
ensure hz_lib
ensure hz_textui # optional
ensure hz_fuel
- Legen Sie Ihre Preise in
config.luafest (fuelTypes) und starten Sie dann den Server neu.
Was Sie sehen sollten
- Beim Start gibt die Serverkonsole das Framework, das Inventar und den Zahlungsmodus aus, die HZ-Fuel gefunden hat.
- Tankstellen-Blips auf der Karte.
- Parken Sie an einer modernen Zapfsäule und steigen Sie aus: Der Hinweis Zapfpistole nehmen erscheint, und das Display der Zapfsäule zeigt die Preise.
- An den Landtankstellen (Sandy Shores, Grapeseed, Harmony, Route 68, Paleto Boulevard…) wartet der Tankwart bei den Zapfsäulen.
- Die Ladesäulen zeigen ihren Begrüßungsbildschirm.
Aktualisieren
Starten Sie nach einem Update den ganzen Server neu, nicht nur restart hz_fuel. Wird HZ-Fuel allein neu gestartet, sehen bereits verbundene Spieler die Namen, die es ersetzt (LegacyFuel, ox_fuel…), bis zum nächsten Reconnect als nicht gestartet. Das ist eine Grenze von FiveM, und Scripts, die diese Namen prüfen, etwa Tempomaten oder manche HUDs, verlieren in der Zwischenzeit den Tankstand.
config.lua, data/ und locales/ gehören Ihnen: Sichern Sie eine Kopie, bevor Sie den Ordner ersetzen.
Der Lieferjob
Nur Mitglieder des Jobs fueldelivery können eine Lieferschicht übernehmen. HZ-Fuel fügt den Job Ihrem Framework hinzu, wenn er fehlt:
| Framework | Was passiert |
|---|---|
| QBCore / Qbox | Bei jedem Start im Speicher hinzugefügt. In Ihre Dateien wird nichts geschrieben, und ein Job fueldelivery in Ihrer shared/jobs.lua hat Vorrang |
ESX (mit ESX.CreateJob) | Einmalig in die Tabellen jobs und job_grades geschrieben |
| Älteres ESX | Führen Sie das SQL unten einmal aus |
| ox_core | Legen Sie die Gruppe selbst an |
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, '{}', '{}');
Spieler bekommen den Job wie jeden anderen: über die Jobliste Ihres Rathauses (fügen Sie fueldelivery hinzu: qbx_cityhall config/shared.lua > employment.jobs, qb-cityhall Config.AvailableJobs), ein Boss-Menü oder /setjob. Damit alle arbeiten können, setzen Sie delivery.jobs = false. Der komplette Job steht unter Treibstoff-Lieferjob.
Maps, die die Zapfsäulen ersetzen
HZ-Fuel arbeitet mit den Zapfsäulenmodellen des Spiels. Einige kostenpflichtige Maps tauschen sie gegen ein eigenes Modell aus: Diese Tankstelle hat dann kein Display, keine Zapfpistole und keinen Hinweis. Der Ordner [compatibility], der mit der Resource geliefert wird, erklärt, wie Sie einer solchen Map die Zapfsäulen des Spiels zurückgeben.
| Map | Status |
|---|---|
| Gabz ESB LTD (Grove Street LTD, Davis) | Ersetzt die 6 Zapfsäulen: Folgen Sie [compatibility]/[gabz-esbltd]/readme.txt (6 Zeilen in einer Map-Datei ändern) |
| Gabz Harmony, Gabz Fire Department | Kompatibel, nichts zu tun |
prop_gas_pump_1a / 1b / 1c / 1d, prop_gas_pump_old2 / old3 oder prop_vintage_pump. Das Modell der Map in pumpModels einzutragen reicht nicht: Schlauch, Display und Kartenschlitz sind auf jedes Modell abgestimmt. Fragen Sie uns auf Discord, und wir nehmen die Map in den Ordner auf.