HZ Scripts

FAQ

Allgemein

Streamt HZ-AudioMixer benutzerdefinierte Sounds?

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

Beeinträchtigt es meinen Voice-Chat (pma-voice / saltychat / mumble)?

Nein. Der Mixer ändert nur 9 Soundkategorien von GTA V, und der Voice-Chat gehört zu keiner davon. Sie können weiterhin sprechen und andere Spieler genauso hören wie zuvor, mit der Lautstärke, die Ihre Voice-Ressource einstellt. Was der Mixer für den Voice-Chat tut: Wenn Sie Wetter, Waffen oder Fahrzeuge leiser stellen, sind Stimmen leichter zu verstehen.

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

Ja. Kein Framework erforderlich. Das Skript muss nichts erkennen, da es nichts benötigt. Seine einzige Abhängigkeit ist hz_lib (kostenlos).

Brauche ich eine Datenbank?

Nein. Die Spielereinstellungen werden clientseitig über FiveM KVP (Key-Value Persistence) gespeichert. Die Präferenzen jedes Spielers bleiben auf seinem eigenen Rechner und überdauern Server-Neustarts und Neuverbindungen.

Ist es kompatibel mit QBCore / QBox / ESX?

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

Oberfläche & Anpassung

Kann ich das Design der Oberfläche ändern?

Ja. Die Dateien in html/ (index.html, style.css, app.js) liegen absichtlich außerhalb von Asset Escrow. Das Panel basiert auf dem UI-Kit von hz_lib: Farben und Schriften kommen aus Ihrem hz_lib-Theme (/hzpanel), das Layout steht in style.css, Gruppen und Reihenfolge in app.js. Nur die Audio-Engine-Logik (client.lua) und shared/locale.lua sind verschlüsselt. Siehe Konfiguration.

Kann ich eigene Regler in mein Pause-Menü einbauen?

Ja. HZ-AudioMixer stellt eine vollständige API bereit (getCategoriesData, setVolume, Event volumeChanged), damit Sie eigene Regler in jedem benutzerdefinierten NUI erstellen können. Siehe Exports & Events für vollständige Integrationsbeispiele.

Kann ich bestimmte Kategorien deaktivieren?

Ja. Setzen Sie Config.Categories.<Kategorie> = false und der Regler verschwindet aus der Oberfläche; der zugehörige Audio-Szenen-Patch wird ignoriert. Siehe Konfiguration.

Kann ich eigene Übersetzungen hinzufügen?

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

Kann ich die Tastenkombination ändern?

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-Menü ändern (Einstellungen -> Tastenbelegung -> FiveM -> "HZ Audio Mixer öffnen", auf Englisch "Open HZ Audio Mixer"; die Sprache folgt Config.Locale).

Technik

Welche Audiokategorien werden gesteuert?

9 Kategorien der RAGE-Engine: weapons, vehicles, ambience, weather, speech, peds, scripted, music, radio. Dies sind übergeordnete Kategorien — eine Anpassung von vehicles wirkt sich auf Motoren, Hupen, Sirenen, Hubschrauber usw. gleichzeitig aus. Was jede Kategorie enthält, steht in der Liste der Kategorien.

Auf keinem Kanal liegen: Voice-Chat, von NUI-Skripten abgespielte Sounds (xSound, interact-sound), Zusammenstöße und andere Kollisionen, Missionsmusik, Oberflächen- und Menügeräusche, Zwischensequenzen, Türen, Feuer, Wasser und Tiere.

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

Ja. Solange die benutzerdefinierten Sounds über 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 und die in der Welt platzierten Radios (Gebäude, Clubs). Im Spiel liegt radio innerhalb von music (dem Spiel-Soundtrack): Die beiden Lautstärken multiplizieren sich, daher schaltet Musik auf 0% auch das Radio stumm.

Werden die Einstellungen meiner Spieler bei einem Server-Neustart zurückgesetzt?

Nein. Die Einstellungen werden im FiveM KVP auf dem Client-Rechner gespeichert. Sie überdauern Ressourcen-Neustarts, Server-Neustarts und Verbindungsabbrüche.

Was passiert beim ersten Login?

Jede Kategorie steht standardmäßig auf Config.DefaultVolume (100 = maximale Lautstärke). Spieler sehen den Mixer beim ersten Start mit allen Reglern auf 100%.

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

Beim Spawn startet das Skript seine Audio-Szene und wendet die gespeicherten Lautstärken 15 Sekunden lang bei jedem Frame erneut an, danach alle 500 ms. Fehlt dann noch ein Sound, bitten Sie den Spieler, F7 zu drücken und zu prüfen, ob der betreffende Regler auf 0% steht (beim Radio auch Musik).

Leistung

Ist es FPS-intensiv?

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

Läuft es auf dem Server?

Keine serverseitige Logik. Alles läuft clientseitig. Die Einstellungen jedes Spielers gehören nur ihm.

Kollidiert es mit anderen Audio-Skripten?

Nein. Der Mixer steuert nur seine eigene Audio-Szene auf den RAGE-Audiokategorien. Er berührt keine andere Sound-Ressource und keinen Audio-Submix und koexistiert mit jedem anderen Audio-Skript.

Sicherheit & Lizenz

Ist das Skript gegen Diebstahl geschützt?

Ja. Die Audio-Engine-Logik (client.lua) ist über FiveM Asset Escrow verschlüsselt.

Kann ich es mit dem Server eines Freundes teilen?

Nein. Einzelserver-Lizenz. Weiterverkauf, Weiterverbreitung oder das Teilen des Quellcodes ist untersagt. Asset Escrow-Verstöße 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

Die Audio-Szene startet nicht

Setzen Sie Config.Debug = true: Nach dem Spawn sollte F8 [HZ-AudioMixer] Scene active anzeigen. Erscheint die Zeile nie, wurden die Dateien dat15.rel / dat151.rel nicht rechtzeitig geladen. Prüfen 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

Öffnen Sie Pause-Menü -> Einstellungen -> Tastenbelegung -> FiveM -> Suchen Sie "HZ Audio Mixer öffnen" ("Open HZ Audio Mixer" auf Englisch) -> Weisen Sie eine freie Taste zu.

Der Mixer öffnet sich, aber das Bewegen der Regler ändert nichts

Die Audio-Szene ist nicht gestartet: siehe "Die Audio-Szene startet nicht" oben.

Ein Sound bleibt stumm

Gespeicherte Lautstärken begleiten den Spieler von einer Sitzung zur nächsten. Öffnen Sie den Mixer mit F7 und prüfen Sie, ob der Regler auf 0% steht. Prüfen Sie beim Radio auch Musik. Drücken Sie zweimal R, um alle Kanäle auf Config.DefaultVolume zurückzusetzen.

Nächster Schritt