Plugin Minecraft EssentialsGeoIP

🔌 Sobre o EssentialsGeoIP

EssentialsGeoIP — é um plugin para servidores Minecraft que integra consultas GeoIP ao EssentialsX. O EssentialsGeoIP permite que a equipa de administração veja a localização geográfica aproximada dos jogadores (nível país/região/cidade conforme o GeoLite2).

🎯 Objetivo

O EssentialsGeoIP visa fornecer contexto geográfico aproximado para moderação, diagnóstico e informação básica regional. Não fornece localização precisa; destina‑se apenas a mostrar dados aproximados derivados de IP.

⚙ Principais funcionalidades

• Integra consultas GeoIP ao EssentialsX e à saída de /whois.
• Mostra a localização aproximada do jogador no login (quando a permissão permite).
• Usa dados MaxMind GeoLite2; o EssentialsGeoIP descarrega e atualiza a base de dados automaticamente a cada 30 dias quando configurado com uma chave MaxMind.
• Módulo leve separado (jar) que integra com EssentialsX.

🧩 Público alvo

Administradores, moderadores e proprietários de servidores que usam EssentialsX e precisam de contexto geográfico não preciso sobre jogadores (moderação, verificação de fuso horário, análise básica).

🏗 Exemplos de uso

• Mostrar país ou cidade aproximada em /whois <player> via EssentialsGeoIP.
• Exibir localização aproximada a staff permitidos quando um jogador entra.
• Ajudar a apontar logins suspeitos vindos de países inesperados (apenas como indício).

⌨️ Comandos

🔐 Permissões

⚙ Instalação

📥 Instalar

• Coloque o jar do EssentialsGeoIP na pasta plugins/ (junto com o EssentialsX core).
• Inicie o servidor para criar plugins/EssentialsGeoIP/config.yml.
• Edite o config.yml e insira a chave de licença MaxMind (license-key), depois reinicie o servidor.

📦 Dependências

• EssentialsX (core).
• Acesso à Internet para descarregar a base GeoLite2.
• Chave de licença MaxMind para permitir o download conforme os termos.

🧾 Configuração

• O plugin gera plugins/EssentialsGeoIP/config.yml no primeiro arranque.
• Deve fornecer license-key do MaxMind para permitir o download da base GeoLite2.
• Atualizações automáticas da base ocorrem a cada 30 dias quando configurado.
• Não usa MySQL/SQLite para a base GeoIP (dados guardados localmente).

🧠 Informação adicional

Notas legais / privacidade

• É necessário concordar com o EULA do MaxMind GeoLite2.
• Não utilize para tentar localizar precisamente um jogador.
• O plugin atualiza a base automaticamente a cada 30 dias — isso é requerido pelas regras de distribuição.

Limitações e conflitos

• Requer Internet e chave válida; sem isso o módulo não populra a base.
• Precisão limitada ao que o GeoLite2 oferece.
• Não adiciona comandos; apenas melhora a integração com EssentialsX.

FAQ

Q: Como ativar o EssentialsGeoIP? A: Instale o jar, inicie o servidor, coloque a chave MaxMind em plugins/EssentialsGeoIP/config.yml e reinicie para que o plugin baixe a base.

Q: O EssentialsGeoIP fornece endereço exato? A: Não. Apenas país/região/cidade aproximados.

Q: Com que frequência a base é atualizada? A: A cada 30 dias quando configurada com chave válida.

Q: Precisa de base de dados externa (MySQL)? A: Não — o EssentialsGeoIP armazena o GeoLite2 localmente e não exige MySQL/SQLite.

Q: Envia métricas (bStats) ou tem integração Discord? A: Não existe documentação oficial específica sobre bStats ou integração direta com Discord para este módulo.

Quando usar

Use EssentialsGeoIP quando precisar de dicas geográficas rápidas em servidores baseados em EssentialsX para apoio à moderação ou diagnóstico. Não use como prova de localização exata.