Sobre o projeto

Minecraft Stress Tester é uma ferramenta de teste de carga de código aberto para servidores Minecraft. Em vez de meramente abrir sockets, ele conecta um enxame de bots e mede o efeito dessa carga no servidor, reportando TPS estimado, um funil de conexão, latência, throughput e motivos de kick. Ele é projetado para escalar para milhares de bots em múltiplos processos e para funcionar contra servidores reais. A segurança está incorporada ao fluxo de trabalho: o projeto se descreve como um gerador de carga e afirma que deve ser executado apenas contra servidores que você possui ou para os quais tem permissão escrita explícita para testar. A ferramenta se recusa a iniciar até que o operador afirme a autorização, e um documento SECURITY.md cobre o uso responsável. As opções de distribuição e início rápido incluem executar via npx sob o nome de pacote publicado minecraft-stress-tester (binário mcst), clonar o repositório e instalar com npm, ou executar a interface web em um contêiner de ghcr.io. Um arquivo de configuração de exemplo é fornecido em examples/local.yaml. O conjunto de comandos cobre vários modos: um teste de carga padrão, um painel de controle web (gui), uma API de plano de controle com REST e métricas ao vivo (serve), um console interativo de bot único (debug), uma varredura de segurança defensiva para servidores que você possui (scan), e bots programáveis via blueprints (script). A documentação é organizada em páginas de instalação e distribuição, uso e CLI, métricas, arquitetura, roteiro, painel de controle web, API de plano de controle, API de depuração e bot, bots programáveis, pipeline de comportamento e varredura de segurança, juntamente com orientações de contribuição e segurança. O projeto é licenciado sob MIT, requer Node.js 24 ou mais recente, e anuncia CI com um selo de cobertura de pelo menos 95 por cento.