Minecraft plugin EssentialsGeoIP

🔌 Over EssentialsX GeoIP

EssentialsX GeoIP is een module voor de EssentialsX-plugin suite die lokale GeoIP-opzoekingen uitvoert met behulp van de MaxMind GeoLite2-database. De module integreert met EssentialsX om een benaderde locatie van spelers te tonen (bijvoorbeeld in /whois en optioneel aan staff wanneer een speler zich aansluit).

🎯 Doel

De module geeft servermedewerkers benaderde geografische informatie op basis van de IP-adressen van spelers, om te helpen bij moderatie, logging en basislocatie-inzicht. Opzoekingen worden lokaal uitgevoerd met de GeoLite2-database in plaats van via externe opzoekservices voor elk verzoek.

⚙️ Functies

• Gebruikt de MaxMind GeoLite2-database voor IP-naar-locatie-opzoekingen.
• Integreert met de /whois-uitvoer van EssentialsX om een benaderde locatie te tonen.
• Optioneel: toon de benaderde locatie van een speler aan staff wanneer die speler binnenkomt.
• Automatische database-updates: de module downloadt en vernieuwt de GeoLite2-database volgens een vast schema (standaard ingesteld om elke 30 dagen te updaten).
• Permission-nodes om te bepalen wie GeoIP-resultaten kan zien of verbergen.

🧩 Voor wie is dit

Deze module is bedoeld voor serverbeheerders en moderatieteams die EssentialsX gebruiken en benaderde geografische gegevens willen voor moderatie- of logdoeleinden op Bukkit/Spigot/Paper-servers.

🏗️ Voorbeeldgebruik

• Laat staff een benaderd land of stad zien wanneer ze een speler controleren met /whois.
• Log benaderde herkomstregio's van verdachte verbindingen om moderatie te ondersteunen.
• Verberg de locatieweergave voor spelers die zich via permission hebben afgemeld.

🔐 Permissies

⚙️ Installatie

📥 Setup

• Installeer de hoofdplugin EssentialsX (de GeoIP-module vereist de bijpassende EssentialsX-kernmodule).
• Download de EssentialsX GeoIP-module-JAR en plaats deze in de map plugins/ van je server.
• Start de server één keer om het bestand plugins/EssentialsGeoIP/config.yml aan te maken.
• Meld je aan voor toegang tot MaxMind's GeoLite2-database, genereer een license key en voeg die license key toe aan de instelling license-key in plugins/EssentialsGeoIP/config.yml.
• Herstart de server. De module downloadt de GeoLite2-database met de opgegeven sleutel en houdt deze automatisch up-to-date.

📦 Vereisten

• EssentialsX (hoofdmodule) — een overeenkomende versie van de EssentialsX-kernplugin is vereist.

🧠 Technische notities

• De module vereist dat je akkoord gaat met en voldoet aan de MaxMind GeoLite2-EULA; de database is benaderend en mag niet worden gebruikt om exacte spelerlocaties vast te stellen.
• Het downloaden/updaten van de database maakt deel uit van de module en is ingesteld op een maandelijkse update; je moet een geldige MaxMind-license key opgeven voor automatische updates.
• Toont gegevens alleen waar de EssentialsX-kern /whois of join-meldingen beschikbaar stelt; de module vervangt de functionaliteit van EssentialsX niet.

🤝 Wanneer deze plugin nuttig is

Als je EssentialsX gebruikt en behoefte hebt aan lichte, lokale opzoekingen van benaderde locaties voor moderatie of logging (terwijl je je aan de licentievoorwaarden van MaxMind houdt), biedt EssentialsX GeoIP een geïntegreerde, automatisch bijwerkende GeoLite2-oplossing.