Plugin Minecraft EssentialsGeoIP

🔌 Despre EssentialsX GeoIP

EssentialsX GeoIP este un modul pentru suita de pluginuri EssentialsX care efectuează căutări locale GeoIP folosind baza de date MaxMind GeoLite2. Se integrează cu EssentialsX pentru a afișa locația aproximativă a jucătorilor (de exemplu în /whois și, opțional, pentru staff atunci când un jucător se conectează).

🎯 Scop

Modulul oferă personalului serverului informații geografice aproximative derivate din IP-urile jucătorilor pentru a ajuta la moderare, logare și conștientizarea de bază a locației. Căutările sunt efectuate local folosind baza de date GeoLite2, în loc să interogheze servicii terțe pentru fiecare solicitare.

⚙️ Funcționalități

• Folosește baza de date MaxMind GeoLite2 pentru căutări de tip IP-to-location.
• Se integrează cu ieșirea /whois din EssentialsX pentru a afișa locația aproximativă.
• Opțional: afișează locația aproximativă a unui jucător pentru staff atunci când se conectează.
• Actualizări automate ale bazei de date: modulul descarcă și reîmprospătează baza GeoLite2 la un interval regulat (configurat implicit pentru actualizare la fiecare 30 de zile).
• Noduri de permisiune pentru a controla cine poate vedea sau ascunde rezultatele GeoIP.

🧩 Pentru cine este

Acest modul este destinat administratorilor de server și echipelor de moderare care rulează EssentialsX și doresc date geografice aproximative pentru moderare sau logare pe servere Bukkit/Spigot/Paper.

🏗️ Exemple de utilizare

• Arată staff-ului o țară sau un oraș aproximativ atunci când verifică un jucător cu /whois.
• Loghează regiuni de origine aproximative pentru conexiuni suspecte, pentru a ajuta moderarea.
• Ascunde afișarea locației pentru jucătorii care au optat să nu participe, prin permission.

🔐 Permisiuni

⚙️ Instalare

📥 Configurare

• Instalează pluginul principal EssentialsX (modulul GeoIP necesită modulul de bază EssentialsX corespunzător).
• Descarcă fișierul JAR al modulului EssentialsX GeoIP și plasează-l în directorul plugins/ al serverului tău.
• Pornește serverul o dată pentru a genera fișierul plugins/EssentialsGeoIP/config.yml.
• Înregistrează-te pentru acces la baza de date GeoLite2 de la MaxMind, generează un license key și adaugă acel license key la setarea license-key din plugins/EssentialsGeoIP/config.yml.
• Repornește serverul. Modulul va descărca baza de date GeoLite2 folosind cheia furnizată și o va menține actualizată automat.

📦 Dependențe

• EssentialsX (modul principal) — este necesară o versiune compatibilă a pluginului de bază EssentialsX.

🧠 Note tehnice

• Modulul necesită acceptarea și respectarea EULA MaxMind GeoLite2; baza de date este aproximativă și nu trebuie folosită pentru a determina locații exacte ale jucătorilor.
• Comportamentul de descărcare/actualizare a bazei de date face parte din modul și este configurat pentru actualizare lunară; trebuie să oferi un license key MaxMind valid pentru actualizări automate.
• Afișează date doar acolo unde nucleul EssentialsX expune /whois sau notificări la intrare; modulul în sine nu înlocuiește funcționalitatea EssentialsX.

🤝 Când este util acest plugin

Dacă folosești EssentialsX și ai nevoie de căutări locale, ușoare, pentru locații aproximative în scopuri de moderare sau logare (respectând în același timp termenii licenței MaxMind), EssentialsX GeoIP oferă o soluție GeoLite2 integrată, cu actualizare automată.