Plugin Minecraft GrimAC

🔌 Sobre o GrimAC

GrimAC é um plugin anti-cheat de código aberto para Minecraft que implementa um motor preditivo de simulação de movimento e verificações assíncronas e multithread para detectar cheats do lado do cliente. O projeto executa muitas verificações em threads de rede, replica o movimento do jogador com precisão e inclui compensação de lag para reduzir falsos positivos. Os lançamentos oficiais fornecem builds para ambientes de servidor da Java Edition.

🎯 Objetivo

O objetivo principal do GrimAC é detectar e mitigar trapaças relacionadas a movimento, timing, alcance e outros exploits do lado do cliente, reproduzindo possíveis estados do jogador no servidor e comparando-os com o comportamento relatado pelo cliente. Ele foi feito para administradores de servidor que precisam de detecção automática e punições configuráveis para manter a jogabilidade justa.

⚙️ Recursos

• Simulação preditiva de movimento 1:1 cobrindo caminhada, natação, knockback, teias, colunas de bolhas e montaria em entidades.
• Processamento assíncrono de movimento e verificações multithread para reduzir a carga na thread principal.
• Compensação de lag nas interações dos jogadores para minimizar falsos positivos.
• Tratamento de isenções para certos cenários de proxy ou bridge (por exemplo, tratamento explícito de jogadores Geyser para evitar falsos positivos).
• API de plugin para desenvolvedores, para integrações e extensões.
• Projeto de código aberto com artefatos de build e instruções para compilar a partir do código-fonte.

🧩 Para quem é

• Donos e administradores de servidor que rodam servidores Java Edition e querem um anti-cheat de código aberto.
• Servidores survival/SMP e anarchy, públicos ou privados, que precisam de controle de movimento e combate.
• Desenvolvedores e autores de plugins que querem integrar verificações anti-cheat usando a API fornecida.

🏗️ Exemplos de uso

• Garantir PvP justo em um servidor survival detectando alcance estendido e velocidade incomum.
• Impedir exploits de fly, step ou glide em servidores públicos, compensando o lag dos jogadores.
• Integrar as detecções do GrimAC em ferramentas de moderação usando a API do plugin.

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin para a build do seu servidor.
• Coloque o JAR no diretório plugins/ do servidor.
• Certifique-se de que o servidor esteja executando Java 17 ou superior e reinicie o servidor.
• Verifique o console/logs do servidor para confirmar se o GrimAC foi carregado corretamente.

📦 Dependências

• Se você usa Geyser, instale Floodgate no backend onde o GrimAC roda para que ele possa acessar a Floodgate API.
• Se você usa ViaVersion, instale ViaVersion apenas no servidor backend; o GrimAC não oferece suporte a ViaVersion instalado somente no proxy.

🛠 Compilando a partir do código-fonte

• O repositório inclui instruções de build; os passos oficiais são: git clone https://github.com/GrimAnticheat/Grim.git, cd Grim, ./gradlew build. Os jars compilados aparecem nas pastas <platform>/build/libs.

🧠 Notas técnicas

• O projeto distribui seu código-fonte e usa uma licença da família GPL.
• Os requisitos oficiais incluem Java 17 ou superior e um ambiente de servidor compatível (exemplos: Spigot, Paper, Folia, Fabric).
• O projeto fornece artefatos noturnos e uma API para desenvolvedores para integrações com plugins.
• Os mantenedores documentam que algumas builds e plataformas são recomendadas pelos seus canais de lançamento; consulte a documentação do projeto para encontrar o artefato correto para o seu ambiente.

🤝 Quando este plugin é útil

Se você precisa de um anti-cheat configurável e de código aberto, focado em simulação precisa de movimento e verificações assíncronas, o GrimAC oferece uma API voltada para desenvolvedores, builds para vários ambientes e tratamento explícito para cenários comuns de proxy/bridge, sendo adequado para servidores que exigem detecção precisa enquanto buscam reduzir falsos positivos.