hz_lib

Vorstellung

hz_lib ist die gemeinsame Grundlage aller Hz-Scripts-Ressourcen. Es erkennt automatisch die Serverumgebung und stellt eine einheitliche API bereit, damit jedes Hz-Script sofort funktioniert — unabhaengig von Ihrem Framework oder Ihrer Addon-Kombination.

Kostenloses Asset — hz_lib ist kostenlos im Hz-Scripts Shop erhaeltlich. Einmal herunterladen und alle kompatiblen Skripte verwenden es automatisch.

Wozu dient es?

Anstatt dass jedes Skript seinen eigenen Framework-Erkennungs- und Adaptercode mitbringt, uebernimmt hz_lib dies zentral:

Modul	Was es erkennt
Framework	ESX, QBCore, QBox, Ox Core, vRP, Standalone
Inventar	ox\_inventory, qs-inventory, ps-inventory, codem, core, origen, tgiann, Framework
Benachrichtigungen	ox\_lib, okokNotify, mythic\_notify, codem, pNotify, Framework, natives GTA
Target	ox\_target, qb-target, interact, integriertes TextUI
Menue / UI	ox\_lib (vollstaendig), qb-menu + qb-input, ESX-Menue, natives GTA-Fallback
Dispatch	cd\_dispatch, ps-dispatch, qs-dispatch, rcore\_dispatch, emergencydispatch, integriert
Callbacks	Bidirektional (Client-Server) mit Rate-Limiting und Timeout
Minispiele	Fortschrittsbalken, Skill-Check, Sequenz

Ausserdem beinhaltet es ein zentrales Administrationspanel (/hzpanel) — jedes HZ-Script-Modul deklariert sein Konfigurationsschema, und das Panel erstellt automatisch einen typisierten In-Game-Editor, um alles zu aendern, ohne Dateien zu bearbeiten oder neu zu starten. Siehe Administrationspanel.

Hauptvorteile

Einmalige Installation — Alle Hz-Scripts teilen dieselbe Bridge, kein duplizierter Code
Automatische Erkennung — Lassen Sie alles auf 'auto' und hz_lib erkennt Ihre Konfiguration
Override bei Bedarf — Erzwingen Sie ein bestimmtes System in einer einzigen Konfigurationsdatei
60+ exports — Nutzen Sie die Bridge auch aus Ihren eigenen Skripten
Zentrales Admin-Interface — /hzpanel oeffnet ein einziges Panel fuer jedes HZ-Script-Modul (mehr erfahren)
Einheitliches Theme — Aendern Sie Akzentfarbe, Oberflaechen, Eckenradien an einer Stelle, jede HZ-NUI passt sich live an
Kein Performance-Einfluss — Die Erkennung laeuft einmal beim Start, die exports sind sofort verfuegbar

Unterstuetzte Systeme

Frameworks

Framework	Ressource	Status
ESX	`es_extended`	Vollstaendig
QBCore	`qb-core`	Vollstaendig
QBox	`qbx_core`	Vollstaendig
Ox Core	`ox_core`	Vollstaendig
vRP	`vRP`	Vollstaendig
Standalone	—	Vollstaendig

Inventare

Inventar	Ressource	Status
ox\_inventory	`ox_inventory`	Vollstaendig
qs-inventory	`qs-inventory`	Vollstaendig
ps-inventory	`ps-inventory`	Vollstaendig
codem-inventory	`codem-inventory`	Vollstaendig
core\_inventory	`core_inventory`	Vollstaendig
origen\_inventory	`origen_inventory`	Vollstaendig
tgiann-inventory	`tgiann-inventory`	Vollstaendig
Natives Framework	—	Grundlegend

Menuesysteme

Menuesystem	Ressource	Funktionen
ox\_lib	`ox_lib`	Context, Input, Alert, TextUI, Fortschritt, Listenmenue
qb-menu	`qb-menu`	Context, Input (ueber qb-input), TextUI (ueber qb-core)
ESX-Menue	`esx_menu_default`	Context, Listenmenue, TextUI (ueber esx\_textui)
Nativ	—	GTA-Tastatureingabe, Hilfetext, einfaches Fallback

Schnellstart

Laden Sie hz_lib aus dem Shop herunter (kostenlos)
Platzieren Sie es in Ihrem resources/-Verzeichnis
Fuegen Sie ensure hz_lib in Ihre server.cfg ein — vor jedem Hz-Script
Fertig — alle Hz-Scripts erkennen es automatisch

Siehe die Installationsanleitung fuer alle Details.

Fuer Entwickler

hz_lib stellt 60+ exports bereit, die Sie aus Ihren eigenen Skripten verwenden koennen:

-- Framework
local job = exports['hz_lib']:GetPlayerJob()

-- Benachrichtigungen
exports['hz_lib']:Notify('Hello!', 'success', 3000)

-- Inventory (server)
exports['hz_lib']:AddItem(source, 'bread', 5)

-- Menu (client)
exports['hz_lib']:ContextMenu('my_menu', 'My Menu', {
    { title = 'Option 1', onSelect = function() print('selected') end },
})

-- Callbacks
exports['hz_lib']:RegisterCallback('myResource:getData', function(source)
    return { money = 1000 }
end)

Siehe die vollstaendige Referenz Exports & API.