Minecraft-plugin EssentialsGeoIP

🔌 Om EssentialsX GeoIP

EssentialsX GeoIP är en modul för EssentialsX-pluginsviten som utför lokala GeoIP-sökningar med MaxMind GeoLite2-databasen. Den integreras med EssentialsX för att visa en ungefärlig plats för spelare (till exempel i /whois och valfritt för staff när en spelare ansluter).

🎯 Syfte

Modulen ger serverpersonal ungefärlig geografisk information härledd från spelares IP-adresser för att hjälpa till med moderering, loggning och grundläggande platsmedvetenhet. Uppslag utförs lokalt med GeoLite2-databasen i stället för att fråga tredjepartstjänster för varje begäran.

⚙️ Funktioner

• Använder MaxMind GeoLite2-databasen för IP-till-plats-uppslag.
• Integreras med EssentialsX:s /whois-utdata för att visa ungefärlig plats.
• Valfritt: visa en spelares ungefärliga plats för staff när de ansluter.
• Automatiska databasuppdateringar: modulen laddar ner och uppdaterar GeoLite2-databasen enligt ett regelbundet schema (konfigurerat att uppdateras var 30:e dag som standard).
• Behörighetsnoder för att styra vem som kan se eller dölja GeoIP-resultat.

🧩 Vem den är för

Den här modulen är avsedd för serveradministratörer och modereringsteam som kör EssentialsX och vill ha ungefärliga geografiska data för moderering eller loggning på Bukkit/Spigot/Paper-servrar.

🏗️ Exempel på användning

• Visa staff ett ungefärligt land eller en stad när de granskar en spelare med /whois.
• Logga ungefärliga ursprungsregioner för misstänkta anslutningar för att hjälpa modereringen.
• Dölj platsvisning för spelare som har valt bort det via permission.

🔐 Behörigheter

⚙️ Installation

📥 Installation

• Installera huvudpluginet EssentialsX (GeoIP-modulen kräver motsvarande kärnmodul i EssentialsX).
• Ladda ner JAR-filen för EssentialsX GeoIP-modulen och lägg den i serverns plugins/-katalog.
• Starta servern en gång för att skapa filen plugins/EssentialsGeoIP/config.yml.
• Registrera dig för åtkomst till MaxMinds GeoLite2-databas, generera en license key och lägg till den i inställningen license-key i plugins/EssentialsGeoIP/config.yml.
• Starta om servern. Modulen laddar ner GeoLite2-databasen med den angivna nyckeln och håller den automatiskt uppdaterad.

📦 Beroenden

• EssentialsX (huvudmodul) — en matchande version av EssentialsX kärnplugin krävs.

🧠 Tekniska anteckningar

• Modulen kräver att du godkänner och följer MaxMind GeoLite2 EULA; databasen är ungefärlig och får inte användas för att fastställa exakta spelplatser.
• Databasens nedladdnings-/uppdateringsbeteende är en del av modulen och är konfigurerat för månatliga uppdateringar; du måste ange en giltig MaxMind license key för automatiska uppdateringar.
• Visar endast data där EssentialsX-kärnan exponerar /whois eller anslutningsnotiser; modulen ersätter inte EssentialsX:s funktionalitet.

🤝 När detta plugin är användbart

Om du kör EssentialsX och behöver lätta, lokala uppslag av ungefärliga platser för moderering eller loggning (samtidigt som du följer MaxMinds licensvillkor), erbjuder EssentialsX GeoIP en integrerad GeoLite2-lösning med automatisk uppdatering.