FAQ

Allgemein

Ist das Skript mit meinem Framework kompatibel?

HZ-CarControl unterstuetzt QBCore, QBX, ESX und den Standalone-Modus. Das Skript erkennt Ihr Framework automatisch ueber das hz_lib-System.

Beeintraechtigt das Skript die Leistung?

Nein. HZ-CarControl verbraucht 0,00 ms im Ruhezustand clientseitig. Das NUI ist nur aktiv, wenn das Menue geoeffnet ist, und verwendet nur GPU-basierte CSS-Animationen (kein Blur, keine aufwaendigen Filter), um 60 FPS beizubehalten.

Koennen Spieler die Tasten neu zuweisen?

Ja. Alle Tastenkuerzel verwenden das FiveM-System RegisterKeyMapping, sodass Spieler sie unter Einstellungen -> Tastenbelegung -> FiveM im Spiel neu zuweisen koennen.

Wie viele Sprachen werden unterstuetzt?

14 Sprachen sind enthalten: Englisch, Franzoesisch, Spanisch, Deutsch, Portugiesisch, Italienisch, Niederlaendisch, Polnisch, Tuerkisch, Russisch, Chinesisch, Japanisch, Koreanisch und Arabisch. Setzen Sie Config.Locale auf den gewuenschten Sprachcode.

Wie aktualisiere ich das Skript?
  1. Laden Sie die neueste Version von Keymaster herunter
  2. Erstellen Sie eine Sicherungskopie Ihrer config.lua
  3. Ersetzen Sie alle Dateien ausser config.lua
  4. Pruefen Sie den Changelog auf neue Konfigurationsparameter
  5. Starten Sie den Server neu

Installation

Das Skript startet nicht

Pruefen Sie:

  • Der Ordner heisst korrekt hz_carcontrol (Gross-/Kleinschreibung beachten)
  • hz_lib ist installiert und startet vor HZ-CarControl
  • Ihre FiveM-Lizenz ist auf Keymaster gueltig
  • Die server.cfg enthaelt ensure hz_carcontrol
Fehler "Framework not detected"

Die Framework-Erkennung wird von hz_lib uebernommen:

  • Stellen Sie sicher, dass es_extended oder qb-core mit ensure vor hz_lib geladen wird
  • hz_lib muss mit ensure vor hz_carcontrol geladen werden
  • Pruefen Sie die hz_lib-Konsolenzeile auf den Erkennungsstatus
Das Menue oeffnet sich ueberhaupt nicht
  1. Sie muessen in einem Fahrzeug sitzen — das Menue oeffnet sich nicht zu Fuss
  2. Versuchen Sie den Befehl /carmenu statt des Tastenkuerzels
  3. Pruefen Sie, ob ein anderes Skript die Taste H belegt
  4. Falls Config.Permissions.Enabled = true, stellen Sie sicher, dass Sie die korrekte ACE-Berechtigung haben
  5. Pruefen Sie die F8-Konsole auf Fehler

Funktionen

Der Tempomat laesst sich nicht aktivieren Haeufige Ursachen:
  1. Ihre Geschwindigkeit liegt unter Config.CruiseControl.MinSpeed (Standard: 20 km/h)
  2. Config.Features.CruiseControl ist auf false gesetzt
  3. Config.CruiseControl.Enabled ist auf false gesetzt
Loesung: Beschleunigen Sie ueber 20 km/h und versuchen Sie es erneut.
Die Tuerverriegelung funktioniert nicht Falls Sie eine Vehicle-Keys-Ressource verwenden:
  • Pruefen Sie, ob qbx_vehiclekeys oder qb-vehiclekeys installiert und gestartet ist
  • Der Spieler muss die Schluessel fuer das Fahrzeug besitzen
  • Setzen Sie Config.DoorLock.KeysResource auf 'native', um die Schluesselpruefung zu umgehen
Falls Sie den nativen Modus verwenden:
  • Config.DoorLock.KeysResource = 'native' nutzt die native GTA-Verriegelung
  • Sie muessen der Fahrer sein, um zu verriegeln/entriegeln
Neonfarben werden zwischen Sitzungen nicht gespeichert
  1. Aktivieren Sie Config.Neons.SaveColor = true
  2. Installieren Sie oxmysql und stellen Sie sicher, dass es vor HZ-CarControl startet
  3. Die Tabelle hz_neon_colors wird automatisch erstellt — pruefen Sie die Serverkonsole auf SQL-Fehler
  4. Farben werden nach Fahrzeugkennzeichen gespeichert — benutzerdefinierte Kennzeichen funktionieren am besten
Der Motor bleibt an, wenn ich das Fahrzeug verlasse

Das ist das normale GTA-Verhalten, wenn der Motorstatus per Skript erzwungen wird. HZ-CarControl beinhaltet eine automatische Motor-Abschaltungserkennung beim Verlassen des Fahrzeugs. Falls das Problem bestehen bleibt:

  1. Pruefen Sie, ob ein anderes Skript den Motor erzwungen anlaesst
  2. Stellen Sie sicher, dass Sie die neueste Version von HZ-CarControl verwenden
Das Radiorad erscheint immer noch, wenn ich Q druecke

Aktivieren Sie Config.Radio.DisableWheel = true, um das native GTA V-Radiorad zu deaktivieren. Dies zwingt Spieler, stattdessen das Radio-Panel von CarControl zu verwenden.

Die Verdeck-Option wird nicht angezeigt

Der Verdeck-Button erscheint nur, wenn das Fahrzeug tatsaechlich ein oeffenbares Verdeck hat. Nicht-Cabrio-Fahrzeuge zeigen diese Option nicht an.


Konfiguration

Wie deaktiviere ich eine bestimmte Funktion?

Setzen Sie die Funktion in Config.Features auf false:

Config.Features = {
    Neons = false,        -- Neon-Steuerung deaktivieren
    CruiseControl = false, -- Tempomat deaktivieren
    -- ... weitere Funktionen
}

Die deaktivierte Funktion wird im Menue ausgeblendet.

Wie aendere ich die Position des Menues?

Aendern Sie Config.Menu.Align:

Config.Menu = {
    Align = 'bottom-center',  -- Standard
    -- Optionen: 'top-left', 'top-center', 'top-right',
    --           'bottom-left', 'bottom-center', 'bottom-right'
}

Wie fuege ich benutzerdefinierte Neonfarben-Presets hinzu?

Fuegen Sie Eintraege in Config.Neons.Presets hinzu:

Config.Neons = {
    Presets = {
        { r = 255, g = 0,   b = 0,   label = 'Red' },
        { r = 0,   g = 255, b = 0,   label = 'Green' },
        -- Eigene hinzufuegen:
        { r = 255, g = 105, b = 180, label = 'Hot Pink' },
        { r = 0,   g = 191, b = 255, label = 'Deep Sky Blue' },
    },
}

Wie beschraenke ich das Menue nur auf Admins?

Aktivieren Sie das Berechtigungssystem:

Config.Permissions = {
    Enabled = true,
    AcePermission = 'hz.carcontrol',
}

Fuegen Sie dann die ACE in Ihre server.cfg ein:

add_ace group.admin hz.carcontrol allow

Wie fuege ich benutzerdefinierte Geschwindigkeitsbegrenzer-Presets hinzu?

Aendern Sie Config.SpeedLimiter.Presets:

Config.SpeedLimiter = {
    Presets = { 30, 50, 80, 110, 130 },
    -- Aendern mit eigenen Werten:
    -- Presets = { 20, 40, 60, 90, 120 },
}

Der Begrenzer schaltet durch jedes Preset und deaktiviert sich dann.


Keine Antwort gefunden? Treten Sie unserem Discord bei und oeffnen Sie ein Ticket in #support!