Installation

Abhängigkeiten

AbhängigkeitErforderlichWarum
ox_libJa3.22.0 oder neuer. Menüs, Text-UI und Sprachdateien
hz_libNein, empfohlenKostenlos. Erkennt Framework, Inventar und Benachrichtigungen für Sie und bringt das Dialogfenster, die Ziele auf dem Bildschirm und das Dispositions-Tablet mit
HZ-TextUiNein3D-Hinweise an den Zapfsäulen. Ohne HZ-TextUi zeigt die Text-UI von ox_lib die Hinweise
Framework (ESX / QBCore / Qbox / ox_core)NeinWird selbst erkannt. Standalone funktioniert auch, siehe Zahlung
Ein InventarNeinNur für Kanister. Siehe Kanister
DatenbankNeinKeine. Tankstellenvorräte und Kanisterfüllstände speichert der Server, ohne SQL

Schritte

  1. Legen Sie den Ordner hz_fuel in Ihr resources-Verzeichnis.
  2. 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.
  3. Tragen Sie HZ-Fuel in Ihre server.cfg ein, 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
  1. Legen Sie Ihre Preise in config.lua fest (fuelTypes) und starten Sie dann den Server neu.
Nur ein Tank-Script gleichzeitig. Zwei Tanksysteme leeren und befüllen dieselben Fahrzeuge. Läuft noch ein anderes Tank-Script, meldet die Serverkonsole das beim Start in Rot.

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:

FrameworkWas passiert
QBCore / QboxBei 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 ESXFühren Sie das SQL unten einmal aus
ox_coreLegen 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.

MapStatus
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 DepartmentKompatibel, nichts zu tun
Eine andere Map? Öffnen Sie ihre Map-Dateien rund um die Tankstelle in CodeWalker, sehen Sie sich das Modell jeder Zapfsäule an und setzen Sie wieder das Modell des Spiels ein: 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.