Plugin Minecraft EssentialsGeoIP

🔌 Informazioni su EssentialsX GeoIP

EssentialsX GeoIP è un modulo della suite di plugin EssentialsX che esegue ricerche GeoIP locali usando il database MaxMind GeoLite2. Si integra con EssentialsX per mostrare una posizione approssimativa dei giocatori (ad esempio in /whois e, facoltativamente, al personale quando un giocatore entra).

🎯 Scopo

Il modulo fornisce al personale del server informazioni geografiche approssimative derivate dagli IP dei giocatori per aiutare nella moderazione, nella registrazione dei log e nella consapevolezza di base della posizione. Le ricerche vengono eseguite localmente usando il database GeoLite2 invece di interrogare servizi di terze parti per ogni richiesta.

⚙️ Funzionalità

• Usa il database MaxMind GeoLite2 per le ricerche da IP a posizione.
• Si integra con l’output /whois di EssentialsX per mostrare la posizione approssimativa.
• Opzionale: mostra la posizione approssimativa di un giocatore al personale quando si connette.
• Aggiornamenti automatici del database: il modulo scarica e aggiorna il database GeoLite2 con una pianificazione regolare (configurata per aggiornarsi ogni 30 giorni per impostazione predefinita).
• Nodi di permesso per controllare chi può vedere o nascondere i risultati GeoIP.

🧩 A chi è rivolto

Questo modulo è destinato agli amministratori del server e ai team di moderazione che usano EssentialsX e desiderano dati geografici approssimativi per scopi di moderazione o registrazione su server Bukkit/Spigot/Paper.

🏗️ Casi d’uso di esempio

• Mostrare al personale un paese o una città approssimativi quando si ispeziona un giocatore con /whois.
• Registrare regioni di origine approssimative per connessioni sospette per aiutare la moderazione.
• Nascondere la visualizzazione della posizione per i giocatori che hanno scelto di non partecipare tramite permesso.

🔐 Permessi

⚙️ Installazione

📥 Configurazione

• Installa il plugin principale EssentialsX (il modulo GeoIP richiede il corrispondente modulo core di EssentialsX).
• Scarica il JAR del modulo EssentialsX GeoIP e inseriscilo nella directory plugins/ del tuo server.
• Avvia il server una volta per generare il file plugins/EssentialsGeoIP/config.yml.
• Registrati per accedere al database GeoLite2 di MaxMind, genera una chiave di licenza e aggiungi tale chiave all’impostazione license-key in plugins/EssentialsGeoIP/config.yml.
• Riavvia il server. Il modulo scaricherà il database GeoLite2 usando la chiave fornita e lo manterrà aggiornato automaticamente.

📦 Dipendenze

• EssentialsX (modulo principale) — è richiesta una versione corrispondente del plugin core EssentialsX.

🧠 Note tecniche

• Il modulo richiede di accettare e rispettare l’EULA di MaxMind GeoLite2; il database è approssimativo e non deve essere usato per determinare la posizione precisa dei giocatori.
• Il comportamento di download/aggiornamento del database fa parte del modulo ed è configurato per aggiornarsi con cadenza mensile; devi fornire una chiave di licenza MaxMind valida per gli aggiornamenti automatici.
• Mostra i dati solo dove il core di EssentialsX espone /whois o notifiche di ingresso; il modulo in sé non sostituisce la funzionalità di EssentialsX.

🤝 Quando questo plugin è utile

Se usi EssentialsX e hai bisogno di ricerche leggere e locali della posizione approssimativa per moderazione o registrazione (nel rispetto dei termini di licenza di MaxMind), EssentialsX GeoIP offre una soluzione GeoLite2 integrata e con aggiornamento automatico.