Esencialesai-voice
ai-voice
Voz por proximidad con alcances, radio con varias frecuencias y llamadas telefónicas con altavoz, en FiveM Legacy y Enhanced. Sustituye a pma-voice.
ai-voice permite a los jugadores hablar entre sí. Los jugadores cercanos se oyen según la distancia, los jugadores en la misma frecuencia de radio se oyen en cualquier sitio mientras mantienen la tecla de radio, y los jugadores en la misma llamada telefónica se oyen en cualquier sitio. Funciona tanto en FiveM Legacy (Mumble) como en FiveM para GTA V Enhanced (canales de voz del servidor).
Qué hace en el juego
- Alcances de voz. Los jugadores cambian entre los alcances que configures (Whisper 1.5 m, Normal 3 m, Shouting 6 m por defecto) con la tecla de alcance de voz. El HUD muestra el alcance.
- Radio. Un jugador puede escuchar varias frecuencias a la vez (3 por defecto) y habla en la activa mientras mantiene la tecla de radio. Suena un clic cuando alguien empieza y deja de hablar (cada jugador puede desactivarlo).
- Frecuencias de trabajo. Los rangos de frecuencias pueden bloquearse para trabajos o bandas (la policía de la 1 a la 10). Un jugador que pierde el trabajo o sale de servicio abandona esas frecuencias automáticamente.
- Animación de radio (desactivada por defecto): el personaje sujeta la radio del hombro o una radio de mano mientras habla. Las frecuencias de trabajo pueden elegir su propia animación.
- Llamadas telefónicas. Los jugadores en la misma llamada se oyen en cualquier sitio. Los scripts de teléfono meten a los jugadores en las llamadas.
- Altavoz. Un script de teléfono puede activar el altavoz de una llamada: los jugadores junto al teléfono oyen la llamada y (por defecto) la llamada también los oye a ellos.
- Efectos de sonido. Las voces de radio y teléfono se filtran como un altavoz o un teléfono.
- Silencio por administrador.
/muteplysilencia a un jugador durante un tiempo. El silencio se mantiene al reconectarse. - Volúmenes de cada jugador. Cada jugador puede fijar su propio volumen de radio y de llamadas; el panel fija el valor inicial.
Instalación
La receta de txAdmin de AI Core lo instala. A mano: pon la carpeta en resources/[ai]/ y añade ensure ai-voice a server.cfg después de ensure ai-core. Necesita ai-core. No tiene tabla de base de datos.
- Quita pma-voice, mumble-voip y TokoVOIP: ai-voice responde a sus nombres.
- ai-voice fija por sí mismo
voice_useNativeAudioyvoice_useSendingRangeOnly. - En FiveM Enhanced, los efectos de sonido de radio y teléfono y los scripts que usan Mumble directamente (tgiann-radio-v2, tgiann-phone, los efectos de lb-phone) necesitan
setr sv_mumble trueen tu cfg. - Las convars de pma-voice que ya tengas (
voice_defaultVoiceMode,voice_enableRadios,voice_defaultRadioVolumey las demás) se leen una vez en el primer inicio y se copian al panel para cada ajuste que siga en su valor por defecto. A partir de ahí manda el panel. voice_defaultCycleyvoice_defaultRadiofijan las teclas por defecto de los atajos.
Ajustes del panel
Abre el panel de administración (F10) y elige Voice.
Pestaña Settings
Voice system (sistema de voz): FiveM Legacy habla por Mumble; FiveM para GTA V Enhanced por los canales de voz del servidor.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Voice system | Automatic elige los canales de voz del servidor cuando el servidor los tiene (Enhanced), si no Mumble. Un cambio se aplica cuando ai-voice vuelve a iniciarse. | Automatic / Server voice channels (Enhanced) / Mumble (Legacy) | Automatic |
| In use now | Solo lectura: el sistema con el que funciona ai-voice ahora. |
Voice ranges (alcances de voz): a qué distancia se oye a un jugador. Los jugadores cambian entre estos alcances con la tecla de alcance de voz.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Ranges | La lista de alcances, cada uno con un Name y una Distance (hasta dónde llega este alcance). | 1 a 6 alcances, de 0.5 a 100 m cada uno | Whisper 1.5 m, Normal 3 m, Shouting 6 m |
| Starting range | La posición en la lista con la que empieza un jugador (1 = el primer alcance). | 1 a 6 | 2 |
| Players can change their range | Desactivado mantiene a todos en el alcance inicial (los scripts aún pueden cambiarlo). | activado / desactivado | activado |
| Mumble reach factor | Solo FiveM Legacy: los jugadores dentro del alcance multiplicado por este número reciben la voz (el audio de Mumble se desvanece en una distancia mayor que el alcance). 3 es el valor de pma-voice. | 1 a 5 x | 3 |
Radio: los jugadores en la misma frecuencia se oyen en cualquier sitio mientras mantienen la tecla de radio.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Radio on | Activa o desactiva la radio para todos. | activado / desactivado | activado |
| Radio volume | Lo alto que suenan los demás por la radio, en porcentaje. Los jugadores pueden cambiarlo para sí mismos. | 0 a 100 % | 30 |
| Frequencies at once | Cuántas frecuencias puede escuchar un jugador a la vez; habla en una de ellas. | 1 a 10 | 3 |
| Radio sound effect | Filtra la voz como un altavoz. En FiveM Enhanced necesita setr sv_mumble true. | activado / desactivado | activado |
| Effect taken over by | Solo lectura: un script en marcha que trae su propio efecto (tgiann-radio, tgiann-radio-v2). El efecto de ai-voice se queda desactivado mientras funciona. | ||
| Radio clicks | Un clic cuando alguien empieza y deja de hablar por la radio. Los jugadores pueden desactivarlo para sí mismos. | activado / desactivado | activado |
| Send names to radio members | Los scripts de radio que listan a los miembros reciben el nombre de personaje de cada miembro. | activado / desactivado | desactivado |
Radio animation (animación de radio): lo que hace el personaje mientras habla por la radio.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Radio animation on | Desactivado: sin animación en ninguna frecuencia. Los scripts también pueden desactivarla para un jugador. | activado / desactivado | desactivado |
| Animation | Se usa en cada frecuencia sin animación propia. | Hand on the shoulder radio / Talking into the shoulder radio / Radio held in the hand / Custom | Hand on the shoulder radio |
| Animation dictionary | Solo Custom: el diccionario de animación. | texto | random@arrests |
| Animation name | Solo Custom: el clip de animación. | texto | generic_radio_enter |
| Animation flag | Solo Custom: el flag de TaskPlayAnim. 49 = parte superior del cuerpo, en bucle, puede caminar; 50 = parte superior del cuerpo, mantiene el último fotograma, puede caminar. | 0 a 1023 | 49 |
| Radio animation in vehicles | Reproduce la animación también sentado en un vehículo. | activado / desactivado | activado |
Phone calls (llamadas telefónicas): los jugadores en la misma llamada se oyen en cualquier sitio.
| Ajuste | Qué cambia | Valores | Por defecto |
|---|---|---|---|
| Phone calls on | Activa o desactiva las llamadas. | activado / desactivado | activado |
| Call volume | Lo alto que suena el otro lado, en porcentaje. Los jugadores pueden cambiarlo para sí mismos. | 0 a 100 % | 60 |
| Phone sound effect | Filtra las voces de las llamadas como un teléfono. Desactívalo cuando tu script de teléfono traiga su propio efecto de llamada (lb-phone con CallEffects no se detecta). | activado / desactivado | activado |
| Effect taken over by | Solo lectura: un script en marcha con su propio efecto de llamada (tgiann-phone). | ||
| Let players' games join calls | Desactivado (seguro): solo los scripts de servidor meten a los jugadores en llamadas, o un script de teléfono que comprueba cada entrada. Activado: cualquier jugador podría unirse a cualquier llamada; lo necesitan los teléfonos que se unen a las llamadas desde el juego del jugador, como lb-phone. | activado / desactivado | desactivado |
| Phone loudspeaker | Los scripts de teléfono pueden activar el altavoz de una llamada: los jugadores junto al teléfono oyen el otro lado. | activado / desactivado | activado |
| Loudspeaker reach | Los jugadores a menos de estos metros del teléfono oyen la llamada. | 0.5 a 15 m | 3 |
| Loudspeaker volume | Lo alto que suena el altavoz, en porcentaje. | 0 a 100 % | 60 |
| The call hears the people around | El otro lado de la llamada también oye a los jugadores junto al teléfono. | activado / desactivado | activado |
El juego tiene un número pequeño y fijo de ranuras de efectos de sonido y no puede quitar ninguna. Desactivar un efecto deja de usarlo; los jugadores solo liberan su ranura reiniciando el juego.
Pestaña Frequencies
Frecuencias de radio a las que solo pueden unirse algunos trabajos, y su animación. Cada registro es un rango de frecuencias; pulsa New frequency range para añadir uno. Las frecuencias fuera de todos los rangos están abiertas a todos.
| Ajuste | Qué cambia | Valores | Por defecto para un rango nuevo |
|---|---|---|---|
| Name | El nombre en la lista (por ejemplo "Police radio"). | 1 a 48 caracteres | |
| From frequency | La primera frecuencia, tal como la muestra la radio (1, 1.5...). | 0.01 a 1,000,000 | 1 |
| To frequency | La última frecuencia. No puede ser menor que la primera. | 0.01 a 1,000,000 | 10 |
| Jobs | Solo los miembros de estos trabajos pueden unirse. Deja trabajos y bandas vacíos para todos. | nombres de trabajo | police |
| Gangs | Los miembros de estas bandas también pueden unirse. | nombres de banda | vacío |
| Only on duty | Los miembros del trabajo deben estar de servicio en ese trabajo. | activado / desactivado | activado |
| Animation | La animación de radio en estas frecuencias: la de por defecto, ninguna o una concreta. | default / none / una concreta | default |
Comandos
| Comando | Argumentos | Quién | Qué hace |
|---|---|---|---|
/muteply | <id> [seconds] | administradores | Silencia la voz de un jugador, o quita el silencio a un jugador silenciado. seconds es 900 por defecto (15 minutos), como mucho un año. Se avisa al jugador. |
/voicedebug | ninguno | administradores | Imprime en la consola del servidor el alcance, las frecuencias y la llamada de cada jugador. |
Teclas
| Tecla por defecto | Qué hace | Nombre en los ajustes de GTA |
|---|---|---|
| F11 | Cambia el alcance de voz | Change voice range |
| Alt izquierdo | Habla en la frecuencia de radio activa mientras se mantiene | Talk on the radio |
Los valores por defecto vienen de las convars voice_defaultCycle y voice_defaultRadio cuando las configuras. Las dos se muestran en las ayudas de teclas del HUD ("Voice range", "Radio").
Funciona con otros scripts
- Sustituye a pma-voice (hace
providedepma-voice,mumble-voip,tokovoip,toko-voip,tokovoip_script): sus exports, state bags y eventos, así que los scripts de radio, teléfono y HUD escritos para pma-voice funcionan sin cambios. - tgiann-radio funciona. tgiann-radio-v2 y tgiann-phone funcionan sin sus archivos personalizados de pma-voice; ai-voice desactiva su propio efecto de radio o teléfono mientras funcionan.
- lb-phone necesita Let players' games join calls activado, y el efecto de teléfono de ai-voice desactivado si usas los efectos de llamada propios de lb-phone.
- ai-hud muestra el alcance, si hablas y la radio.
Límites conocidos
- Los comandos de jugador de pma-voice (
/vol,/setvoiceintent) no existen; los jugadores usan sus propias teclas y los ajustes del script de radio. - En Enhanced, un alcance de script desde el propio juego del jugador (
overrideProximityRange) se rechaza: allí los alcances los fijan los scripts de servidor. - Reiniciar ai-voice conserva el alcance, la frecuencia activa y la llamada de cada jugador, pero no las frecuencias extra que escuchaba ni los altavoces.
- Un cambio de Voice system se aplica en el siguiente inicio de ai-voice.