GameVox para FiveM

Voz por proximidade com áudio espacial 3D para o seu servidor de RP no FiveM. Os jogadores se ouvem de acordo com a distância e a direção. Sem TeamSpeak e sem plugin do SaltyChat.

Como funciona

O GameLink do GameVox conecta o seu servidor de FiveM ao chat de voz do GameVox

Voz por proximidade

Os jogadores ouvem as vozes próximas, que vão sumindo com a distância. O alcance da voz é ajustável, do sussurro (3m) ao grito (15m) e ao megafone (32m).

Áudio espacial 3D

Ouça os jogadores em estéreo de acordo com a direção em que estão em relação a você. As vozes vêm da esquerda, da direita ou do centro, dependendo de onde eles estão.

Substituto direto

Substitui o SaltyChat sem dor de cabeça. Instale o resource, avise os jogadores para usarem o GameVox e pronto. Sem precisar de TeamSpeak.

Requisitos

✓
Servidor de FiveM com OneSync

O OneSync precisa estar ativado para sincronizar a posição dos jogadores. Adicione set onesync on ao seu server.cfg. Se você usa o txAdmin, confira se ele não está sobrescrevendo essa configuração.

✓
App do GameVox para desktop

Cada jogador precisa ter o app do GameVox para desktop instalado. Baixe aqui.

✓
Canal de voz do GameVox

Os jogadores precisam estar no mesmo canal de voz do GameVox enquanto jogam no servidor de FiveM.

Configurar o servidor

Instale o resource do GameVox no seu servidor de FiveM em 3 passos

1

Baixe o resource

Baixe o resource gamevox e extraia na pasta resources/ do seu servidor.

2

Atualize o server.cfg

Adicione estas linhas ao seu server.cfg:

# Enable OneSync (required for GameVox proximity voice)
set onesync on

# Start the GameVox resource
ensure gamevox
3

Reinicie o servidor

Reinicie o seu servidor de FiveM. Você deve ver [Gamevox] Server started. OneSync is enabled. no console do servidor. Se aparecer um erro de OneSync, revise o seu server.cfg.

Configurar o jogador

Começar como jogador leva uns 30 segundos

1

Instale o GameVox

Baixe e instale o app do GameVox para desktop.

2

Entre em um canal de voz

Abra o GameVox e entre no mesmo canal de voz que os seus amigos do FiveM.

3

Abra o FiveM

Abra o FiveM e entre no servidor. O GameVox detecta o FiveM automaticamente e ativa a voz por proximidade. Você vai ouvir os jogadores próximos mais altos ou mais baixos conforme se movimenta.

4

Alterne o alcance da voz

Aperte F1 para alternar entre os alcances de voz:

3m Sussurro8m Normal15m Grito32m Megafone

A tecla pode ser alterada em Configurações do FiveM > Atalhos de teclado > GameVox.

5

Megafone

Segure B para ativar o megafone, que aumenta o alcance da sua voz para 100m. Solte para voltar ao alcance normal. Útil para anúncios ou cenas de RP.

A tecla pode ser alterada em Configurações do FiveM > Atalhos de teclado > GameVox.

Configuração

Personalize os alcances de voz, as teclas e os intervalos de atualização no config.lua

Config = {}

-- Voice ranges in meters (players cycle through these with F1)
Config.VoiceRanges = { 3.0, 8.0, 15.0, 32.0 }

-- Default voice range (1-based index, 2 = 8m normal)
Config.DefaultVoiceRangeIndex = 2

-- Keybind to cycle voice range (rebindable in FiveM settings)
Config.VoiceRangeKey = "F1"

-- Position update interval in milliseconds (280ms = SaltyChat standard)
Config.UpdateInterval = 280

-- Show voice range notification when cycling
Config.ShowVoiceRangeNotification = true

-- Megaphone: hold-to-use keybind that extends voice range
Config.MegaphoneRange = 100.0
Config.MegaphoneKey = "B"

API para desenvolvedores

Integre com o seu sistema de morte, nomes personalizados e muito mais

SetPlayerAlive

Controla se um jogador pode ser ouvido (para scripts de morte e respawn).

-- In your death script:
exports['gamevox']:SetPlayerAlive(playerId, false)

-- In your respawn script:
exports['gamevox']:SetPlayerAlive(playerId, true)

SetPlayerGameName

Define um nome de jogo personalizado para um jogador (para sistemas de nome de personagem).

-- Set a custom name for voice identification
exports['gamevox']:SetPlayerGameName(playerId, "John_Doe")

Overlay de jogo

Veja quem está falando sem sair do jogo

Modos do overlay

O overlay do GameVox mostra os participantes do canal de voz por cima do jogo. Com 5 participantes ou menos, ele mostra todo mundo com avatar, nome e indicador de fala.

Com 6+ participantes, o overlay passa para o modo só de quem está falando:

  • Falando texto verde com um ícone de onda sonora
  • Falou há pouco texto branco, visível por 3 segundos
  • Em silêncio removido depois de 3 segundos
  • Quando ninguém está falando, mostra "X usuários na voz"

O overlay muda de tamanho automaticamente conforme quem está falando. Posição, tamanho, opacidade e o limite do modo de fala podem ser ajustados em Configurações do GameVox > Overlay de jogo.

Pronto para ter voz por proximidade?

Baixe o resource, instale no seu servidor e pronto, já está no ar