Minecraft-plugin EssentialsGeoIP

🔌 Om EssentialsX GeoIP

EssentialsX GeoIP er et modul til EssentialsX-pluginpakken, som udfører lokale GeoIP-opslag ved hjælp af MaxMind GeoLite2-databasen. Det integrerer med EssentialsX for at vise en omtrentlig placering for spillere (for eksempel i /whois og valgfrit til staff, når en spiller tilslutter sig).

🎯 Formål

Modulet giver serverstaff omtrentlig geografisk information baseret på spillernes IP-adresser for at hjælpe med moderation, logning og grundlæggende lokationsfornemmelse. Opslag udføres lokalt ved hjælp af GeoLite2-databasen i stedet for at forespørge tredjepartstjenester for hver anmodning.

⚙️ Funktioner

• Bruger MaxMind GeoLite2-databasen til IP-til-lokation-opslag.
• Integrerer med EssentialsX's /whois-output for at vise omtrentlig placering.
• Valgfrit: vis en spillers omtrentlig placering til staff, når de tilslutter sig.
• Automatiske databaseopdateringer: modulet downloader og opdaterer GeoLite2-databasen efter en fast plan (konfigureret til at opdatere hver 30. dag som standard).
• Tilladelsesnoder til at styre, hvem der kan se eller skjule GeoIP-resultater.

🧩 Hvem det er til

Dette modul er målrettet serveradministratorer og moderationsteams, der kører EssentialsX og ønsker omtrentlig geografisk data til moderation eller logning på Bukkit/Spigot/Paper-servere.

🏗️ Eksempler på brug

• Vis staff et omtrentlig land eller en by, når de tjekker en spiller med /whois.
• Log omtrentlig oprindelsesregion for mistænkelige forbindelser for at hjælpe moderationen.
• Skjul visning af placering for spillere, der har fravalgt det via permission.

🔐 Rettigheder

⚙️ Installation

📥 Opsætning

• Installer hovedpluginet EssentialsX (GeoIP-modulet kræver den matchende EssentialsX-kernemodul).
• Download EssentialsX GeoIP-modulets JAR og læg den i serverens plugins/-mappe.
• Start serveren én gang for at generere filen plugins/EssentialsGeoIP/config.yml.
• Registrer dig for adgang til MaxMinds GeoLite2-database, generer en license key, og tilføj den license key til indstillingen license-key i plugins/EssentialsGeoIP/config.yml.
• Genstart serveren. Modulet vil downloade GeoLite2-databasen ved hjælp af den angivne nøgle og holde den opdateret automatisk.

📦 Afhængigheder

• EssentialsX (hovedmodul) — en matchende version af EssentialsX-kernetilføjelsen er påkrævet.

🧠 Tekniske noter

• Modulet kræver, at du accepterer og overholder MaxMind GeoLite2 EULA; databasen er kun et skøn og må ikke bruges til at fastslå spillernes præcise placering.
• Adfærden for download/opdatering af databasen er en del af modulet og er konfigureret til månedlige opdateringer; du skal angive en gyldig MaxMind license key for automatiske opdateringer.
• Viser kun data der, hvor EssentialsX-kernen stiller /whois eller join-notifikationer til rådighed; modulet erstatter ikke EssentialsX-funktionalitet.

🤝 Hvornår dette plugin er nyttigt

Hvis du kører EssentialsX og har brug for lette, lokale opslag af omtrentlige placeringer til moderation eller logning (mens du overholder MaxMinds licensvilkår), tilbyder EssentialsX GeoIP en integreret, automatisk opdateret GeoLite2-løsning.