HZ Scripts

Installation

Schritt 1 — Download

Nach Ihrem Kauf auf Tebex laden Sie das Skript von Ihrem FiveM Keymaster herunter:

  1. Melden Sie sich auf keymaster.fivem.net an
  2. Gehen Sie zu Granted Assets
  3. Laden Sie hz_carcontrol herunter
Wichtig: Verwenden Sie dasselbe FiveM-Konto, das mit Ihrer Tebex-Lizenz verknuepft ist. Das Skript ist durch Escrow geschuetzt und erfordert eine gueltige Lizenz.

Schritt 2 — Abhaengigkeiten

Erforderlich

  1. hz_lib (kostenlos)
* Download aus dem Hz-Scripts Shop — kostenloses Asset * Siehe hz_lib Installation fuer die Einrichtung * Muss vor HZ-CarControl in der server.cfg starten

Optional

  • oxmysql: Nur erforderlich, wenn Sie die Persistenz der Neonfarben aktivieren (Config.Neons.SaveColor = true)
  • qbx\_vehiclekeys / qb-vehiclekeys: Fuer die Integration der Tuerverriegelung (automatische Erkennung, oder nativen Modus als Fallback verwenden)
hz_lib uebernimmt automatisch die gesamte Framework- und Benachrichtigungserkennung. Sie muessen es nur einmal konfigurieren.

Schritt 3 — Dateien

  1. Entpacken Sie das Archiv hz_carcontrol.zip
  2. Platzieren Sie den Ordner hz_carcontrol in Ihrem resources/-Verzeichnis
server/
├── resources/
│   ├── [hz]/
│   │   ├── hz_lib/
│   │   ├── hz_carcontrol/
│   │   │   ├── client/
│   │   │   ├── server/
│   │   │   ├── bridge/
│   │   │   ├── html/
│   │   │   ├── locales/
│   │   │   ├── shared/
│   │   │   ├── config.lua
│   │   │   └── fxmanifest.lua

Schritt 4 — Datenbank (optional)

Dieser Schritt ist optional. Die Datenbank wird nur benoetigt, wenn Sie Neonfarben nach Fahrzeugkennzeichen speichern moechten.

Wenn Sie Config.Neons.SaveColor = true aktivieren, wird die Tabelle hz_neon_colors beim ersten Start automatisch erstellt (erfordert oxmysql).

Oder importieren Sie manuell:

CREATE TABLE IF NOT EXISTS `hz_neon_colors` (
  `plate` VARCHAR(12) NOT NULL PRIMARY KEY,
  `r` TINYINT UNSIGNED NOT NULL DEFAULT 0,
  `g` TINYINT UNSIGNED NOT NULL DEFAULT 0,
  `b` TINYINT UNSIGNED NOT NULL DEFAULT 0
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

Schritt 5 — server.cfg

Fuegen Sie die Ressourcen in Ihre server.cfg in dieser Reihenfolge ein:

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

# Optionale Abhaengigkeit
ensure oxmysql

# hz_lib (erforderlich — kostenloses Asset, vor allen Hz-Scripts)
ensure hz_lib

# Hz-Scripts
ensure hz_carcontrol

Die Startreihenfolge ist wichtig! Ihr Framework und hz_lib muessen vor HZ-CarControl starten.

Schritt 6 — Konfiguration

Oeffnen Sie config.lua und passen Sie die Einstellungen an Ihren Server an. Siehe die Seite Konfiguration fuer Details zu jeder Option.

Wichtige Einstellungen zum Ueberpruefen:
  • Config.Locale: Sprache (14 Sprachen verfuegbar)
  • Config.Menu.Keybind: Taste zum Oeffnen des Menues (Standard: H)
  • Config.Features: Funktionen einzeln aktivieren/deaktivieren

Schritt 7 — Ueberpruefung

  1. Starten Sie Ihren Server
  2. Verbinden Sie sich im Spiel
  3. Steigen Sie in ein Fahrzeug
  4. Druecken Sie H (Standard) oder geben Sie /carmenu ein
  5. Das Kontrollpanel sollte erscheinen
  6. Pruefen Sie die Serverkonsole: HZ-CarControl v3.0.0 — HZ Script
Fertig! Wenn sich das Menue oeffnet und Sie die Funktionen aktivieren koennen, funktioniert das Skript. Gehen Sie zur Konfiguration fuer die individuelle Anpassung.

Schnelle Fehlerbehebung

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:

  • es_extended oder qb-core wird korrekt mit ensure vor hz_lib geladen
  • hz_lib wird mit ensure vor hz_carcontrol geladen
  • Pruefen Sie die hz_lib-Konsolenzeile zur Bestaetigung der korrekten Erkennung
Das Menue oeffnet sich nicht
  • Stellen Sie sicher, dass Sie in einem Fahrzeug sitzen
  • Pruefen Sie, ob Config.Menu.Keybind nicht mit einem anderen Skript kollidiert
  • Pruefen Sie die F8-Konsole auf Fehler
  • Versuchen Sie den Chat-Befehl: /carmenu
  • Falls Config.Permissions.Enabled = true, ueberpruefen Sie, ob Sie die erforderliche ACE-Berechtigung haben
Neonfarben werden nicht gespeichert
  • Aktivieren Sie Config.Neons.SaveColor = true in config.lua
  • Stellen Sie sicher, dass oxmysql installiert und gestartet ist
  • Pruefen Sie die Serverkonsole auf Datenbankfehler
  • Die Tabelle hz_neon_colors wird automatisch erstellt — ansonsten importieren Sie das SQL manuell