HZ Scripts

Installation

Schritt 1 — Download

Nach Ihrem Kauf auf hzscripts.com/shop erhaelt 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 verknuepft ist. Das Skript ist durch Escrow geschuetzt und erfordert eine gueltige Lizenz.

Schritt 2 — Abhaengigkeiten

Keine. HZ-AudioMixer ist eine rein eigenstaendige Ressource.
  • Kein Framework erforderlich — funktioniert mit QBCore, QBox, ESX, Standalone, vMenu, vanilla
  • Kein SQL — Einstellungen werden clientseitig ueber FiveM KVP gespeichert
  • Kein hz_lib erforderlich
  • Keine zusaetzlichen Ressourcen

Schritt 3 — Installation

  1. Entpacken Sie das heruntergeladene Archiv
  2. Platzieren Sie den Ordner hz_audiomixer in Ihrem Verzeichnis resources/[standalone]/
  3. Fuegen Sie die Zeile in Ihre server.cfg ein:
ensure hz_audiomixer
  1. Starten Sie Ihren Server neu

Schritt 4 — Ueberpruefung

Spieler sollten nach dem Spawn diese Zeile in ihrer F8-Konsole sehen:

[hz_audiomixer] Scene active

Druecken Sie dann F7 im Spiel — die Mixer-Oberflaeche sollte sich mit 9 Reglern oeffnen.

Ordnerstruktur

hz_audiomixer/
├── fxmanifest.lua
├── client.lua             ← verschluesselt durch Asset Escrow
├── config/
│   └── config.lua         ← anpassbar
├── shared/
│   └── locale.lua         ← anpassbar
├── 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 hinzufuegen
├── audioconfig/
│   ├── _nt_core_mx.dat15.rel       ← kompilierte Audiodaten
│   └── _nt_core_gm.dat151.rel
└── html/
    └── index.html         ← anpassbar, frei gestaltbar

Anpassbare Dateien (escrow_ignore) — config/, shared/, locales/, html/ bleiben lesbar, damit Sie sie anpassen koennen. Nur client.lua (die Audio-Engine-Logik) ist verschluesselt.

Fehlerbehebung

WARN: Scene non active in der F8-Konsole

Die Audio-Szene wurde nicht aktiviert. Das bedeutet in der Regel, dass die Dateien dat15.rel / dat151.rel nicht korrekt geladen wurden. Pruefen 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 (vollstaendiger Neustart, nicht nur restart hz-audiomixer bei der Erstinstallation)

Spieler haben nach dem Spawn keinen Ton

Falls beim ersten Spawn alle Toene stummgeschaltet sind:

  1. Starten Sie die Ressource einmal neu, um ggf. den KVP zu loeschen (die aggressive 15-Sekunden-Schleife beim Spawn wendet die Werte erneut an)
  2. Ueberpruefen Sie, ob ein Spieler F7 drueckt, um sicherzustellen, dass nicht alle Regler auf 0% stehen

F7 oeffnet den Mixer nicht

  • Oeffnen Sie das FiveM-Tastenbelegungsmenue (Pause-Menue > Einstellungen > Tastenbelegung > FiveM)
  • Suchen Sie nach "Mixer Audio" — weisen Sie die Taste neu zu, falls F7 mit einer anderen Ressource kollidiert

Naechster Schritt

  • Konfiguration — Sprache, Standard-Lautstaerke, Kategorien deaktivieren
  • Exports & Events — Mixer in Ihr benutzerdefiniertes Pause-Menue integrieren