HZ-AudioMixer

Vorstellung

HZ-AudioMixer ist der erste Audio-Mixer pro Spieler für FiveM, der die individuellen RAGE-Audiokategorien in Echtzeit steuert — Waffen, Fahrzeuge, Wetter, Dialoge, Musik und mehr — jede auf ihrem eigenen Regler. Keine Client-Modifikation, kein benutzerdefinierter Launcher, keine C++-Komponente. Eine rein serverseitig installierbare Ressource.

Bisher bot FiveM genau zwei Möglichkeiten zur Audiosteuerung:

Einen einzigen globalen SFX/Musik-Regler (profile_sfxVolume)
Boolesche ON/OFF-Flags (SetAudioFlag)

Das war alles. Fahrzeuge um 30% senken und Waffen bei 100% behalten? Unmöglich. Wetter stummschalten ohne die Dialoge zu verlieren? Unmöglich. HZ-AudioMixer durchbricht diese Grenze.

Hauptfunktionen

9 unabhängige Lautstärkeregler — Waffen, Fahrzeuge, Ambiente, Wetter, Dialog, Fußgänger, Skript, Musik, Radio. Jeweils von 0 bis 100% mit einer Genauigkeit von 1% (101 Stufen).
Audio-Anpassung in Echtzeit — Änderungen werden sofort angewendet, kein Neustart erforderlich.
Persistenz pro Spieler über FiveM KVP — Einstellungen werden clientseitig gespeichert, bleiben über Sitzungen und Server-Neustarts hinweg erhalten. Kein SQL.
Seitenpanel auf dem UI-Kit von hz_lib — derselbe Look wie die anderen HZ-Oberflächen, mit den Farben und Schriften Ihres hz_lib-Themes (/hzpanel). Maus oder Tastatur: ↑ ↓ wählen einen Kanal, ← → regeln ihn, R setzt zurück (mit Bestätigung), ESC schließt.
14 integrierte Sprachen — Englisch, Französisch, Deutsch, Spanisch, Italienisch, Portugiesisch, Niederländisch, Polnisch, Russisch, Türkisch, Japanisch, Koreanisch, Chinesisch, Arabisch.
Anpassbare Taste — Standard F7, von jedem Spieler im Pause-Menü frei änderbar.
Chat-Befehl — /audiomixer.
Öffentliche API (11 exports + 1 Event) — Integrieren Sie eigene Regler in jedes benutzerdefinierte Pause-Menü / NUI.
Kein Framework, kein SQL — die einzige Abhängigkeit ist hz_lib (kostenlos), das das Panel zeichnet und das Theme liefert.
Asset Escrow-Schutz — Leak-sicher und änderungsgeschützt. Die Audio-Engine-Logik bleibt verschlüsselt; config/, locales/ und html/ sind offen.
0,00 ms im Ruhezustand — kein Server-Skript. Bei geschlossener Oberfläche wendet der Client die Lautstärken nur alle 500 ms erneut an.

Das Wetterproblem (warum es wichtig ist)

Regen und Donner in GTA V sind bekannt schlecht ausbalanciert. Sobald ein Gewitter aufzieht:

Spieler können sich im Voice-Chat nicht mehr hören
Sirenen, Schüsse, Dialoge — alles geht unter
RP-Szenen werden ruiniert, weil niemand kommunizieren kann
Spieler senken die gesamte Spiellautstärke nur um dem Regen zu entgehen — und verpassen dann Schritte, Anrufe, Benachrichtigungen, alles

HZ-AudioMixer ermöglicht es jedem Spieler, den Wetter-Kanal auf 30% zu senken — der visuelle Regen bleibt erhalten, der ohrenbetäubende Lärm verschwindet — und Teamkollegen sind sofort wieder hörbar.

Multi-Framework

System	Unterstützte Optionen
Framework	QBCore, QBox, ESX, Standalone, vMenu, vanilla
Abhängigkeiten	hz_lib (kostenlos)
Persistenz	FiveM Client KVP (kein SQL erforderlich)
Audio-Ressourcen	Wirkt nur auf die nativen GTA V-Sounds. xSound, interact-sound und andere NUI-Sound-Skripte funktionieren weiter, ihre Sounds liegen aber auf keinem Kanal
Voice-Chat	Unverändert. pma-voice, mumble-voip und SaltyChat behalten ihre eigene Lautstärke

Leistung

Metrik	Wert
Client im Ruhezustand (UI geschlossen)	0,00 ms
Client (UI geöffnet)	< 0,05 ms
Audio-Engine im Hintergrund	< 0,02 ms
Server	0,00 ms (keine serverseitige Logik)

Getestet auf einem 32-Spieler-Server mit 200+ Ressourcen. Keinerlei Auswirkung auf die FPS.

Schnellzugriff

Kauf & Support

Kaufen : hzscripts.com/shop
Support : Discord