Plugin Minecraft EssentialsGeoIP

🔌 O EssentialsX GeoIP

EssentialsX GeoIP to moduł pakietu wtyczek EssentialsX, który wykonuje lokalne wyszukiwania GeoIP przy użyciu bazy danych MaxMind GeoLite2. Integruje się z EssentialsX, aby wyświetlać przybliżoną lokalizację graczy (na przykład w /whois oraz opcjonalnie dla administracji, gdy gracz dołącza).

🎯 Cel

Moduł dostarcza administracji serwera przybliżonych informacji geograficznych wyprowadzonych z adresów IP graczy, aby ułatwić moderację, logowanie i podstawową orientację w lokalizacji. Wyszukiwania są wykonywane lokalnie przy użyciu bazy GeoLite2, zamiast odpytywania zewnętrznych usług przy każdym żądaniu.

⚙️ Funkcje

• Używa bazy danych MaxMind GeoLite2 do wyszukiwania IP na podstawie lokalizacji.
• Integruje się z wynikiem /whois w EssentialsX, aby pokazywać przybliżoną lokalizację.
• Opcjonalnie wyświetla administracji przybliżoną lokalizację gracza po dołączeniu.
• Automatyczne aktualizacje bazy danych: moduł pobiera i odświeża bazę GeoLite2 według regularnego harmonogramu (domyślnie co 30 dni).
• Węzły uprawnień do kontrolowania, kto może widzieć lub ukrywać wyniki GeoIP.

🧩 Dla kogo jest ten moduł

Ten moduł jest przeznaczony dla administratorów serwerów i zespołów moderacyjnych korzystających z EssentialsX, którzy chcą mieć przybliżone dane geograficzne do moderacji lub logowania na serwerach Bukkit/Spigot/Paper.

🏗️ Przykładowe zastosowania

• Pokazywanie administracji przybliżonego kraju lub miasta podczas sprawdzania gracza przez /whois.
• Zapisywanie przybliżonych regionów pochodzenia podejrzanych połączeń, aby wspierać moderację.
• Ukrywanie wyświetlania lokalizacji dla graczy, którzy zrezygnowali z tej funkcji za pomocą uprawnienia.

🔐 Uprawnienia

⚙️ Instalacja

📥 Konfiguracja

• Zainstaluj główną wtyczkę EssentialsX (moduł GeoIP wymaga pasującego modułu core EssentialsX).
• Pobierz plik JAR modułu EssentialsX GeoIP i umieść go w katalogu plugins/ na serwerze.
• Uruchom serwer raz, aby wygenerować plik plugins/EssentialsGeoIP/config.yml.
• Zarejestruj się, aby uzyskać dostęp do bazy GeoLite2 firmy MaxMind, wygeneruj klucz licencyjny i dodaj go do ustawienia license-key w plugins/EssentialsGeoIP/config.yml.
• Uruchom ponownie serwer. Moduł pobierze bazę GeoLite2, używając podanego klucza, i będzie ją automatycznie aktualizować.

📦 Zależności

• EssentialsX (główny moduł) — wymagana jest zgodna wersja podstawowej wtyczki EssentialsX.

🧠 Uwagi techniczne

• Moduł wymaga zaakceptowania i przestrzegania EULA MaxMind GeoLite2; baza danych ma charakter przybliżony i nie może być używana do określania dokładnej lokalizacji gracza.
• Zachowanie pobierania/aktualizacji bazy danych jest częścią modułu i jest skonfigurowane do miesięcznych aktualizacji; do automatycznych aktualizacji musisz podać prawidłowy klucz licencyjny MaxMind.
• Pokazuje dane tylko tam, gdzie core EssentialsX udostępnia /whois lub powiadomienia o dołączeniu; sam moduł nie zastępuje funkcjonalności EssentialsX.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli używasz EssentialsX i potrzebujesz lekkich, lokalnych wyszukiwań przybliżonej lokalizacji do moderacji lub logowania (przy zachowaniu warunków licencyjnych MaxMind), EssentialsX GeoIP oferuje zintegrowane rozwiązanie GeoLite2 z automatycznymi aktualizacjami.