Plugin Minecraft EssentialsGeoIP

🔌 Sobre o EssentialsX GeoIP

O EssentialsX GeoIP é um módulo da suíte de plugins EssentialsX que faz consultas GeoIP locais usando o banco de dados MaxMind GeoLite2. Ele se integra ao EssentialsX para exibir uma localização aproximada dos jogadores (por exemplo, em /whois e, opcionalmente, para a equipe quando um jogador entra).

🎯 Objetivo

O módulo fornece à equipe do servidor informações geográficas aproximadas derivadas dos IPs dos jogadores para ajudar na moderação, no registro e na noção básica de localização. As consultas são feitas localmente usando o banco de dados GeoLite2, em vez de consultar serviços de terceiros a cada solicitação.

⚙️ Recursos

• Usa o banco de dados MaxMind GeoLite2 para consultas de IP para localização.
• Integra-se à saída do /whois do EssentialsX para mostrar a localização aproximada.
• Opcional: exibe a localização aproximada de um jogador para a equipe quando ele entra.
• Atualizações automáticas do banco de dados: o módulo baixa e atualiza o banco de dados GeoLite2 em uma programação regular (configurado para atualizar a cada 30 dias por padrão).
• Nós de permissão para controlar quem pode ver ou ocultar os resultados do GeoIP.

🧩 Para quem é

Este módulo é voltado para administradores de servidor e equipes de moderação que usam EssentialsX e querem dados geográficos aproximados para fins de moderação ou registro em servidores Bukkit/Spigot/Paper.

🏗️ Exemplos de uso

• Mostrar à equipe um país ou cidade aproximados ao inspecionar um jogador com /whois.
• Registrar regiões de origem aproximadas de conexões suspeitas para ajudar na moderação.
• Ocultar a exibição de localização para jogadores que optaram por não participar por meio de permissão.

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Instale o plugin principal EssentialsX (o módulo GeoIP requer o módulo principal correspondente do EssentialsX).
• Baixe o JAR do módulo EssentialsX GeoIP e coloque-o no diretório plugins/ do seu servidor.
• Inicie o servidor uma vez para gerar o arquivo plugins/EssentialsGeoIP/config.yml.
• Cadastre-se para ter acesso ao banco de dados GeoLite2 da MaxMind, gere uma chave de licença e adicione essa chave à configuração license-key em plugins/EssentialsGeoIP/config.yml.
• Reinicie o servidor. O módulo baixará o banco de dados GeoLite2 usando a chave fornecida e o manterá atualizado automaticamente.

📦 Dependências

• EssentialsX (módulo principal) — é necessária uma versão correspondente do plugin principal EssentialsX.

🧠 Notas técnicas

• O módulo exige concordar e cumprir o EULA da MaxMind GeoLite2; o banco de dados é aproximado e não deve ser usado para determinar a localização exata dos jogadores.
• O comportamento de download/atualização do banco de dados faz parte do módulo e está configurado para atualizar mensalmente; você precisa fornecer uma chave de licença MaxMind válida para atualizações automáticas.
• Mostra dados apenas onde o núcleo do EssentialsX expõe /whois ou notificações de entrada; o próprio módulo não substitui a funcionalidade do EssentialsX.

🤝 Quando este plugin é útil

Se você usa o EssentialsX e precisa de consultas leves e locais de localização aproximada para moderação ou registro (enquanto cumpre os termos de licença da MaxMind), o EssentialsX GeoIP oferece uma solução GeoLite2 integrada e com atualização automática.