Logo da L&M SYSTEMDocumentação
Sistemas

Status Realtime

Como funciona o painel de status em tempo real do servidor MTA. Explica o que o mod envia, como o painel é atualizado, quando o servidor aparece como offline, a configuração e a diferença para o Status MTA.

O Status Realtime mantém no Discord um painel com o status do seu servidor MTA: o nome, se está online, os jogadores conectados e o endereço para entrar. Os dados são enviados pelo próprio servidor, pelo mod Status Realtime. É exclusivo do MTA Avançado.

A instalação do mod e a API Key (contexto Status Realtime) estão em Integração MTA.

Status Realtime ou Status MTA?

O plano MTA tem o Status MTA, que não usa mod. A diferença está em quem envia os dados:

Status MTAStatus Realtime
De onde vêm os dadosO bot consulta as informações públicas do servidor, pelo IP e pela porta, como a lista de servidores do MTAO próprio servidor envia, pelo mod
Precisa de modNãoSim
AtualizaçãoA cada 2 minutosA cada 1 minuto e meio
Servidor com a consulta pública bloqueadaNão consegue ler os dadosFunciona normalmente

Se a consulta pública do seu servidor funciona, o Status MTA já resolve. O Status Realtime é para quando você quer os dados direto do servidor, sem depender dessa consulta.

Como funciona

  1. Ao iniciar, e depois a cada 1 minuto e meio, o mod envia o nome do servidor, a quantidade de jogadores e o limite de jogadores, com o status Online.
  2. O bot edita o painel publicado no Discord com esses dados.
  3. Se o servidor ficar 10 minutos sem enviar nada (desligado, sem internet ou com o mod parado), o bot marca o painel como Offline. Essa conferência acontece a cada 2 minutos, então o Offline aparece entre 10 e 12 minutos depois da última atualização.

Quando o servidor volta, a próxima atualização do mod coloca o painel em Online de novo.

O config.lua do mod tem só a apiKey e o devMode. O nome mostrado é o nome do servidor no MTA (o servername do mtaserver.conf).

Configuração

Em /config-bot → MTA Avançado → Status Realtime:

OpçãoO que você configura
IP do ServidorO IP e a porta mostrados no painel, no campo Conectar-se (mtasa://IP:porta)
ImagensA imagem ao lado e a imagem de baixo do painel
Redes SociaisOs links do site, YouTube, Instagram e TikTok, que viram botões no painel. Só aparecem os que você preencher
Aparência do PainelO modo do painel: Clássico (padrão) ou Components V2 (novo)
Enviar PainelO canal onde o painel é publicado

A tela também tem os botões Tutorial e Baixar Mod.

Configure o IP

Sem o IP, o painel não pode ser enviado: o bot responde "Nenhuma configuração encontrada".

Ajuste o visual

Configure as imagens, as redes sociais e a aparência.

Envie o painel

Em Enviar Painel, escolha o canal. O painel começa com o status Offline e os dados zerados, e é preenchido na próxima atualização do mod (em até 1 minuto e meio).

O que o painel mostra

  • Servidor na Lista: o nome do servidor no MTA;
  • Status: Online ou Offline;
  • Players Online: os jogadores conectados e o limite, por exemplo 48/200;
  • Conectar-se: o endereço mtasa:// com o IP configurado;
  • os botões das redes sociais.

Aparência

Os dois modos mostram as mesmas informações. O Clássico usa o formato de embed, e o Components V2 usa o formato mais novo de mensagens do Discord.

Ao alternar com um painel já publicado, o bot envia um painel novo no mesmo canal, no modo escolhido, e apaga o antigo. Isso acontece porque o Discord não deixa converter uma mensagem de um formato para o outro.

Um painel por servidor

O bot atualiza um painel por servidor do Discord: o último enviado. Se você enviar o painel de novo em outro canal, o novo passa a ser atualizado e o antigo fica parado, então apague o antigo.

Se a mensagem do painel for apagada, o bot para de tentar atualizá-la. É só enviar o painel de novo.

Problemas comuns