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.
Allgemein
| Schluessel | Standard | Beschreibung |
|---|
Config.Locale | 'en' | UI-Sprache. en, fr, es liegen bei; lege weitere in locales/ ab. |
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 | false | 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.ServerName | "" | Text neben dem Discord-Icon. Leer = lokalisiertes "Join the Discord". |
Config.DiscordURL | "…" | Discord-Einladung, die der Button oeffnet. |
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" | Ein Akzent, als CSS-Variable eingespeist. Wird live von der hz_lib-Theme-Kaskade ueberschrieben, wenn vorhanden. |
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.
