Plugin Minecraft EssentialsGeoIP

🔌 À propos d’EssentialsX GeoIP

EssentialsX GeoIP est un module de la suite de plugins EssentialsX qui effectue des requêtes GeoIP locales à l’aide de la base de données MaxMind GeoLite2. Il s’intègre à EssentialsX pour afficher un emplacement approximatif des joueurs (par exemple dans /whois et, éventuellement, au staff lorsqu’un joueur rejoint le serveur).

🎯 Objectif

Le module fournit au staff du serveur des informations géographiques approximatives dérivées des IP des joueurs afin d’aider à la modération, à la journalisation et à une connaissance basique de la localisation. Les requêtes sont effectuées localement à l’aide de la base GeoLite2 plutôt qu’en interrogeant des services tiers pour chaque demande.

⚙️ Fonctionnalités

• Utilise la base de données MaxMind GeoLite2 pour les recherches d’IP vers localisation.
• S’intègre à la sortie /whois d’EssentialsX pour afficher l’emplacement approximatif.
• Optionnel : afficher l’emplacement approximatif d’un joueur au staff lorsqu’il rejoint le serveur.
• Mises à jour automatiques de la base de données : le module télécharge et actualise régulièrement la base GeoLite2 (configuré par défaut pour une mise à jour tous les 30 jours).
• Nœuds de permission pour contrôler qui peut voir ou masquer les résultats GeoIP.

🧩 Pour qui c’est fait

Ce module vise les administrateurs de serveur et les équipes de modération utilisant EssentialsX et souhaitant des données géographiques approximatives pour la modération ou la journalisation sur des serveurs Bukkit/Spigot/Paper.

🏗️ Exemples d’utilisation

• Montrer au staff un pays ou une ville approximatifs lors de l’inspection d’un joueur avec /whois.
• Journaliser des régions d’origine approximatives pour des connexions suspectes afin d’aider la modération.
• Masquer l’affichage de la localisation pour les joueurs qui ont refusé via une permission.

🔐 Permissions

⚙️ Installation

📥 Configuration

• Installez le plugin principal EssentialsX (le module GeoIP nécessite le module principal EssentialsX correspondant).
• Téléchargez le JAR du module EssentialsX GeoIP et placez-le dans le répertoire plugins/ de votre serveur.
• Démarrez le serveur une fois pour générer le fichier plugins/EssentialsGeoIP/config.yml.
• Inscrivez-vous pour accéder à la base de données GeoLite2 de MaxMind, générez une clé de licence et ajoutez cette clé au paramètre license-key dans plugins/EssentialsGeoIP/config.yml.
• Redémarrez le serveur. Le module téléchargera la base GeoLite2 à l’aide de la clé fournie et la maintiendra automatiquement à jour.

📦 Dépendances

• EssentialsX (module principal) — une version correspondante du plugin central EssentialsX est requise.

🧠 Notes techniques

• Le module nécessite d’accepter et de respecter l’EULA MaxMind GeoLite2 ; la base de données est approximative et ne doit pas être utilisée pour déterminer la position précise des joueurs.
• Le comportement de téléchargement/mise à jour de la base de données fait partie du module et est configuré pour une mise à jour mensuelle ; vous devez fournir une clé de licence MaxMind valide pour les mises à jour automatiques.
• Affiche les données uniquement là où le noyau EssentialsX expose /whois ou les notifications de connexion ; le module ne remplace pas les fonctionnalités d’EssentialsX.

🤝 Quand ce plugin est utile

Si vous utilisez EssentialsX et avez besoin de recherches légères et locales d’emplacement approximatif pour la modération ou la journalisation (tout en respectant les conditions de licence de MaxMind), EssentialsX GeoIP fournit une solution GeoLite2 intégrée et mise à jour automatiquement.