Pular para o conteúdo principal
O recurso de banimento de jogadores permite restringir o acesso ao jogo para determinados jogadores que violam as regras. Quando um banimento é aplicado a um jogador, todos os tokens de autenticação existentes do jogador são invalidados, e as tentativas futuras de autenticação feitas pelo jogador serão rejeitadas. Os banimentos de jogadores podem ser permanentes ou temporários, por um intervalo de tempo especificado, e podem ser aplicados a uma ID de jogador ou a um endereço IP. Um banimento tem escopo para um título e não se aplica a nenhum outro título do seu namespace.
Para novas integrações, recomendamos usar o sistema de banimento de IP dedicado em vez de especificar endereços IP nos banimentos de jogadores.
O tutorial a seguir mostra como utilizar o sistema de banimento, usando a API do PlayFab e o Game Manager.

Identificar

Embora o seu jogo possa ter um sistema personalizado para identificar trapaceiros e infratores, o PlayFab oferece um mecanismo de denúncia de jogador para jogador. Em essência, você conta com seus jogadores para denunciar outros jogadores problemáticos. Para permitir que o cliente denuncie um jogador específico, use o trecho a seguir no código do seu cliente.
Essa chamada de API produz:
  • Um evento de denúncia, que você pode localizar por meio da ferramenta Analytics (1).
  • Selecione o tipo de evento player_reported_as_abusive (2).
  • Isso mostra:
    • O nome do evento (3).
    • A ID do jogador (4) denunciado.
Game Manager - Analytics - Histórico de eventos

Aplicando banimentos

Depois que o jogador problemático for identificado, você poderá aplicar um banimento. Há duas maneiras de aplicar banimentos: manualmente pelo Game Manager ou programaticamente por meio de código.

Criando um banimento no Game Manager

Seu representante de gerenciamento da comunidade pode querer aplicar um banimento usando o Game Manager.
  1. Navegue até a seção Players.
  2. Localize e selecione o jogador problemático.
  3. Navegue até a guia Bans.
  4. Selecione Add Ban para exibir o formulário Add Ban.
  5. Digite o Reason do banimento e a duração desejada. Opcionalmente, você pode aplicar o Ban por um IP ADDRESS (4) específico.
  6. Por último, selecione o botão ADD BAN.
Game Manager - Jogadores - Adicionar banimento Se tudo estiver configurado corretamente, você verá um novo Ban na tabela. Opcionalmente, você pode remover um Ban manualmente selecionando-o no campo REVOKE BANS. Game Manager - Jogadores - Banimentos - Revogar banimento

Criando um banimento a partir de um servidor ou serviço

Como alternativa, você pode usar o Services SDK para aplicar um banimento por código usando o trecho fornecido abaixo.
Os banimentos aplicados por código também são exibidos na tabela de banimentos do jogador de destino no Game Manager.
Os métodos do SDK de servidor do PlayFab oferecem mais opções, como banimentos por endereço IP.
Cada banimento que você aplica recebe uma ID atribuída. Considere os seguintes métodos da API do SDK de servidor para um gerenciamento preciso dos banimentos:
Você pode usar funções do CloudScript como parte de um sistema automatizado que pode banir um jogador. Para saber mais sobre o CloudScript, consulte nosso tutorial Escrevendo um CloudScript personalizado.

Confira também

BanUsers
Última modificação em 8 de outubro de 2026