Essentielsai-voice
ai-voice
Voix de proximité avec portées, radio sur plusieurs fréquences et appels téléphoniques avec haut-parleur, sur FiveM Legacy et Enhanced. Remplace pma-voice.
ai-voice permet aux joueurs de se parler. Les joueurs proches s’entendent selon la distance, les joueurs sur la même fréquence radio s’entendent n’importe où tant que la touche radio est maintenue, et les joueurs dans le même appel téléphonique s’entendent n’importe où. Il fonctionne aussi bien sur FiveM Legacy (Mumble) que sur FiveM pour GTA V Enhanced (canaux vocaux du serveur).
Ce qu’il fait en jeu
- Portées de la voix. Les joueurs passent d’une portée à l’autre parmi celles que vous réglez (Whisper 1,5 m, Normal 3 m, Shouting 6 m par défaut) avec la touche de portée de la voix. Le HUD affiche la portée.
- Radio. Un joueur peut écouter plusieurs fréquences à la fois (3 par défaut) et parle sur la fréquence active tant qu’il maintient la touche radio. Un clic se fait entendre quand quelqu’un commence et arrête de parler (chaque joueur peut le désactiver).
- Fréquences de métier. Des plages de fréquences peuvent être réservées à des métiers ou des gangs (la police sur 1 à 10). Un joueur qui perd le métier ou quitte son service quitte automatiquement ces fréquences.
- Animation radio (désactivée par défaut) : le personnage tient la radio d’épaule ou une radio portative pendant qu’il parle. Les fréquences de métier peuvent choisir leur propre animation.
- Appels téléphoniques. Les joueurs dans le même appel s’entendent n’importe où. Ce sont les scripts de téléphone qui placent les joueurs dans les appels.
- Haut-parleur. Un script de téléphone peut activer le haut-parleur d’un appel : les joueurs à côté du téléphone entendent l’appel, et (par défaut) l’appel les entend aussi.
- Effets sonores. Les voix à la radio et au téléphone sont filtrées comme un haut-parleur ou un téléphone.
- Mise en sourdine par un administrateur.
/muteplyrend un joueur muet pendant un certain temps. La sourdine survit à une reconnexion. - Volumes des joueurs. Chaque joueur peut régler son propre volume de radio et d’appel ; le panneau règle leur valeur de départ.
Installation
La recipe txAdmin d’AI Core l’installe. À la main : placez le dossier dans resources/[ai]/ et ajoutez ensure ai-voice à server.cfg après ensure ai-core. Il nécessite ai-core. Il n’a pas de table de base de données.
- Retirez pma-voice, mumble-voip et TokoVOIP : ai-voice répond à leurs noms.
- ai-voice règle lui-même
voice_useNativeAudioetvoice_useSendingRangeOnly. - Sur FiveM Enhanced, les effets sonores de radio et de téléphone et les scripts qui utilisent directement Mumble (tgiann-radio-v2, tgiann-phone, les effets de lb-phone) nécessitent
setr sv_mumble truedans votre cfg. - Les convars de pma-voice que vous avez déjà (
voice_defaultVoiceMode,voice_enableRadios,voice_defaultRadioVolumeet les autres) sont lues une fois au premier démarrage et copiées dans le panneau pour chaque réglage encore à sa valeur par défaut. Ensuite, c’est le panneau qui l’emporte. voice_defaultCycleetvoice_defaultRadiorèglent les touches par défaut des raccourcis.
Réglages du panneau
Ouvrez le panneau d’administration (F10) et choisissez Voice.
Onglet Settings
Voice system : FiveM Legacy parle via Mumble ; FiveM pour GTA V Enhanced via les canaux vocaux du serveur.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Voice system | Automatic choisit les canaux vocaux du serveur quand le serveur les a (Enhanced), sinon Mumble. Un changement s’applique au prochain démarrage d’ai-voice. | Automatic / Server voice channels (Enhanced) / Mumble (Legacy) | Automatic |
| In use now | Lecture seule : le système sur lequel tourne ai-voice en ce moment. |
Voice ranges : à quelle distance un joueur est entendu. Les joueurs passent d’une portée à l’autre avec la touche de portée de la voix.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Ranges | La liste des portées, chacune avec un Name et une Distance (jusqu’où porte cette portée). | 1 à 6 portées, de 0,5 à 100 m chacune | Whisper 1,5 m, Normal 3 m, Shouting 6 m |
| Starting range | La position dans la liste avec laquelle commence un joueur (1 = la première portée). | 1 à 6 | 2 |
| Players can change their range | Désactivé garde tout le monde à la portée de départ (les scripts peuvent quand même la changer). | activé / désactivé | activé |
| Mumble reach factor | FiveM Legacy uniquement : les joueurs à moins de la portée multipliée par ce nombre reçoivent la voix (l’audio de Mumble s’estompe sur une distance plus longue que la portée). 3 est la valeur de pma-voice. | 1 à 5 x | 3 |
Radio : les joueurs sur la même fréquence s’entendent n’importe où tant que la touche radio est maintenue.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Radio on | Active ou désactive la radio pour tout le monde. | activé / désactivé | activé |
| Radio volume | Le volume des autres à la radio, en pourcentage. Les joueurs peuvent le changer pour eux-mêmes. | 0 à 100 % | 30 |
| Frequencies at once | Combien de fréquences un joueur peut écouter en même temps ; il parle sur l’une d’elles. | 1 à 10 | 3 |
| Radio sound effect | Filtre la voix comme un haut-parleur. Sur FiveM Enhanced, nécessite setr sv_mumble true. | activé / désactivé | activé |
| Effect taken over by | Lecture seule : un script en cours d’exécution qui apporte son propre effet (tgiann-radio, tgiann-radio-v2). L’effet d’ai-voice reste désactivé tant qu’il tourne. | ||
| Radio clicks | Un clic quand quelqu’un commence et arrête de parler à la radio. Les joueurs peuvent le désactiver pour eux-mêmes. | activé / désactivé | activé |
| Send names to radio members | Les scripts de radio qui listent les membres reçoivent le nom de personnage de chaque membre. | activé / désactivé | désactivé |
Radio animation : ce que fait le personnage pendant qu’il parle à la radio.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Radio animation on | Désactivé : aucune animation sur aucune fréquence. Les scripts peuvent aussi la désactiver pour un joueur. | activé / désactivé | désactivé |
| Animation | Utilisée sur chaque fréquence sans animation propre. | Hand on the shoulder radio / Talking into the shoulder radio / Radio held in the hand / Custom | Hand on the shoulder radio |
| Animation dictionary | Custom uniquement : le dictionnaire d’animation. | texte | random@arrests |
| Animation name | Custom uniquement : le clip d’animation. | texte | generic_radio_enter |
| Animation flag | Custom uniquement : le flag de TaskPlayAnim. 49 = haut du corps, en boucle, peut marcher ; 50 = haut du corps, garde la dernière image, peut marcher. | 0 à 1023 | 49 |
| Radio animation in vehicles | Joue aussi l’animation en étant assis dans un véhicule. | activé / désactivé | activé |
Phone calls : les joueurs dans le même appel s’entendent n’importe où.
| Réglage | Ce qu’il change | Valeurs | Défaut |
|---|---|---|---|
| Phone calls on | Active ou désactive les appels. | activé / désactivé | activé |
| Call volume | Le volume de l’autre côté, en pourcentage. Les joueurs peuvent le changer pour eux-mêmes. | 0 à 100 % | 60 |
| Phone sound effect | Filtre les voix d’appel comme un téléphone. Désactivez-le quand votre script de téléphone apporte son propre effet d’appel (lb-phone avec CallEffects n’est pas détecté). | activé / désactivé | activé |
| Effect taken over by | Lecture seule : un script en cours d’exécution avec son propre effet d’appel (tgiann-phone). | ||
| Let players' games join calls | Désactivé (sûr) : seuls les scripts serveur placent les joueurs dans les appels, ou un script de téléphone qui vérifie chaque entrée. Activé : n’importe quel joueur pourrait rejoindre n’importe quel appel ; nécessaire pour les téléphones qui rejoignent les appels depuis le jeu du joueur, comme lb-phone. | activé / désactivé | désactivé |
| Phone loudspeaker | Les scripts de téléphone peuvent activer le haut-parleur d’un appel : les joueurs qui se tiennent à côté du téléphone entendent l’autre côté. | activé / désactivé | activé |
| Loudspeaker reach | Les joueurs à moins de ce nombre de mètres du téléphone entendent l’appel. | 0,5 à 15 m | 3 |
| Loudspeaker volume | Le volume du haut-parleur, en pourcentage. | 0 à 100 % | 60 |
| The call hears the people around | L’autre côté de l’appel entend aussi les joueurs à côté du téléphone. | activé / désactivé | activé |
Le jeu dispose d’un petit nombre fixe d’emplacements d’effets sonores et ne peut pas en supprimer un. Désactiver un effet arrête de l’utiliser ; les joueurs ne libèrent son emplacement qu’en redémarrant le jeu.
Onglet Frequencies
Les fréquences radio que seuls certains métiers peuvent rejoindre, et leur animation. Chaque enregistrement est une plage de fréquences ; appuyez sur New frequency range pour en ajouter une. Les fréquences hors de toute plage sont ouvertes à tous.
| Réglage | Ce qu’il change | Valeurs | Défaut pour une nouvelle plage |
|---|---|---|---|
| Name | Le nom dans la liste (par exemple « Police radio »). | 1 à 48 caractères | |
| From frequency | La première fréquence, telle que l’affiche la radio (1, 1.5...). | 0,01 à 1 000 000 | 1 |
| To frequency | La dernière fréquence. Ne doit pas être inférieure à la première. | 0,01 à 1 000 000 | 10 |
| Jobs | Seuls les membres de ces métiers peuvent la rejoindre. Laissez les métiers et les gangs vides pour tout le monde. | noms de métiers | police |
| Gangs | Les membres de ces gangs peuvent aussi la rejoindre. | noms de gangs | vide |
| Only on duty | Les membres d’un métier doivent être en service dans ce métier. | activé / désactivé | activé |
| Animation | L’animation radio sur ces fréquences : celle par défaut, aucune, ou un ensemble. | default / none / un ensemble | default |
Commandes
| Commande | Arguments | Qui | Ce qu’elle fait |
|---|---|---|---|
/muteply | <id> [seconds] | administrateurs | Rend muette la voix d’un joueur, ou rétablit celle d’un joueur muet. seconds vaut 900 par défaut (15 minutes), un an au plus. Le joueur est prévenu. |
/voicedebug | aucun | administrateurs | Affiche dans la console du serveur la portée, les fréquences et l’appel de chaque joueur. |
Raccourcis clavier
| Touche par défaut | Ce qu’elle fait | Nom dans les réglages de GTA |
|---|---|---|
| F11 | Change la portée de la voix | Change voice range |
| Alt gauche | Parle sur la fréquence radio active tant qu’elle est maintenue | Talk on the radio |
Les valeurs par défaut viennent des convars voice_defaultCycle et voice_defaultRadio quand vous les réglez. Les deux s’affichent dans les aides de touches du HUD (« Voice range », « Radio »).
Fonctionne avec d’autres scripts
- Remplace pma-voice (fait un
providedepma-voice,mumble-voip,tokovoip,toko-voip,tokovoip_script) : ses exports, state bags et events, donc les scripts de radio, de téléphone et de HUD écrits pour pma-voice tournent sans modification. - tgiann-radio fonctionne. tgiann-radio-v2 et tgiann-phone tournent sans leurs fichiers pma-voice personnalisés ; ai-voice désactive son propre effet de radio ou de téléphone tant qu’ils tournent.
- lb-phone nécessite Let players' games join calls activé, et l’effet de téléphone d’ai-voice désactivé si vous utilisez les effets d’appel propres à lb-phone.
- ai-hud affiche la portée, la parole et la radio.
Limites connues
- Les commandes joueur de pma-voice (
/vol,/setvoiceintent) n’existent pas ; les joueurs utilisent leurs propres raccourcis et les réglages du script de radio. - Sur Enhanced, une portée de script venant du jeu du joueur lui-même (
overrideProximityRange) est refusée : ce sont les scripts serveur qui y règlent les portées. - Redémarrer ai-voice garde la portée, la fréquence active et l’appel de chaque joueur, mais pas les fréquences supplémentaires qu’il écoutait ni les haut-parleurs.
- Un changement de Voice system s’applique au prochain démarrage d’ai-voice.