Konfiguration

Alles liegt in config.lua. Spielerseitige Einstellungen (Grafik, Fadenkreuz) werden von jedem Spieler im Spiel gewaehlt und clientseitig gespeichert — die Schluessel unten sind nur die Standardwerte beim ersten Start und die Optionen auf Admin-Ebene.

config.lua ist ein shared script — es laedt sowohl in der Server- als auch in der Client-Lua-VM. Schluessel, die das Client-Verhalten steuern, werden auf dem Client angewendet; mit hz_lib werden Admin-Overrides live an den Client geschoben.

14 Keys stehen auch im /hzpanel. Config.Locale, Config.LowPerformanceMode, Config.Brand, Config.ServerName, Config.DiscordURL, Config.ShopURL, Config.Accent und die Config.Hud-Keys außer Custom lassen sich auch im hz_lib-Panel unter Pause Menu einstellen. config.lua gilt, solange im Panel kein Wert gespeichert ist. Ein im Panel gespeicherter Wert hat Vorrang vor config.lua und greift live, und seine Zurücksetzen-Schaltfläche führt den Key zu config.lua zurück (mit hz_lib 1.2.1 oder neuer). Vor HZ-PauseMenu 1.2.1 hatten die Standardwerte des Panels für diese Keys Vorrang vor config.lua, auch wenn nichts gespeichert war. Aktualisieren Sie deshalb hz_pausemenu und hz_lib auf 1.2.1. Mit hz_lib muss Config.Locale en, fr oder es sein, die drei Sprachen, die das Panel anbietet: Jeder andere Wert fällt auf en zurück.

Allgemein

Schluessel	Standard	Beschreibung
`Config.Locale`	`'en'`	UI-Sprache. `en`, `fr`, `es` liegen bei; legen Sie weitere in `locales/` ab. Mit hz_lib verwenden Sie `en`, `fr` oder `es`.
`Config.Debug`	`false`	Gibt Fehler beim Laden der Sprachdateien in der Konsole aus.
`Config.Framework`	`'auto'`	`auto` erkennt es_extended → qbx_core → qb-core → ox_core → vRP → standalone. Erzwinge einen Namen nur, wenn zwei Cores nebeneinander laufen.
`Config.LowPerformanceMode`	`false`	Deaktiviert UI-Uebergaenge/Blur fuer sehr schwache Clients.
`Config.ClientWait`	`300000`	ms, die ein Client einen Server-Info-Abruf wiederverwendet. Die Spielerzahl wird immer frisch gelesen.

Profil

Schluessel	Standard	Beschreibung
`Config.Mugshot.Enabled`	`true`	Zeigt das Gesicht des Spielers (GPU-pedheadshot → base64) statt eines Initials. Eigenstaendig, gecacht, nur bei Ped-Wechsel neu erzeugt.
`Config.Mugshot.Transparent`	`true`	`true` = freigestelltes Gesicht ueber dem Kreisgradienten; `false` = Studio-Hintergrund auf den Kreis zugeschnitten.
`Config.Mugshot.PollSeconds`	`4`	Wie oft auf eine Outfit-/Modell-Aenderung geprueft wird.
`Config.DefaultNationality`	`'USA'`	Angezeigt, wenn das Framework keine mitfuehrt (Basis-ESX). Setze `""`, um `--` zu behalten.
`Config.LogoutCommand`	`'logout'`	Befehl, den die Charakterkarte ausfuehrt, wenn der Server Multichar hat. Lass `""`, wenn kein Multichar → die Karte oeffnet stattdessen den PROFILE-Tab (kein toter Button).
`Config.CharacterImage`	`'images/character.webp'`	Bild auf der Charakterkarte des GAME-Tabs (unter `web/public/`). `""` faellt auf das VICE-Wortzeichen zurueck.

Branding & Shop

Schluessel	Standard	Beschreibung
`Config.Brand`	`"No\\|Trace"`	Logo-Text oben in der Mitte. Der Teil vor `\\|` nimmt die Theme-Farbe an. `""` blendet ihn aus.
`Config.ServerName`	`""`	Text neben dem Discord-Icon. Leer = lokalisiertes "Join the Discord".
`Config.DiscordURL`	`"https://discord.me/hzscript"`	Discord-Einladung, die der Button öffnet. Ersetzen Sie sie durch Ihre.
`Config.ShopURL`	`""`	Der SHOP-Tab oeffnet diese URL im Browser des Spielers (muss `http(s)://` sein). Leer = der SHOP-Tab ist ausgeblendet.

Akzent & Theme

Schluessel	Standard	Beschreibung
`Config.Accent`	`"#FF6EC7"`	Ersatz-Tönung des nativen GTA-V-Einstellungsmenüs, nur solange kein hz_lib-Theme empfangen wurde. Das Menü selbst nimmt seine Farben aus dem hz_lib-Theme, die native Tönung ebenfalls, sobald das Theme geladen ist.
`Config.NativeMenuAccent`	(Tabelle)	Faerbt das native GTA-V-Einstellungsmenue auf deinen Akzent. Siehe Theme.

Spielereinstellungen (Standardwerte)

Schluessel	Standard	Beschreibung
`Config.Graphics.Enabled`	`true`	`false` blendet das gesamte FPS-Panel aus.
`Config.Graphics.Timecycles`	`{}`	Timecycle-Namen, die im Dropdown angeboten werden. Absichtlich leer — GTA hat einen Timecycle-Slot und Wetter-Scripts besitzen ihn. Fuelle nur auf einem Server, auf dem nichts anderes ihn steuert.
`Config.CrosshairEnabled`	`true`	`false` blendet das gesamte Fadenkreuz-Panel aus.
`Config.KeybindsEnabled`	`true`	`false` blendet das Tastenbelegungs-Unterpanel aus.
`Config.KeybindLayout`	`'qwerty'`	`qwerty` oder `azerty` — die physischen Buchstabenreihen auf dem Board.
`Config.Keybinds`	(Liste)	Standalone-Tastenbelegungsliste, `"KEY\\|LABEL\\|icon\\|DESC"`. Wenn HZ-Loading laeuft, werden stattdessen dessen geteilte Tastenbelegungen genutzt.

Siehe Player settings, wie diese im Spiel dargestellt werden.

HUD-Integration

Config.Hud blendet dein HUD aus, waehrend das Menue (oder die native Karte/Einstellungen) offen ist, und stellt es dann wieder her. Es funktioniert mit jeder HUD-Resource. Vollstaendige Referenz: HUD integration.