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ção | O que é |
|---|---|
| Canal de Log | Onde fica registrada cada ação, com o resultado |
| Cargos com Permissão | Os 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ção | O que faz no jogo | O que é pedido |
|---|---|---|
| Banir | Bane o serial do jogador | Motivo e duração em minutos |
| Desbanir | Remove os banimentos daquele serial | Motivo |
| Kickar | Expulsa o jogador do servidor | Motivo |
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:
- A ação entra na fila da L&M System.
- 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.
- O mod encontra o jogador e aplica a ação.
- O mod informa o resultado (concluída ou falhou, com o motivo), e a mensagem do
/playere 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ção | Jogador online | Jogador offline |
|---|---|---|
| Banir | Bane e expulsa na hora | Bane o serial, se ele for conhecido |
| Desbanir | (um jogador banido não está online) | Funciona, se o serial for conhecido |
| Kickar | Funciona | Falha: 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 falha | O que significa |
|---|---|
| Player não encontrado no servidor | No 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 banimento | O MTA recusou o ban. Confira a permissão do acl.xml |
| Nenhum banimento foi encontrado para desbanir esse player | Esse serial não tem ban no servidor |
| Falha ao expulsar o player | O MTA recusou o kick. Confira a permissão do acl.xml |
| Não foi processado dentro do tempo limite | O servidor não respondeu em 3 minutos e meio. Veja Problemas comuns |
Problemas comuns
Allowlist e Whitelist
Como liberar a entrada dos jogadores no servidor MTA pelo Discord. Explica a whitelist automática, a whitelist semi-automática e a allowlist avançado, a tela de cadastro no jogo, os tipos de identificação e como gerenciar a lista.
Denúncia avançada
Como funciona a denúncia avançada, que liga o atendimento de denúncias ao banimento dentro do jogo. Explica a configuração, a abertura, a decisão da equipe, a confirmação do ban, a revisão e o que o bot desfaz.
