Installation

Schritt 1 — Download

hz_lib ist ein kostenloses Asset. Laden Sie es aus dem Hz-Scripts Shop oder ueber Ihren FiveM Keymaster herunter:

Melden Sie sich auf keymaster.fivem.net an
Gehen Sie zu Granted Assets
Laden Sie hz_lib herunter

hz_lib wird von allen Hz-Scripts-Ressourcen benoetigt. Falls Sie es bereits installiert haben, muessen Sie es nur aktualisieren, wenn eine neue Version veroeffentlicht wird.

Schritt 2 — Dateien

Entpacken Sie das Archiv
Platzieren Sie den Ordner hz_lib in Ihrem resources/-Verzeichnis

server/
├── resources/
│   ├── [standalone]/
│   │   ├── hz_lib/
│   │   │   ├── bridge/
│   │   │   ├── modules/
│   │   │   │   ├── callback/
│   │   │   │   ├── dispatch/
│   │   │   │   ├── framework/
│   │   │   │   ├── inventory/
│   │   │   │   ├── menu/
│   │   │   │   ├── minigame/
│   │   │   │   ├── notify/
│   │   │   │   └── target/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Der Ordnername muss hz_lib lauten (Gross-/Kleinschreibung auf Linux-Servern beachten).

Schritt 3 — server.cfg

Fuegen Sie hz_lib zu Ihrer server.cfg hinzu — vor jedem Hz-Script, das davon abhaengt:

# Framework (falls zutreffend)
ensure es_extended
# ensure qb-core

# hz_lib (vor allen Hz-Scripts)
ensure hz_lib

# Ihre Hz-Scripts
ensure hz_television
ensure hz_weather
# ensure hz-phone

Die Startreihenfolge ist entscheidend! hz_lib muss nach Ihrem Framework, aber vor jedem Hz-Script starten, das es verwendet.

Schritt 4 — Konfiguration (optional)

Oeffnen Sie config.lua, um die Erkennung anzupassen. Standardmaessig ist alles auf 'auto' eingestellt und funktioniert sofort.

Siehe die Seite Konfiguration fuer alle Optionen.

Schritt 5 — Ueberpruefung

Starten Sie Ihren Server und pruefen Sie die Konsole auf:

[HZ Bridge] v1.0.0 | Framework: qbcore | Inventory: ox_inventory | Notify: ox_lib | Dispatch: builtin | Target: ox_target | Menu: ox_lib

Fertig! Wenn Sie die Erkennungszeile mit Ihren korrekt identifizierten Systemen sehen, funktioniert hz_lib. Alle Hz-Scripts verwenden es ab sofort automatisch.

Aktualisierung

Laden Sie die neueste Version von Keymaster herunter
Ersetzen Sie alle Dateien (es gibt keine Benutzerkonfiguration zum Beibehalten — config.lua ist minimal)
Neustart: ensure hz_lib, dann starten Sie Ihre Hz-Scripts neu

Aktualisierungen von hz_lib sind abwaertskompatibel. Ihre bestehenden Hz-Scripts funktionieren nach einem Update weiterhin.

Fehlerbehebung

hz_lib erkennt mein Framework nicht

Stellen Sie sicher, dass Ihr Framework (es_extended, qb-core, qbx_core) vor hz_lib mit ensure geladen wird
Ueberpruefen Sie, ob der Ressourcenname exakt stimmt (Gross-/Kleinschreibung beachten)
Falls Sie ein Framework erzwingen moechten, setzen Sie HZBridge.Framework = 'esx' (oder 'qbcore' usw.) in config.lua

Ein Skript meldet "hz_lib not found"

Ueberpruefen Sie, ob hz_lib in Ihrer server.cfg mit ensure hz_lib eingetragen ist
Stellen Sie sicher, dass der Ordner exakt hz_lib heisst
hz_lib muss vor dem Skript starten, das es benoetigt

Falsches System erkannt

Falls die automatische Erkennung das falsche System waehlt (z. B. das falsche Inventar), koennen Sie es in config.lua erzwingen:

HZBridge.Inventory = 'ox_inventory'  -- Force specific inventory