HZ Scripts

FAQ

Allgemein

Streamt HZ-AudioMixer benutzerdefinierte Sounds?

Nein. HZ-AudioMixer streamt, spielt oder aendert keine Sounddateien. Es steuert die nativen GTA V-Audiokategorien, die das Spiel selbst verwendet. Kein Einfluss auf die Dateigroesse, keine Konflikte mit anderen Audio-Ressourcen (xSound, interact-sound usw.).

Beeintraechtigt es meinen Voice-Chat (pma-voice / saltychat / mumble)?

Nein. Voice-Chat-Audio laeuft ueber ein separates Submix-System und wird von HZ-AudioMixer nicht beeinflusst. Sie koennen weiterhin sprechen und andere Spieler genauso hoeren wie zuvor.

Funktioniert es auf Standalone- / vMenu- / Vanilla-Servern?

Ja. Kein Framework erforderlich. Das Skript muss nichts erkennen, da es nichts benoetigt — reiner FiveM-Standard.

Brauche ich eine Datenbank?

Nein. Die Spielereinstellungen werden clientseitig ueber FiveM KVP (Key-Value Persistence) gespeichert. Die Praeferenzen jedes Spielers bleiben auf seinem eigenen Rechner und ueberdauern Server-Neustarts und Neuverbindungen.

Ist es kompatibel mit QBCore / QBox / ESX?

Ja. Alle Frameworks werden unterstuetzt — das Skript nutzt jedoch keine Framework-Funktionen. Es funktioniert einfach.

Oberflaeche & Anpassung

Kann ich das Design der Oberflaeche aendern?

Ja. Das HTML/CSS in html/index.html liegt absichtlich ausserhalb von Asset Escrow, damit Sie es vollstaendig umgestalten koennen. Nur die Audio-Engine-Logik (client.lua) ist verschluesselt.

Kann ich eigene Regler in mein Pause-Menue einbauen?

Ja. HZ-AudioMixer stellt eine vollstaendige API bereit (getCategoriesData, setVolume, Event volumeChanged), damit Sie eigene Regler in jedem benutzerdefinierten NUI erstellen koennen. Siehe Exports & Events fuer vollstaendige Integrationsbeispiele.

Kann ich bestimmte Kategorien deaktivieren?

Ja. Setzen Sie Config.Categories.<Kategorie> = false und der Regler verschwindet aus der Oberflaeche; der zugehoerige Audio-Szenen-Patch wird ignoriert. Siehe Konfiguration.

Kann ich eigene Uebersetzungen hinzufuegen?

Ja. Legen Sie eine Datei locales/<code>.lua in der Ressource ab. Verwenden Sie eine beliebige vorhandene Locale als Vorlage. 14 Sprachen sind standardmaessig enthalten.

Kann ich die Tastenkombination aendern?

Ja — sowohl vom Server (Standardwert) als auch individuell von jedem Spieler. Der Serverstandardwert steht in Config.OpenKey (Standard F7). Jeder Spieler kann ihn im FiveM Pause-Menue aendern (Einstellungen -> Tastenbelegung -> FiveM -> "Mixer Audio HZ").

Technik

Welche Audiokategorien werden gesteuert?

9 Kategorien der RAGE-Engine: weapons, vehicles, ambience, weather, speech, peds, scripted, music, radio. Dies sind uebergeordnete Kategorien — eine Anpassung von vehicles wirkt sich auf Motoren, Hupen, Sirenen, Hubschrauber usw. gleichzeitig aus.

Ist es kompatibel mit benutzerdefinierten Audio-Mods (Fahrzeugsound-Packs, Waffensound-Mods)?

Ja. Solange die benutzerdefinierten Sounds ueber die Standard-RAGE-Audiokategorien laufen (was bei Gameplay-Sounds immer der Fall ist), reagieren sie auf den Mixer.

Beeinflusst es die Fahrzeugradio-Musik?

Ja — der radio-Regler steuert das Fahrzeugradio unabhaengig vom music-Regler (der die Umgebungs-/Spiel-Soundtrack-Musik steuert).

Werden die Einstellungen meiner Spieler bei einem Server-Neustart zurueckgesetzt?

Nein. Die Einstellungen werden im FiveM KVP auf dem Client-Rechner gespeichert. Sie ueberdauern Ressourcen-Neustarts, Server-Neustarts und Verbindungsabbrueche.

Was passiert beim ersten Login?

Jede Kategorie steht standardmaessig auf Config.DefaultVolume (100 = maximale Lautstaerke). Spieler sehen den Mixer beim ersten Start mit allen Reglern auf 100%.

Was tun, wenn ein Spieler nach dem Spawn keinen Ton hat?

Sehr selten, aber falls es passiert: Die Audio-Szene braucht einige Sekunden, um sich beim ersten Login zu registrieren. Das Skript hat eine aggressive 15-Sekunden-Wiederherstellungsschleife, die bei jedem Frame die Werte erneut anwendet. Falls der Ton nicht zurueckkehrt, bitten Sie den Spieler, F7 zu druecken und zu pruefen, ob die Regler nicht auf 0% stehen.

Leistung

Ist es FPS-intensiv?

Nein. UI geschlossen = 0,00 ms. UI geoeffnet = <0,05 ms. Audio-Engine im Hintergrund = <0,02 ms. Getestet auf 32-Spieler-Servern mit 200+ Ressourcen, keinerlei Auswirkung auf die FPS.

Laeuft es auf dem Server?

Keine serverseitige Logik. Alles laeuft clientseitig. Die Einstellungen jedes Spielers gehoeren nur ihm.

Kollidiert es mit anderen Audio-Skripten?

Nein. Der Mixer verwendet das RAGE Audio-Szenen-System auf Engine-Ebene — er beruehrt keine Sound-Ressourcen, nativen Aufrufe oder Audio-Submixe. Er koexistiert mit jedem anderen Audio-Skript.

Sicherheit & Lizenz

Ist das Skript gegen Diebstahl geschuetzt?

Ja. Die Audio-Engine-Logik (client.lua) ist ueber FiveM Asset Escrow verschluesselt. Die audioconfig/*.rel-Dateien enthalten obfuskierte Kategorienamen (z. B. _v_a3f statt weapons) — ohne das verschluesselte Lua-Mapping sind die Binaerdateien nutzlos.

Kann ich es mit dem Server eines Freundes teilen?

Nein. Einzelserver-Lizenz. Weiterverkauf, Weiterverbreitung oder das Teilen des Quellcodes ist untersagt. Asset Escrow-Verstoesse werden nachverfolgt und gemeldet.

Funktioniert es auf einem geteilten Tebex-Server?

Das Skript ist an Ihr CFX/Keymaster-Konto gebunden. Wenn Ihr geteilter Server Ihr Konto verwendet, funktioniert es. Wenn er das Konto eines anderen verwendet, nicht.

Fehlerbehebung

WARN: Scene non active in F8

Die Dateien dat15.rel / dat151.rel wurden nicht rechtzeitig geladen. Pruefen Sie:

  1. Der Ordner audioconfig/ existiert in der Ressource
  2. data_file 'AUDIO_DYNAMIXDATA' und data_file 'AUDIO_GAMEDATA' stehen in der fxmanifest.lua
  3. Starten Sie den gesamten Server neu (nicht nur restart hz-audiomixer) — Audio-Datendateien erfordern einen sauberen Start zur Registrierung

F7 kollidiert mit einer anderen Ressource

Oeffnen Sie Pause-Menue -> Einstellungen -> Tastenbelegung -> FiveM -> Suchen Sie "Mixer Audio HZ" -> Weisen Sie eine freie Taste zu.

Der Mixer oeffnet sich, aber das Bewegen der Regler aendert nichts

Pruefen Sie, ob mixerReady auf true steht — oeffnen Sie F8 mit Config.Debug = true und suchen Sie nach [hz_audiomixer] Scene active. Falls Sie WARN: Scene non active sehen, hat sich die Audio-Szene nicht registriert (siehe oben).

Nach dem Login sind alle Toene fuer einige Sekunden stummgeschaltet

Das ist die aggressive 15-Sekunden-Wiederherstellungsphase beim Spawn. Der Mixer wendet Ihre gespeicherten Werte Frame fuer Frame an, um sicherzustellen, dass sie wirksam werden. Falls die Stille laenger als 15 Sekunden anhaelt, ueberpruefen Sie, ob Ihre gespeicherten KVP-Werte nicht alle auf 0 stehen (oeffnen Sie den Mixer mit F7 und pruefen Sie).

Naechster Schritt