Pular para o conteúdo principal
A XBOX Multiplayer Analysis Tool (XMAT) captura, inspeciona e modifica o tráfego de rede de consoles de desenvolvimento XBOX e PCs com Windows. Baixe a versão mais recente do XMAT. O XMAT pode:
  • Fazer proxy de tráfego HTTP e HTTPS.
  • Descriptografar e exibir dados de solicitações e respostas.
  • Filtrar o tráfego capturado por host, código de status e método.
  • Executar scripts C# que modificam ou encerram solicitações e respostas.
  • Capturar e analisar o tráfego de rede de baixo nível de um console de desenvolvimento XBOX.
  • Analisar capturas ao vivo ou salvas em busca de padrões problemáticos de chamadas aos serviços XBOX.

Requisitos

O XMAT requer:
  • Um PC de desenvolvimento executando o Windows 10, versão 1809 (build 17763) ou posterior, ou o Windows 11.
  • Permissões de administrador no PC de desenvolvimento.
  • O .NET 10 Desktop Runtime e o ASP.NET Core Runtime para Windows x64, ou o .NET 10 SDK para Windows x64.
  • Para captura no console, um console de desenvolvimento XBOX executando a recovery 2106 ou posterior.
  • GDK Extensions for XBOX para os recursos do XMAT que se conectam a um console de desenvolvimento XBOX.

Instalar o XMAT

  1. Baixe o arquivo ZIP atual em versões do XMAT.
  2. Extraia o arquivo ZIP para uma pasta local.
  3. Execute o XMAT como administrador.
  4. Quando solicitado, instale o certificado raiz do XMAT e confie nele. O XMAT usa esse certificado para descriptografar o tráfego HTTPS.

Capturar tráfego da web

  1. No XMAT, selecione a guia +.
  2. Selecione o dispositivo que executa o título:
    • Para o console de desenvolvimento XBOX padrão, selecione Default XBOX Console.
    • Para outro console de desenvolvimento XBOX, selecione XBOX Console at IP or Hostname.
    • Para um título no PC de desenvolvimento, selecione Local PC.
  3. Selecione Web Proxy e, em seguida, selecione Add Capture.
  4. Inicie o proxy:
    • Para um console de desenvolvimento XBOX, selecione Enable XBOX Proxy. O console é reiniciado e começa a enviar o tráfego da web pelo XMAT.
    • Para um PC com Windows, selecione Start Capture.
  5. Inicie o título e execute os cenários que você deseja inspecionar.
  6. Selecione uma conexão para inspecionar os cabeçalhos e o corpo da solicitação e da resposta.
Use os filtros Host, Status e Method para isolar o tráfego relevante. Selecione Save Captures no menu File para salvar a captura como um arquivo XMATCAP.
[!IMPORTANT] Se um console de desenvolvimento XBOX permanecer configurado para usar o proxy do XMAT quando o XMAT não estiver capturando, as verificações dos serviços XBOX e outras solicitações de rede podem falhar. Selecione Disable XBOX Proxy quando os testes forem concluídos. O console é reiniciado para aplicar a alteração.

Identificar os hosts de serviços de parceiros

Antes de simular uma interrupção de serviço, capture o tráfego normal do título:
  1. Inicie uma captura de proxy da web no XMAT.
  2. Inicie o título e execute todos os recursos que usam um serviço online, incluindo:
    • Menus e leaderboards.
    • Criação e entrada em sessões multijogador.
    • Amigos e recursos sociais.
    • Lojas no título.
    • Eventos por tempo limitado.
  3. Use o filtro Host para revisar todos os hosts com os quais o título se comunica.
  4. Compare os hosts capturados com o inventário de serviços do título e identifique os serviços hospedados por parceiros a serem testados.
Não bloqueie hosts de serviços da Microsoft, do XBOX ou do PlayFab ao testar a conectividade de serviços de parceiros. Confirme a propriedade de cada host em vez de se basear apenas em uma substring em seu nome.

Bloquear um serviço de parceiro

Os scripts do XMAT podem encerrar solicitações para hosts selecionados enquanto mantêm o restante do tráfego disponível.
  1. Abra o Script Editor na captura de proxy da web ativa.
  2. Selecione o evento SSL Connection Request.
  3. Substitua o host de exemplo por cada host de serviço de parceiro que você deseja bloquear. Por exemplo:
  4. Selecione Enable. Verifique se o script é compilado com êxito.
  5. Execute o recurso afetado do título e verifique se as solicitações para os hosts selecionados falham enquanto os serviços da Microsoft, do XBOX e do PlayFab permanecem disponíveis.
O evento SSL Connection Request bloqueia conexões HTTPS. Se o serviço do parceiro usar HTTP não criptografado, aplique a mesma condição de host ao evento Web Request e defina Params.Continue como false. Para simular um serviço que fica indisponível antes de o título iniciar, ative o script de bloqueio antes de iniciar o título.
[!CAUTION] Os scripts do XMAT afetam o tráfego ao vivo do dispositivo selecionado. Limite um script de bloqueio aos hosts de parceiros específicos necessários para o teste e desative o script quando o teste for concluído.

Parar a captura

  1. Desative todos os scripts ativos.
  2. Selecione Stop Capture.
  3. Se um console de desenvolvimento XBOX estiver usando o proxy, selecione Disable XBOX Proxy e aguarde a reinicialização do console.
Para problemas conhecidos e opções de suporte, veja a documentação do projeto XMAT e a política de suporte do XMAT.
Última modificação em 20 de outubro de 2026