Plugin de Minecraft EssentialsGeoIP

🔌 Acerca de EssentialsX GeoIP

EssentialsX GeoIP es un módulo de la suite de plugins EssentialsX que realiza búsquedas GeoIP locales usando la base de datos MaxMind GeoLite2. Se integra con EssentialsX para mostrar una ubicación aproximada de los jugadores (por ejemplo, en /whois y, opcionalmente, al personal cuando un jugador se conecta).

🎯 Propósito

El módulo proporciona al personal del servidor información geográfica aproximada derivada de las IP de los jugadores para ayudar en la moderación, el registro y la conciencia básica de la ubicación. Las búsquedas se realizan localmente usando la base de datos GeoLite2 en lugar de consultar servicios de terceros para cada solicitud.

⚙️ Características

• Usa la base de datos MaxMind GeoLite2 para búsquedas de IP a ubicación.
• Se integra con la salida de /whois de EssentialsX para mostrar la ubicación aproximada.
• Opcional: mostrar la ubicación aproximada de un jugador al personal cuando se conecta.
• Actualizaciones automáticas de la base de datos: el módulo descarga y actualiza la base de datos GeoLite2 con una programación regular (configurado para actualizarse cada 30 días por defecto).
• Nodos de permiso para controlar quién puede ver u ocultar los resultados de GeoIP.

🧩 Para quién es

Este módulo está dirigido a administradores de servidores y equipos de moderación que usan EssentialsX y quieren datos geográficos aproximados para fines de moderación o registro en servidores Bukkit/Spigot/Paper.

🏗️ Casos de uso de ejemplo

• Mostrar al personal un país o una ciudad aproximados al inspeccionar a un jugador con /whois.
• Registrar regiones de origen aproximadas de conexiones sospechosas para ayudar en la moderación.
• Ocultar la ubicación para los jugadores que hayan optado por no compartirla mediante permiso.

🔐 Permisos

⚙️ Instalación

📥 Configuración

• Instala el plugin principal EssentialsX (el módulo GeoIP requiere el módulo central correspondiente de EssentialsX).
• Descarga el JAR del módulo EssentialsX GeoIP y colócalo en el directorio plugins/ de tu servidor.
• Inicia el servidor una vez para generar el archivo plugins/EssentialsGeoIP/config.yml.
• Regístrate para obtener acceso a la base de datos GeoLite2 de MaxMind, genera una clave de licencia y añade esa clave a la configuración license-key en plugins/EssentialsGeoIP/config.yml.
• Reinicia el servidor. El módulo descargará la base de datos GeoLite2 usando la clave proporcionada y la mantendrá actualizada automáticamente.

📦 Dependencias

• EssentialsX (módulo principal) — se requiere una versión compatible del plugin principal EssentialsX.

🧠 Notas técnicas

• El módulo requiere aceptar y cumplir el EULA de MaxMind GeoLite2; la base de datos es aproximada y no debe usarse para determinar ubicaciones precisas de los jugadores.
• El comportamiento de descarga/actualización de la base de datos forma parte del módulo y está configurado para actualizarse mensualmente; debes proporcionar una clave de licencia válida de MaxMind para las actualizaciones automáticas.
• Muestra datos solo donde el núcleo de EssentialsX expone /whois o notificaciones de entrada; el módulo en sí no reemplaza la funcionalidad de EssentialsX.

🤝 Cuándo es útil este plugin

Si usas EssentialsX y necesitas búsquedas ligeras y locales de ubicación aproximada para moderación o registro (cumpliendo los términos de licencia de MaxMind), EssentialsX GeoIP ofrece una solución GeoLite2 integrada y con actualización automática.