Grundlagenai-voice
ai-voice
Sprachchat nach Nähe mit Reichweiten, Funk mit mehreren Frequenzen und Telefonate mit Lautsprecher, auf FiveM Legacy und Enhanced. Ersetzt pma-voice.
ai-voice lässt Spieler miteinander sprechen. Spieler in der Nähe hören einander nach Entfernung, Spieler auf derselben Funkfrequenz hören einander überall, solange die Funktaste gehalten wird, und Spieler im selben Telefonat hören einander überall. Es läuft sowohl auf FiveM Legacy (Mumble) als auch auf FiveM für GTA V Enhanced (Server-Sprachkanäle).
Was es im Spiel macht
- Sprachreichweiten. Spieler wechseln mit der Reichweitentaste zwischen den Reichweiten, die du festlegst (standardmäßig Whisper 1.5 m, Normal 3 m, Shouting 6 m). Das HUD zeigt die Reichweite.
- Funk. Ein Spieler kann mehrere Frequenzen gleichzeitig hören (standardmäßig 3) und spricht auf der aktiven, solange er die Funktaste hält. Ein Klick ertönt, wenn jemand zu sprechen beginnt und aufhört (jeder Spieler kann ihn ausschalten).
- Job-Frequenzen. Frequenzbereiche können für Jobs oder Gangs gesperrt werden (Polizei auf 1 bis 10). Ein Spieler, der den Job verliert oder außer Dienst geht, verlässt diese Frequenzen automatisch.
- Funkanimation (standardmäßig aus): Der Charakter hält beim Sprechen das Schulterfunkgerät oder ein Handfunkgerät. Job-Frequenzen können ihre eigene Animation wählen.
- Telefonate. Spieler im selben Anruf hören einander überall. Telefonskripte setzen Spieler in Anrufe.
- Lautsprecher. Ein Telefonskript kann den Lautsprecher eines Anrufs einschalten: Spieler neben dem Telefon hören den Anruf, und (standardmäßig) hört der Anruf auch sie.
- Soundeffekte. Funk- und Telefonstimmen werden wie ein Lautsprecher oder ein Telefon gefiltert.
- Stummschalten durch Admins.
/muteplyschaltet einen Spieler für eine Zeit stumm. Die Stummschaltung übersteht ein erneutes Verbinden. - Spielerlautstärken. Jeder Spieler kann seine eigene Funk- und Anruflautstärke einstellen; das Panel legt fest, wo sie starten.
Installation
Das txAdmin-Rezept von AI Core installiert es. Von Hand: Lege den Ordner in resources/[ai]/ und füge ensure ai-voice in der server.cfg nach ensure ai-core ein. Es braucht ai-core. Es hat keine Datenbanktabelle.
- Entferne pma-voice, mumble-voip und TokoVOIP: ai-voice beantwortet ihre Namen.
- ai-voice setzt
voice_useNativeAudioundvoice_useSendingRangeOnlyselbst. - Auf FiveM Enhanced brauchen die Funk- und Telefon-Soundeffekte sowie Skripte, die Mumble direkt nutzen (tgiann-radio-v2, tgiann-phone, die Effekte von lb-phone),
setr sv_mumble truein deiner cfg. - pma-voice-Convars, die du schon hast (
voice_defaultVoiceMode,voice_enableRadios,voice_defaultRadioVolumeund die anderen), werden beim ersten Start einmal gelesen und für jede Einstellung, die noch auf dem Standard steht, ins Panel kopiert. Ab dann hat das Panel Vorrang. voice_defaultCycleundvoice_defaultRadiosetzen die Standardtasten der Tastenbelegungen.
Panel-Einstellungen
Öffne das Admin-Panel (F10) und wähle Voice.
Tab Settings
Voice system (Sprachsystem): FiveM Legacy spricht über Mumble; FiveM für GTA V Enhanced über Server-Sprachkanäle.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Voice system | Automatic wählt die Server-Sprachkanäle, wenn der Server sie hat (Enhanced), sonst Mumble. Eine Änderung gilt, wenn ai-voice neu startet. | Automatic / Server voice channels (Enhanced) / Mumble (Legacy) | Automatic |
| In use now | Nur lesbar: das System, auf dem ai-voice gerade läuft. |
Voice ranges (Sprachreichweiten): wie weit ein Spieler zu hören ist. Spieler wechseln mit der Reichweitentaste zwischen diesen Reichweiten.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Ranges | Die Liste der Reichweiten, jede mit einem Name und einer Distance (wie weit diese Reichweite trägt). | 1 bis 6 Reichweiten, je 0.5 bis 100 m | Whisper 1.5 m, Normal 3 m, Shouting 6 m |
| Starting range | Die Position in der Liste, mit der ein Spieler startet (1 = die erste Reichweite). | 1 bis 6 | 2 |
| Players can change their range | Aus hält alle auf der Startreichweite (Skripte können sie trotzdem ändern). | an / aus | an |
| Mumble reach factor | Nur FiveM Legacy: Spieler innerhalb der Reichweite mal dieser Zahl empfangen die Stimme (der Ton von Mumble klingt über eine längere Strecke aus als die Reichweite). 3 ist der Wert von pma-voice. | 1 bis 5 x | 3 |
Radio (Funk): Spieler auf derselben Frequenz hören einander überall, solange die Funktaste gehalten wird.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Radio on | Schaltet den Funk für alle an oder aus. | an / aus | an |
| Radio volume | Wie laut andere über Funk klingen, in Prozent. Spieler können es für sich ändern. | 0 bis 100 % | 30 |
| Frequencies at once | Wie viele Frequenzen ein Spieler gleichzeitig hören kann; er spricht auf einer davon. | 1 bis 10 | 3 |
| Radio sound effect | Filtert die Stimme wie ein Lautsprecher. Auf FiveM Enhanced braucht das setr sv_mumble true. | an / aus | an |
| Effect taken over by | Nur lesbar: ein laufendes Skript, das seinen eigenen Effekt mitbringt (tgiann-radio, tgiann-radio-v2). Der Effekt von ai-voice bleibt aus, solange es läuft. | ||
| Radio clicks | Ein Klick, wenn jemand über Funk zu sprechen beginnt und aufhört. Spieler können ihn für sich ausschalten. | an / aus | an |
| Send names to radio members | Funkskripte, die Mitglieder auflisten, bekommen den Charakternamen jedes Mitglieds. | an / aus | aus |
Radio animation (Funkanimation): was der Charakter tut, während er über Funk spricht.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Radio animation on | Aus: keine Animation auf keiner Frequenz. Skripte können sie auch für einen Spieler ausschalten. | an / aus | aus |
| Animation | Wird auf jeder Frequenz ohne eigene Animation genutzt. | Hand on the shoulder radio / Talking into the shoulder radio / Radio held in the hand / Custom | Hand on the shoulder radio |
| Animation dictionary | Nur Custom: das Animation Dictionary. | Text | random@arrests |
| Animation name | Nur Custom: der Animationsclip. | Text | generic_radio_enter |
| Animation flag | Nur Custom: das Flag von TaskPlayAnim. 49 = Oberkörper, Schleife, kann gehen; 50 = Oberkörper, hält das letzte Bild, kann gehen. | 0 bis 1023 | 49 |
| Radio animation in vehicles | Spielt die Animation auch ab, wenn man in einem Fahrzeug sitzt. | an / aus | an |
Phone calls (Telefonate): Spieler im selben Anruf hören einander überall.
| Einstellung | Was sie ändert | Werte | Standard |
|---|---|---|---|
| Phone calls on | Schaltet Anrufe an oder aus. | an / aus | an |
| Call volume | Wie laut die andere Seite klingt, in Prozent. Spieler können es für sich ändern. | 0 bis 100 % | 60 |
| Phone sound effect | Filtert Anrufstimmen wie ein Telefon. Schalte es aus, wenn dein Telefonskript seinen eigenen Anrufeffekt mitbringt (lb-phone mit CallEffects wird nicht erkannt). | an / aus | an |
| Effect taken over by | Nur lesbar: ein laufendes Skript mit eigenem Anrufeffekt (tgiann-phone). | ||
| Let players' games join calls | Aus (sicher): Nur Serverskripte setzen Spieler in Anrufe, oder ein Telefonskript, das jeden Beitritt prüft. An: Jeder Spieler könnte jedem Anruf beitreten; nötig für Telefone, die Anrufen aus dem Spiel des Spielers beitreten, wie lb-phone. | an / aus | aus |
| Phone loudspeaker | Telefonskripte können den Lautsprecher eines Anrufs einschalten: Spieler, die neben dem Telefon stehen, hören die andere Seite. | an / aus | an |
| Loudspeaker reach | Spieler innerhalb so vieler Meter vom Telefon hören den Anruf. | 0.5 bis 15 m | 3 |
| Loudspeaker volume | Wie laut der Lautsprecher klingt, in Prozent. | 0 bis 100 % | 60 |
| The call hears the people around | Die andere Seite des Anrufs hört auch die Spieler neben dem Telefon. | an / aus | an |
Das Spiel hat eine kleine, feste Anzahl von Soundeffekt-Plätzen und kann keinen entfernen. Einen Effekt auszuschalten beendet seine Nutzung; Spieler geben seinen Platz nur durch einen Neustart des Spiels frei.
Tab Frequencies
Funkfrequenzen, denen nur bestimmte Jobs beitreten können, und ihre Animation. Jeder Datensatz ist ein Frequenzbereich; drücke New frequency range, um einen hinzuzufügen. Frequenzen außerhalb jedes Bereichs sind für alle offen.
| Einstellung | Was sie ändert | Werte | Standard für einen neuen Bereich |
|---|---|---|---|
| Name | Der Name in der Liste (zum Beispiel „Police radio“). | 1 bis 48 Zeichen | |
| From frequency | Die erste Frequenz, wie das Funkgerät sie anzeigt (1, 1.5...). | 0.01 bis 1.000.000 | 1 |
| To frequency | Die letzte Frequenz. Darf nicht niedriger als die erste sein. | 0.01 bis 1.000.000 | 10 |
| Jobs | Nur Mitglieder dieser Jobs können beitreten. Lass Jobs und Gangs leer für alle. | Job-Namen | police |
| Gangs | Mitglieder dieser Gangs können ebenfalls beitreten. | Gang-Namen | leer |
| Only on duty | Job-Mitglieder müssen in diesem Job im Dienst sein. | an / aus | an |
| Animation | Die Funkanimation auf diesen Frequenzen: die Standardanimation, keine oder ein Set. | default / none / ein Set | default |
Befehle
| Befehl | Argumente | Wer | Was er macht |
|---|---|---|---|
/muteply | <id> [seconds] | Admins | Schaltet die Stimme eines Spielers stumm oder hebt die Stummschaltung eines stummen Spielers auf. seconds ist standardmäßig 900 (15 Minuten), höchstens ein Jahr. Der Spieler wird informiert. |
/voicedebug | keine | Admins | Gibt Reichweite, Frequenzen und Anruf jedes Spielers in der Serverkonsole aus. |
Tastenbelegungen
| Standardtaste | Was sie macht | Name in den GTA-Einstellungen |
|---|---|---|
| F11 | Ändert die Sprachreichweite | Change voice range |
| Linke Alt | Spricht auf der aktiven Funkfrequenz, solange gehalten | Talk on the radio |
Die Standardwerte kommen aus den Convars voice_defaultCycle und voice_defaultRadio, wenn du sie setzt. Beide erscheinen in den Tastenhinweisen des HUD („Voice range“, „Radio“).
Zusammenspiel mit anderen Skripten
- Ersetzt pma-voice (
providetpma-voice,mumble-voip,tokovoip,toko-voip,tokovoip_script): seine Exports, State Bags und Events, sodass Funk-, Telefon- und HUD-Skripte, die für pma-voice geschrieben wurden, unverändert laufen. - tgiann-radio funktioniert. tgiann-radio-v2 und tgiann-phone laufen ohne ihre angepassten pma-voice-Dateien; ai-voice schaltet seinen eigenen Funk- oder Telefoneffekt aus, solange sie laufen.
- lb-phone braucht Let players' games join calls eingeschaltet und den Telefoneffekt von ai-voice ausgeschaltet, wenn du die eigenen Anrufeffekte von lb-phone nutzt.
- ai-hud zeigt die Reichweite, das Sprechen und den Funk.
Bekannte Grenzen
- Spielerbefehle von pma-voice (
/vol,/setvoiceintent) gibt es nicht; Spieler nutzen ihre eigenen Tastenbelegungen und die Einstellungen des Funkskripts. - Auf Enhanced wird eine Skript-Reichweite aus dem eigenen Spiel des Spielers (
overrideProximityRange) abgelehnt: Dort setzen Serverskripte die Reichweiten. - Ein Neustart von ai-voice behält die Reichweite, die aktive Frequenz und den Anruf jedes Spielers, aber nicht die zusätzlich gehörten Frequenzen oder die Lautsprecher.
- Ein geändertes Voice system gilt beim nächsten Start von ai-voice.