Minecraft plugin EssentialsGeoIP

🔌 O EssentialsX GeoIP

EssentialsX GeoIP je modul pro sadu pluginů EssentialsX, který provádí lokální GeoIP vyhledávání pomocí databáze MaxMind GeoLite2. Integruje se s EssentialsX a zobrazuje přibližnou polohu hráčů (například v /whois a volitelně i personálu při připojení hráče).

🎯 Účel

Tento modul poskytuje personálu serveru přibližné geografické informace odvozené z IP adres hráčů, aby pomohl s moderací, logováním a základním přehledem o poloze. Vyhledávání probíhá lokálně pomocí databáze GeoLite2 namísto dotazování externích vyhledávacích služeb pro každý požadavek.

⚙️ Funkce

• Používá databázi MaxMind GeoLite2 pro vyhledávání polohy podle IP.
• Integruje se s výstupem /whois v EssentialsX a zobrazuje přibližnou polohu.
• Volitelně: zobrazí přibližnou polohu hráče personálu při jeho připojení.
• Automatické aktualizace databáze: modul pravidelně stahuje a obnovuje databázi GeoLite2 (ve výchozím nastavení se aktualizuje každých 30 dní).
• Permission nody pro řízení, kdo může výsledky GeoIP zobrazit nebo skrýt.

🧩 Pro koho je to určeno

Tento modul je určen pro administrátory serverů a moderátorské týmy používající EssentialsX, kteří chtějí přibližná geografická data pro moderaci nebo logování na serverech Bukkit/Spigot/Paper.

🏗️ Příklady použití

• Ukázat personálu přibližnou zemi nebo město při kontrole hráče pomocí /whois.
• Logovat přibližný region původu podezřelých připojení pro pomoc s moderací.
• Skrýt zobrazení polohy u hráčů, kteří se odhlásí přes permission.

🔐 Oprávnění

⚙️ Instalace

📥 Nastavení

• Nainstalujte hlavní plugin EssentialsX (modul GeoIP vyžaduje odpovídající základní modul EssentialsX).
• Stáhněte JAR modul EssentialsX GeoIP a vložte jej do adresáře plugins/ na vašem serveru.
• Spusťte server jednou, aby se vytvořil soubor plugins/EssentialsGeoIP/config.yml.
• Zaregistrujte se pro přístup k databázi GeoLite2 od MaxMind, vygenerujte license key a přidejte jej do nastavení license-key v plugins/EssentialsGeoIP/config.yml.
• Restartujte server. Modul stáhne databázi GeoLite2 pomocí poskytnutého klíče a bude ji automaticky udržovat aktuální.

📦 Závislosti

• EssentialsX (hlavní modul) — je vyžadována odpovídající verze základního pluginu EssentialsX.

🧠 Technické poznámky

• Modul vyžaduje souhlas s EULA MaxMind GeoLite2 a její dodržování; databáze je pouze přibližná a nesmí být používána k určení přesné polohy hráče.
• Chování stahování/aktualizace databáze je součástí modulu a je nastaveno na měsíční aktualizaci; pro automatické aktualizace musíte poskytnout platný license key od MaxMind.
• Zobrazuje data pouze tam, kde jádro EssentialsX poskytuje /whois nebo oznámení o připojení; samotný modul funkce EssentialsX nenahrazuje.

🤝 Kdy je tento plugin užitečný

Pokud provozujete EssentialsX a potřebujete lehké, lokální vyhledávání přibližné polohy pro moderaci nebo logování (při dodržení licenčních podmínek MaxMind), EssentialsX GeoIP nabízí integrované řešení GeoLite2 s automatickými aktualizacemi.