Plugin Minecraft EssentialsGeoIP

🔌 Sobre o EssentialsX GeoIP

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

🎯 Objetivo

O módulo fornece à equipa do servidor informação geográfica aproximada derivada dos IPs dos jogadores para ajudar na moderação, registo e no conhecimento básico da localização. As consultas são feitas localmente usando a base de dados GeoLite2, em vez de consultar serviços de terceiros para cada pedido.

⚙️ Funcionalidades

• Usa a base de dados MaxMind GeoLite2 para consultas de IP para localização.
• Integra-se com a saída de /whois do EssentialsX para mostrar a localização aproximada.
• Opcional: mostra a localização aproximada de um jogador à equipa quando ele entra.
• Atualizações automáticas da base de dados: o módulo descarrega e atualiza a base de dados GeoLite2 regularmente (por predefinição, configurado para atualizar a cada 30 dias).
• Nós de permissão para controlar quem pode ver ou ocultar os resultados do GeoIP.

🧩 Para quem é

Este módulo destina-se a administradores de servidores e equipas de moderação que usam EssentialsX e querem dados geográficos aproximados para fins de moderação ou registo em servidores Bukkit/Spigot/Paper.

🏗️ Casos de uso de exemplo

• Mostrar à equipa um país ou cidade aproximados ao inspecionar um jogador com /whois.
• Registar regiões de origem aproximadas de ligações suspeitas para ajudar na moderação.
• Ocultar a exibição da localização para jogadores que optaram por não participar através 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).
• Descarregue 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 ficheiro plugins/EssentialsGeoIP/config.yml.
• Registe-se para obter acesso à base de dados GeoLite2 da MaxMind, gere uma chave de licença e adicione essa chave à definição license-key em plugins/EssentialsGeoIP/config.yml.
• Reinicie o servidor. O módulo descarregará a base de dados GeoLite2 usando a chave fornecida e mantê-la-á atualizada automaticamente.

📦 Dependências

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

🧠 Notas técnicas

• O módulo requer aceitar e cumprir o EULA da MaxMind GeoLite2; a base de dados é aproximada e não deve ser usada para determinar localizações precisas dos jogadores.
• O comportamento de descarregamento/atualização da base de dados faz parte do módulo e está configurado para atualizar mensalmente; é necessário 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 módulo em si não substitui a funcionalidade do EssentialsX.

🤝 Quando este plugin é útil

Se executa o EssentialsX e precisa de pesquisas leves e locais de localização aproximada para moderação ou registo (cumprindo os termos de licença da MaxMind), o EssentialsX GeoIP fornece uma solução GeoLite2 integrada e com atualização automática.