Minecraft-Plugin EssentialsGeoIP

🔌 Über EssentialsX GeoIP

EssentialsX GeoIP ist ein Modul der EssentialsX-Plugin-Suite, das lokale GeoIP-Abfragen mithilfe der MaxMind GeoLite2-Datenbank durchführt. Es integriert sich in EssentialsX, um Spielern einen ungefähren Standort anzuzeigen (zum Beispiel in /whois und optional für das Team, wenn ein Spieler beitritt).

🎯 Zweck

Das Modul stellt dem Serverteam ungefähre geografische Informationen bereit, die aus den IPs der Spieler abgeleitet werden, um Moderation, Protokollierung und ein grundlegendes Standortbewusstsein zu unterstützen. Die Abfragen werden lokal mit der GeoLite2-Datenbank ausgeführt, statt für jede Anfrage Dienste Dritter abzufragen.

⚙️ Funktionen

• Verwendet die MaxMind GeoLite2-Datenbank für IP-zu-Standort-Abfragen.
• Integriert sich in die /whois-Ausgabe von EssentialsX, um den ungefähren Standort anzuzeigen.
• Optional: Anzeige des ungefähren Standorts eines Spielers für das Team beim Beitritt.
• Automatische Datenbank-Updates: Das Modul lädt die GeoLite2-Datenbank regelmäßig herunter und aktualisiert sie (standardmäßig so konfiguriert, dass alle 30 Tage aktualisiert wird).
• Berechtigungseinträge, um zu steuern, wer GeoIP-Ergebnisse sehen oder verbergen kann.

🧩 Für wen es gedacht ist

Dieses Modul richtet sich an Serveradministratoren und Moderationsteams, die EssentialsX auf Bukkit-/Spigot-/Paper-Servern verwenden und ungefähre geografische Daten für Moderations- oder Protokollierungszwecke benötigen.

🏗️ Beispielanwendungen

• Dem Team bei der Prüfung eines Spielers mit /whois ein ungefähres Land oder eine Stadt anzeigen.
• Ungefähre Herkunftsregionen verdächtiger Verbindungen protokollieren, um die Moderation zu unterstützen.
• Die Standortanzeige für Spieler verbergen, die sich per Berechtigung abgemeldet haben.

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Installiere das Haupt-Plugin EssentialsX (das GeoIP-Modul benötigt das passende EssentialsX-Core-Modul).
• Lade die JAR-Datei des EssentialsX-GeoIP-Moduls herunter und lege sie im Verzeichnis plugins/ deines Servers ab.
• Starte den Server einmal, um die Datei plugins/EssentialsGeoIP/config.yml zu erzeugen.
• Registriere dich für den Zugriff auf die GeoLite2-Datenbank von MaxMind, erzeuge einen Lizenzschlüssel und trage diesen in die Einstellung license-key in plugins/EssentialsGeoIP/config.yml ein.
• Starte den Server neu. Das Modul lädt die GeoLite2-Datenbank mit dem bereitgestellten Schlüssel herunter und hält sie automatisch aktuell.

📦 Abhängigkeiten

• EssentialsX (Hauptmodul) — eine passende Version des EssentialsX-Core-Plugins ist erforderlich.

🧠 Technische Hinweise

• Das Modul erfordert das Einverständnis mit der MaxMind-GeoLite2-EULA und deren Einhaltung; die Datenbank ist nur ungefähr und darf nicht zur Bestimmung genauer Spielerstandorte verwendet werden.
• Das Verhalten für den Download/die Aktualisierung der Datenbank ist Teil des Moduls und ist so konfiguriert, dass monatlich aktualisiert wird; du musst einen gültigen MaxMind-Lizenzschlüssel für automatische Updates bereitstellen.
• Zeigt Daten nur dort an, wo der EssentialsX-Core /whois oder Beitrittsbenachrichtigungen bereitstellt; das Modul selbst ersetzt die Funktionalität von EssentialsX nicht.

🤝 Wann dieses Plugin nützlich ist

Wenn du EssentialsX betreibst und leichte, lokale Abfragen für ungefähre Standorte zur Moderation oder Protokollierung benötigst (unter Einhaltung der MaxMind-Lizenzbedingungen), bietet EssentialsX GeoIP eine integrierte, automatisch aktualisierte GeoLite2-Lösung.