HZ Scripts

Installation

Schritt 1 — Download

Nach Ihrem Kauf auf hzscripts.com/shop erhält Ihr FiveM Keymaster-Konto das Asset.

  1. Melden Sie sich auf keymaster.fivem.net an (oder portal.cfx.re/assets)
  2. Gehen Sie zu Granted Assets
  3. Laden Sie HZ-AudioMixer herunter
Wichtig: Verwenden Sie dasselbe FiveM-Konto, das mit Ihrer Tebex-Lizenz verknüpft ist. Das Skript ist durch Escrow geschützt und erfordert eine gültige Lizenz.

Schritt 2 — Abhängigkeiten

hz_lib (kostenlos) ist die einzige Abhängigkeit. Es zeichnet das Mixer-Panel (HZ-UI-Kit) und liefert die Farben und Schriften Ihres Themes. Siehe hz_lib.
  • Kein Framework erforderlich — funktioniert mit QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Kein SQL — Einstellungen werden clientseitig über FiveM KVP gespeichert
  • Keine weitere Ressource

Schritt 3 — Installation

  1. Entpacken Sie das heruntergeladene Archiv
  2. Platzieren Sie den Ordner hz_audiomixer in Ihrem Verzeichnis resources/, neben hz_lib
  3. Fügen Sie beide Zeilen in Ihre server.cfg ein, hz_lib zuerst:
ensure hz_lib
ensure hz_audiomixer
  1. Starten Sie Ihren Server neu

Schritt 4 — Überprüfung

Drücken Sie im Spiel F7 (oder geben Sie /audiomixer ein): Das Mixer-Panel öffnet sich rechts auf dem Bildschirm, mit 9 Reglern in 4 Gruppen.

Um die Audio-Szene zu prüfen, setzen Sie Config.Debug = true. Nach dem Spawn zeigt die F8-Konsole dann:

[HZ-AudioMixer] Scene active

Ordnerstruktur

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← verschlüsselt durch Asset Escrow
├── config/
│   └── config.lua         ← anpassbar
├── shared/
│   └── locale.lua         ← verschlüsselt durch Asset Escrow
├── locales/
│   ├── en.lua  fr.lua  de.lua  es.lua  it.lua  pt.lua  nl.lua
│   ├── pl.lua  ru.lua  tr.lua  ja.lua  ko.lua  zh.lua  ar.lua
│   └── ...                ← anpassbar, eigene hinzufügen
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← kompilierte Audiodaten
│   └── _nt_core_gm.dat151.rel
└── html/
    ├── index.html         ← anpassbar
    ├── style.css          ← anpassbar
    └── app.js             ← anpassbar

Anpassbare Dateien (escrow_ignore) — config/, locales/ und html/ bleiben lesbar, damit Sie sie anpassen können. client.lua (die Audio-Engine-Logik) und shared/locale.lua sind verschlüsselt.

Fehlerbehebung

Die Audio-Szene startet nicht

Mit Config.Debug = true erscheint die Zeile [HZ-AudioMixer] Scene active nie in F8, und das Bewegen eines Reglers ändert nichts. Das bedeutet in der Regel, dass die Dateien dat15.rel / dat151.rel nicht korrekt geladen wurden. Prüfen Sie:

  1. Der Ordner audioconfig/ ist in der Ressource vorhanden
  2. data_file 'AUDIO_DYNAMIXDATA' und data_file 'AUDIO_GAMEDATA' stehen in der fxmanifest.lua
  3. Die Ressource startet nach dem Laden der Audiodateien — starten Sie den Server komplett neu (vollständiger Neustart, nicht nur restart hz_audiomixer bei der Erstinstallation)

Ein Sound fehlt

Die Lautstärken werden pro Spieler gespeichert, daher bleibt ein auf 0% gestellter Kanal in jeder Sitzung stumm:

  1. Drücken Sie F7 und prüfen Sie, ob der Regler auf 0% steht (ein Wert von 0% wird hervorgehoben)
  2. Prüfen Sie beim Radio auch Musik: Das Radio liegt in der Kategorie Musik, daher schaltet Musik auf 0% auch das Radio stumm
  3. Drücken Sie zweimal R, um alle Kanäle auf Config.DefaultVolume zurückzusetzen

F7 öffnet den Mixer nicht

  • Öffnen Sie das FiveM-Tastenbelegungsmenü (Pause-Menü > Einstellungen > Tastenbelegung > FiveM)
  • Suchen Sie nach "HZ Audio Mixer öffnen" ("Open HZ Audio Mixer" auf Englisch, die Bezeichnung folgt Config.Locale). Weisen Sie die Taste neu zu, falls F7 mit einer anderen Ressource kollidiert

Nächster Schritt

  • Konfiguration — Sprache, Standard-Lautstärke, Kategorien deaktivieren
  • Exports & Events — Mixer in Ihr benutzerdefiniertes Pause-Menü integrieren