FiveM-Sprachchat einrichten und Fehler beheben: pma-voice und SaltyChat

Wähle ein Sprachsystem, das deine Funk- und Telefonressourcen unterstützen, und teste dann Nähe, Funk und Anrufe unabhängig voneinander. pma-voice verwendet FiveMs integrierten Mumble-Transport; SaltyChat fügt einen TeamSpeak-Client-/Plugin-Workflow hinzu. Keine der beiden Optionen garantiert eine bestimmte Latenz oder Klangqualität auf deinem Server.

Die hier gezeigten Konfigurations- und Codebeispiele beziehen sich auf FiveM für GTA V Legacy. Enhanced hat andere Laufzeit- und Kompatibilitätsregeln; überprüfe die Legacy-zu-Enhanced-Änderungen von Cfx.re bevor du sie auf einen Enhanced-Server anwendest.

Wähle nach Abhängigkeiten

Liste die Sprachintegration auf, die von deinem Telefon, Radio, HUD und Framework benötigt wird. Überprüfe bei einer bestehenden mumble-voip-Installation diese Abhängigkeiten, bevor du sie änderst. Für SaltyChat beziehe die unterstützten TeamSpeak-Client-/Plugin-, Server- und Spieler-Setup-Anweisungen in die Entscheidung mit ein.

Lies die pma-voice README oder SaltyChat FiveM-Ressourcen-Dokumentation für die Version, die du installierst. Halte die alte Ressource und Konfiguration für ein Rollback bereit.

Installiere pma-voice auf einem Testserver

Platziere die komplette Ressource in einem Ordner namens pma-voice. Deaktiviere konkurrierende Sprachverwaltung, einschließlich vMenu-Sprachchat, falls vorhanden, und überprüfe, ob andere Skripte ihre Proximity-Natives nicht überschreiben. Behalte Telefon-/Radio-Integrationen zur Überprüfung bei, anstatt davon auszugehen, dass ihre Exporte übereinstimmen.

Für ein natives Audio-Setup füge die folgenden Einstellungen vor dem Ressourcenstart in die aktive server.cfgein. Aktiviere nicht gleichzeitig einen widersprüchlichen 2D- oder 3D-Audiomodus:

setr voice_useNativeAudio true
setr voice_useSendingRangeOnly true
setr voice_enableRadios 1
setr voice_enableCalls 1
setr voice_enableSubmix 1
ensure pma-voice

Vergleiche diese Optionen mit der README deiner Version. Ältere Integrationen verwenden möglicherweise die vorherigen telefonbezogenen Optionen; die aktuelle Upstream-Dokumentation erwähnt voice_enableCalls und voice_defaultCallVolume. Das Aktivieren eines Moduls erstellt keine vollständige Telefon- oder Radio-Benutzeroberfläche.

Überprüfe die Spielersteuerungen

Bitte zwei Testspieler, ihr tatsächliches Mikrofon-/Ausgabegerät auszuwählen und die Mikrofonberechtigung in Windows zu überprüfen. Überprüfe in den Tastaturbelegungen von FiveM die Einträge, die von der Sprachressource registriert wurden. Die Upstream-Standardeinstellungen von pma-voice umfassen F11 für die Nähe und Linke Alt für das Radio; eine gespeicherte Belegung eines bestehenden Spielers kann abweichen.

Das Ändern der Standardtaste des Servers überschreibt nicht die gespeicherten Einstellungen jedes bestehenden Spielers. Behebe Tastenkonflikte in den Einstellungen des jeweiligen Spielers.

Wenn du SaltyChat verwendest

Installiere die Serverressource und die unterstützte TeamSpeak-Plugin-/Client-Kombination gemäß den entsprechenden Release-Anweisungen. Konfiguriere die TeamSpeak-Serveridentität, den Kanal und alle erforderlichen Zugriffseinstellungen privat. Stelle den Spielern die korrekten Server- und Plugin-Anweisungen zur Verfügung.

Überprüfe zuerst die TeamSpeak-Verbindung und das Laden des Plugins, dann die FiveM-Nähe, dann Radio/Anrufe. Eine funktionierende TeamSpeak-Konversation außerhalb des Spiels beweist nicht, dass die FiveM-Integration funktioniert.

Führe die Sprachtestmatrix aus

1. Teste mit zwei gewöhnlichen Spielerkonten die Sprache in der Nähe und außerhalb jedes konfigurierten Proximity-Bereichs.
2. Tritt demselben autorisierten Funkkanal bei und teste beide Richtungen; teste dann einen Spieler ohne Zugriff.
3. Tätige, beantworte und beende einen Telefonanruf. Bestätige, dass der Audiostatus nach dem Auflegen gelöscht wird.
4. Verbinde dich erneut und starte den Testserver neu. Prüfe, ob der Funk- und Anrufstatus wie vorgesehen wiederhergestellt oder gelöscht wird.
5. Teste Innenräume, Fahrzeuge und Routing-Buckets, die von deinem Server verwendet werden. Notiere genau, wo sich das Audioverhalten unterscheidet.

Diagnostiziere eine Ebene nach der anderen

Keine Mikrofoneingabe: Überprüfe das ausgewählte Gerät und die Betriebssystemberechtigung. Proximity funktioniert, aber Radio schlägt fehl: Überprüfe die Radio-Mitgliedschaft, die Item-/Berechtigungslogik und die Integrations-Exporte. Anrufe schlagen nach einem Update fehl: Vergleiche die Telefonintegration mit der installierten Sprach-API. Echo oder unerwartete Effekte: Überprüfe doppelte Sprachmanager und Audiomodi.

Lies die Ressourcenprotokolle, bevor du Einstellungen änderst. Verwende Client Resmon nur für das Skript-Timing; es ist kein End-to-End-Audio-Latenztest. Wenn du die Sprachqualität vergleichst, verwende dieselben Geräte, dasselbe Netzwerk und dieselbe Szene und behalte die tatsächlichen Beobachtungen bei.

Referenzdokumentation

Cfx.re – Sprachchat