Logo da L&M SYSTEMDocumentação
Sistemas

Player

Como banir, desbanir e kickar jogadores do servidor MTA direto pelo Discord com o /player. Explica a ficha do jogador, a fila de ações do mod Game Action, os prazos, os logs e o cadastro de players no dashboard.

O Player reúne no Discord a ficha de cada jogador do seu servidor MTA e as ações de moderação dentro do jogo: banir, desbanir e kickar. A equipe faz tudo pelo /player, sem precisar entrar no servidor. É exclusivo do MTA Avançado.

As ações são aplicadas no jogo pelo mod Game Action, o mesmo usado pela denúncia avançada. A instalação do mod e a API Key estão em Integração MTA.

Configuração

Em /config-bot → MTA Avançado → Player:

OpçãoO que é
Canal de LogOnde fica registrada cada ação, com o resultado
Cargos com PermissãoOs cargos que podem usar o /player e as ações

A tela também tem os botões Tutorial e Baixar Mod. Enquanto o canal de log e os cargos não estiverem configurados, o /player responde "Nenhuma configuração do sistema encontrada".

Além dos cargos com permissão, os administradores do servidor sempre podem usar o /player. Quem não tem nenhum dos dois recebe "Você não possui permissão para executar essa ação."

O cadastro de players

O /player só encontra jogadores que estão no cadastro de players da L&M System. Esse cadastro é preenchido pelos sistemas de Allowlist e Whitelist: quando um jogador é liberado, ele entra no cadastro com o ID do jogo, o serial (quando o tipo de identificação fornece), o nome do personagem e o Discord de quem fez o cadastro. Com o mod de Métricas instalado, quem entra no servidor também é registrado no cadastro, pelo serial, ainda sem Discord vinculado.

Jogadores de uma whitelist ou allowlist que ainda usa o MySQL do seu servidor não entram no cadastro. Para isso é preciso migrar para a L&M Cloud.

No Dashboard, em Sistemas → MTA → Players, você vê o cadastro inteiro (nome, Game ID, serial, Discord e data), pode vincular o Discord de um jogador que ainda não tem e pode excluir jogadores.

Usando o /player

Encontre o jogador

Use /player com uma das opções:

  • usuario: o membro do Discord vinculado ao jogador;
  • busca: o ID do jogo ou o serial, para jogadores sem Discord vinculado. O bot procura primeiro pelo ID e depois pelo serial.

Sem nenhuma das duas, o bot pede uma delas. Se o jogador não estiver no cadastro, a resposta é "Player não encontrado. Ele precisa estar cadastrado (allowlist) antes de ser gerenciado por aqui."

Confira a ficha

A ficha mostra o nome do personagem, o Discord vinculado, o ID do jogo e o serial (ou Não vinculado, quando o dado não existe), com a foto do membro.

Escolha a ação

AçãoO que faz no jogoO que é pedido
BanirBane o serial do jogadorMotivo e duração em minutos
DesbanirRemove os banimentos daquele serialMotivo
KickarExpulsa o jogador do servidorMotivo

Na duração do ban, 0 deixa o banimento permanente. Para referência: 60 minutos é 1 hora, 1440 é 1 dia e 10080 é 1 semana.

Aguarde o resultado

A mensagem mostra que a ação foi para a fila e se atualiza sozinha quando o servidor responde: efetuado com sucesso, falhou ou não foi processado dentro do tempo limite. Os detalhes vão para o canal de log.

Como a ação chega ao jogo

O bot não entra no servidor MTA. Ele coloca a ação numa fila, e o mod Game Action, rodando no seu servidor, busca e executa:

  1. A ação entra na fila da L&M System.
  2. Se o webhook está funcionando, o servidor é avisado na hora e executa em segundos. Sem ele, o mod busca a fila a cada 2 minutos.
  3. O mod encontra o jogador e aplica a ação.
  4. O mod informa o resultado (concluída ou falhou, com o motivo), e a mensagem do /player e o log se atualizam.

Se o servidor não confirmar em 3 minutos e meio, a ação é encerrada como tempo esgotado e deixa de ser entregue ao servidor. Isso acontece quando o servidor está desligado, sem o mod ou com o mod inativo. Nesse caso, é só repetir a ação depois de resolver o problema. Se o servidor pegou a ação bem no limite do prazo, ela pode ter sido aplicada mesmo assim: confira no jogo antes de repetir.

Online ou offline

O mod procura o jogador entre quem está online, primeiro pelo serial e depois pelo ID do jogo (pela element data elementDataID).

AçãoJogador onlineJogador offline
BanirBane e expulsa na horaBane o serial, se ele for conhecido
Desbanir(um jogador banido não está online)Funciona, se o serial for conhecido
KickarFuncionaFalha: não há quem expulsar

O serial é conhecido quando aparece na ficha do /player, o que acontece, por exemplo, com quem foi cadastrado pelo tipo Serial ou Código. Se a ficha mostra o serial como Não vinculado (comum em quem foi cadastrado só pelo ID), o jogador precisa estar online para ser banido, para o mod pegar o serial na hora. Sem o serial no cadastro, o desban pelo /player não funciona: remova o ban pelo console ou pelo painel admin do MTA.

Os bans do Game Action são bans normais do MTA, por serial, com o responsável GameAction e o motivo informado. Eles aparecem na lista de bans do servidor e podem ser removidos também pelo console ou pelo painel admin do MTA. Se o seu servidor usa um sistema de ban próprio, dá para trocar isso: veja Game Action: usar o seu sistema de ban.

Permissão para banir e kickar

O MTA só deixa um resource banir, desbanir e kickar se ele tiver permissão no acl.xml. Adicione resource.GameAction ao grupo Admin (veja Coloque cada mod no grupo Admin). Sem isso, as ações falham com "Falha ao efetuar o banimento" ou "Falha ao expulsar o player", e o console mostra "Access denied".

Logs

Cada ação gera um registro no canal de log com:

  • o responsável (quem usou o /player);
  • a ação e o jogador (nome, ID e serial);
  • a duração, no ban (Permanentemente ou em minutos);
  • o motivo;
  • o motivo da falha, se ela falhou, ou o aviso de que o tempo de espera expirou.

O registro é enviado mesmo se o bot reiniciar enquanto a ação está na fila.

Mensagens de falha

Motivo da falhaO que significa
Player não encontrado no servidorNo kick: o jogador não está online. No ban e no desban: não há serial conhecido e o jogador não está online
Falha ao efetuar o banimentoO MTA recusou o ban. Confira a permissão do acl.xml
Nenhum banimento foi encontrado para desbanir esse playerEsse serial não tem ban no servidor
Falha ao expulsar o playerO MTA recusou o kick. Confira a permissão do acl.xml
Não foi processado dentro do tempo limiteO servidor não respondeu em 3 minutos e meio. Veja Problemas comuns

Problemas comuns