Manual do MM Radio

Introdução

O MM Radio é um sistema de comunicação por rádio moderno para FiveM com UI elegante, efeitos de submix para áudio realista, canais configuráveis com restrições de job/gang, sistema de bateria, jammers e overlay de jogadores.

Funcionalidades Principais

  • UI de rádio moderna e redimensionável
  • Efeitos de submix para áudio realista de rádio
  • Restrições de canais por job/gang
  • Sistema de bateria configurável
  • Overlay mostrando jogadores no rádio
  • Sistema de jammer (bloqueio de sinal)
  • Nomes de exibição de canais personalizáveis
  • Otimizado: 0.00ms resmon
  • Integração com pma-voice e bl_bridge

Frameworks Suportados

FrameworkStatus
QBCoreCompleto
ESXCompleto
QBoxCompleto
ND CoreCompleto
StandaloneCompleto (apenas lista de jobs)

Dependências

DependênciaObrigatórioNotas
ox_libSimBiblioteca utilitária
pma-voiceSimSistema de voz
bl_bridgeSimBridge de framework
OneSyncSimDeve estar habilitado

Configuração (shared/config.lua)

Config = {
    EnableSubmix = true,
    EnableBattery = false,
    DefaultChannel = 1,
    EnableOverlay = true,
    OverlayPosition = {x = 0.5, y = 0.95},
    OverlaySize = 1.0,
    EnableJammers = true,
    DefaultJammerRange = 50.0,
    AllowedFrequencies = {1, 2, 3},
    RestrictedChannels = {
        [1] = {jobs = {'police', 'sheriff'}},
        [2] = {gangs = {'ballas', 'families'}}
    }
}

Comandos

ComandoDescriçãoPermissão
/radio [channel]Entrar no canalTodos
/jammerColocar/remover jammerJob configurado
/setchannelname [channel] [name]Definir nome do canalAdmin

Keybinds

  • Tecla padrão: LMENU (Left Alt) para falar no rádio quando conectado
  • Configure em Esc > Settings > Keybinds > FiveM

Eventos

Cliente

EventoParâmetrosDescrição
mm_radio:client:JoinRadiochannel (int)Entrar no canal
mm_radio:client:LeaveRadioSair do canal
mm_radio:client:UpdateOverlayplayers (table)Atualizar overlay

Servidor

EventoParâmetrosDescrição
mm_radio:server:JoinRadiosource, channelJogador entrou no rádio
mm_radio:server:PlaceJammersource, coordsJammer colocado
mm_radio:server:RemoveJammersource, jammerIdJammer removido

Exports

Cliente

ExportDescriçãoParâmetros
JoinRadioEntrar no canalchannel (number)
LeaveRadioSair do canal atualNenhum
SetRadioEnabledHabilitar/desabilitar rádioenabled (boolean)
SetChannelNameDefinir nome do canalchannel (int), name (string)

Servidor

ExportDescriçãoParâmetros
AddPlayerToRadioAdicionar ao canalsource (int), channel (int)
RemovePlayerFromRadioRemover do canalsource (int)
GetPlayersInChannelObter jogadores no canalchannel (int)
AddJammerAdicionar jammercoords (vector3), range (float)
RemoveJammerRemover jammerjammerId (int)

Solução de Problemas

  • Rádio não conecta: Verifique se o pma-voice e bl_bridge estão iniciados antes do mm_radio.
  • Submix não funciona: Confira se o EnableSubmix está habilitado em config.lua.
  • Jammers não funcionam: Certifique-se de que o EnableJammers está habilitado e o jogador tem permissão.