Essenciaisai-voice
ai-voice
Voz por proximidade com alcances, rádio com várias frequências e chamadas telefônicas com alto-falante, no FiveM Legacy e Enhanced. Substitui o pma-voice.
O ai-voice deixa os jogadores conversarem. Jogadores próximos se ouvem pela distância, jogadores na mesma frequência de rádio se ouvem em qualquer lugar enquanto a tecla do rádio está pressionada, e jogadores na mesma chamada telefônica se ouvem em qualquer lugar. Ele roda tanto no FiveM Legacy (Mumble) quanto no FiveM para GTA V Enhanced (canais de voz do servidor).
O que faz no jogo
- Alcances de voz. Os jogadores alternam entre os alcances que você define (Whisper 1,5 m, Normal 3 m, Shouting 6 m por padrão) com a tecla de alcance de voz. O HUD mostra o alcance.
- Rádio. Um jogador pode ouvir várias frequências ao mesmo tempo (3 por padrão) e fala na ativa enquanto segura a tecla do rádio. Um clique toca quando alguém começa e para de falar (cada jogador pode desligá-lo).
- Frequências de emprego. Faixas de frequência podem ser restritas a empregos ou gangues (polícia de 1 a 10). Um jogador que perde o emprego ou sai de serviço sai dessas frequências automaticamente.
- Animação de rádio (desligada por padrão): o personagem segura o rádio do ombro ou um rádio de mão enquanto fala. As frequências de emprego podem escolher a própria animação.
- Chamadas telefônicas. Jogadores na mesma chamada se ouvem em qualquer lugar. Scripts de celular colocam os jogadores em chamadas.
- Alto-falante. Um script de celular pode ligar o alto-falante de uma chamada: os jogadores ao lado do celular ouvem a chamada, e (por padrão) a chamada também os ouve.
- Efeitos sonoros. As vozes do rádio e do celular são filtradas como um alto-falante ou um telefone.
- Silêncio por administrador.
/muteplysilencia um jogador por um tempo. O silêncio sobrevive a uma reconexão. - Volumes do jogador. Cada jogador pode definir o próprio volume do rádio e das chamadas; o painel define onde eles começam.
Instalação
A receita do txAdmin do AI Core o instala. À mão: coloque a pasta em resources/[ai]/ e adicione ensure ai-voice ao server.cfg depois de ensure ai-core. Ele precisa do ai-core. Ele não tem tabela no banco de dados.
- Remova o pma-voice, o mumble-voip e o TokoVOIP: o ai-voice responde pelos nomes deles.
- O ai-voice define
voice_useNativeAudioevoice_useSendingRangeOnlysozinho. - No FiveM Enhanced, os efeitos sonoros de rádio e celular e os scripts que usam o Mumble diretamente (tgiann-radio-v2, tgiann-phone, os efeitos do lb-phone) precisam de
setr sv_mumble trueno seu cfg. - As convars do pma-voice que você já tem (
voice_defaultVoiceMode,voice_enableRadios,voice_defaultRadioVolumee as outras) são lidas uma vez na primeira inicialização e copiadas para o painel em toda configuração que ainda está no padrão. Daí em diante o painel vale. voice_defaultCycleevoice_defaultRadiodefinem as teclas padrão dos keybinds.
Configurações do painel
Abra o painel de administração (F10) e escolha Voice.
Aba Settings
Voice system: o FiveM Legacy fala pelo Mumble; o FiveM para GTA V Enhanced pelos canais de voz do servidor.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Voice system | Automatic escolhe os canais de voz do servidor quando o servidor os tem (Enhanced), senão o Mumble. Uma mudança vale quando o ai-voice inicia de novo. | Automatic / Server voice channels (Enhanced) / Mumble (Legacy) | Automatic |
| In use now | Só leitura: o sistema em que o ai-voice roda agora. |
Voice ranges: até onde um jogador é ouvido. Os jogadores alternam entre esses alcances com a tecla de alcance de voz.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Ranges | A lista de alcances, cada um com um Name e uma Distance (até onde esse alcance chega). | 1 a 6 alcances, 0.5 a 100 m cada | Whisper 1,5 m, Normal 3 m, Shouting 6 m |
| Starting range | A posição na lista com que um jogador começa (1 = o primeiro alcance). | 1 a 6 | 2 |
| Players can change their range | Desligado mantém todos no alcance inicial (scripts ainda podem mudá-lo). | ligado / desligado | ligado |
| Mumble reach factor | Só FiveM Legacy: jogadores dentro do alcance vezes este número recebem a voz (o áudio do Mumble some ao longo de uma distância maior que o alcance). 3 é o valor do pma-voice. | 1 a 5 x | 3 |
Radio: jogadores na mesma frequência se ouvem em qualquer lugar enquanto a tecla do rádio está pressionada.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Radio on | Liga ou desliga o rádio para todos. | ligado / desligado | ligado |
| Radio volume | O volume dos outros no rádio, em porcentagem. Os jogadores podem mudá-lo para si. | 0 a 100 % | 30 |
| Frequencies at once | Quantas frequências um jogador pode ouvir ao mesmo tempo; ele fala em uma delas. | 1 a 10 | 3 |
| Radio sound effect | Filtra a voz como um alto-falante. No FiveM Enhanced isso precisa de setr sv_mumble true. | ligado / desligado | ligado |
| Effect taken over by | Só leitura: um script rodando que traz seu próprio efeito (tgiann-radio, tgiann-radio-v2). O efeito do ai-voice fica desligado enquanto ele roda. | ||
| Radio clicks | Um clique quando alguém começa e para de falar no rádio. Os jogadores podem desligá-lo para si. | ligado / desligado | ligado |
| Send names to radio members | Scripts de rádio que listam os membros recebem o nome de personagem de cada membro. | ligado / desligado | desligado |
Radio animation: o que o personagem faz enquanto fala no rádio.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Radio animation on | Desligado: nenhuma animação em nenhuma frequência. Scripts também podem desligá-la para um jogador. | ligado / desligado | desligado |
| Animation | Usada em toda frequência sem animação própria. | Hand on the shoulder radio / Talking into the shoulder radio / Radio held in the hand / Custom | Hand on the shoulder radio |
| Animation dictionary | Só Custom: o dicionário de animação. | texto | random@arrests |
| Animation name | Só Custom: o clipe de animação. | texto | generic_radio_enter |
| Animation flag | Só Custom: a flag do TaskPlayAnim. 49 = parte de cima do corpo, repete, pode andar; 50 = parte de cima do corpo, segura o último frame, pode andar. | 0 a 1023 | 49 |
| Radio animation in vehicles | Toca a animação também sentado em um veículo. | ligado / desligado | ligado |
Phone calls: jogadores na mesma chamada se ouvem em qualquer lugar.
| Configuração | O que muda | Valores | Padrão |
|---|---|---|---|
| Phone calls on | Liga ou desliga as chamadas. | ligado / desligado | ligado |
| Call volume | O volume do outro lado, em porcentagem. Os jogadores podem mudá-lo para si. | 0 a 100 % | 60 |
| Phone sound effect | Filtra as vozes das chamadas como um telefone. Desligue quando o seu script de celular trouxer seu próprio efeito de chamada (o lb-phone com CallEffects não é detectado). | ligado / desligado | ligado |
| Effect taken over by | Só leitura: um script rodando com seu próprio efeito de chamada (tgiann-phone). | ||
| Let players' games join calls | Desligado (seguro): só scripts de servidor colocam jogadores em chamadas, ou um script de celular que verifica cada entrada. Ligado: qualquer jogador poderia entrar em qualquer chamada; necessário para celulares que entram em chamadas a partir do jogo do jogador, como o lb-phone. | ligado / desligado | desligado |
| Phone loudspeaker | Scripts de celular podem ligar o alto-falante de uma chamada: os jogadores ao lado do celular ouvem o outro lado. | ligado / desligado | ligado |
| Loudspeaker reach | Jogadores a até essa quantidade de metros do celular ouvem a chamada. | 0.5 a 15 m | 3 |
| Loudspeaker volume | O volume do alto-falante, em porcentagem. | 0 a 100 % | 60 |
| The call hears the people around | O outro lado da chamada também ouve os jogadores ao lado do celular. | ligado / desligado | ligado |
O jogo tem um número pequeno e fixo de slots de efeitos sonoros e não consegue remover um. Desligar um efeito para de usá-lo; os jogadores só liberam o slot dele reiniciando o jogo.
Aba Frequencies
Frequências de rádio em que só alguns empregos podem entrar, e a animação delas. Cada registro é uma faixa de frequências; aperte New frequency range para adicionar uma. As frequências fora de toda faixa são abertas a todos.
| Configuração | O que muda | Valores | Padrão para uma faixa nova |
|---|---|---|---|
| Name | O nome na lista (por exemplo "Police radio"). | 1 a 48 caracteres | |
| From frequency | A primeira frequência, como o rádio a mostra (1, 1.5...). | 0.01 a 1.000.000 | 1 |
| To frequency | A última frequência. Não pode ser menor que a primeira. | 0.01 a 1.000.000 | 10 |
| Jobs | Só membros desses empregos podem entrar. Deixe empregos e gangues vazios para todos. | nomes de empregos | police |
| Gangs | Membros dessas gangues também podem entrar. | nomes de gangues | vazio |
| Only on duty | Membros do emprego precisam estar em serviço naquele emprego. | ligado / desligado | ligado |
| Animation | A animação de rádio nessas frequências: a padrão, nenhuma, ou um conjunto. | default / none / um conjunto | default |
Comandos
| Comando | Argumentos | Quem | O que faz |
|---|---|---|---|
/muteply | <id> [seconds] | administradores | Silencia a voz de um jogador, ou tira o silêncio de um jogador silenciado. seconds tem padrão 900 (15 minutos), no máximo um ano. O jogador é avisado. |
/voicedebug | nenhum | administradores | Imprime o alcance, as frequências e a chamada de cada jogador no console do servidor. |
Teclas
| Tecla padrão | O que faz | Nome nas configurações do GTA |
|---|---|---|
| F11 | Muda o alcance da voz | Change voice range |
| Left Alt | Fala na frequência de rádio ativa enquanto pressionada | Talk on the radio |
Os padrões vêm das convars voice_defaultCycle e voice_defaultRadio quando você as define. As duas aparecem nas dicas de teclas do HUD ("Voice range", "Radio").
Funciona com outros scripts
- Substitui o pma-voice (faz
providedepma-voice,mumble-voip,tokovoip,toko-voip,tokovoip_script): seus exports, state bags e eventos, então scripts de rádio, celular e HUD escritos para o pma-voice rodam sem alterações. - O tgiann-radio funciona. O tgiann-radio-v2 e o tgiann-phone rodam sem os arquivos personalizados de pma-voice deles; o ai-voice desliga seu próprio efeito de rádio ou de celular enquanto eles rodam.
- O lb-phone precisa de Let players' games join calls ligado, e do efeito de celular do ai-voice desligado se você usar os próprios efeitos de chamada do lb-phone.
- O ai-hud mostra o alcance, quem está falando e o rádio.
Limites conhecidos
- Os comandos de jogador do pma-voice (
/vol,/setvoiceintent) não existem; os jogadores usam os próprios keybinds e as configurações do script de rádio. - No Enhanced, um alcance de script vindo do próprio jogo do jogador (
overrideProximityRange) é recusado: lá, os scripts de servidor definem os alcances. - Reiniciar o ai-voice mantém o alcance, a frequência ativa e a chamada de cada jogador, mas não as frequências extras que ele ouvia nem os alto-falantes.
- Um Voice system alterado vale na próxima inicialização do ai-voice.