Плагін Minecraft EssentialsGeoIP

🔌 Про EssentialsX GeoIP

EssentialsX GeoIP — це модуль для набору плагінів EssentialsX, який виконує локальні GeoIP-запити, використовуючи базу даних MaxMind GeoLite2. Він інтегрується з EssentialsX, щоб показувати приблизне місцезнаходження гравців (наприклад, у /whois і, за бажанням, для персоналу, коли гравець приєднується).

🎯 Призначення

Модуль надає персоналу сервера приблизну географічну інформацію, отриману з IP-адрес гравців, щоб допомогти з модерацією, логуванням і базовим розумінням місцезнаходження. Запити виконуються локально за допомогою бази даних GeoLite2, а не через сторонні сервіси для кожного запиту.

⚙️ Можливості

• Використовує базу даних MaxMind GeoLite2 для пошуку місцезнаходження за IP.
• Інтегрується з виводом /whois в EssentialsX, щоб показувати приблизне місцезнаходження.
• За бажанням: показує приблизне місцезнаходження гравця персоналу під час його входу.
• Автоматичне оновлення бази даних: модуль завантажує та оновлює базу GeoLite2 за регулярним графіком (за замовчуванням — кожні 30 днів).
• Ноди дозволів для керування тим, хто може бачити або приховувати результати GeoIP.

🧩 Для кого це

Цей модуль призначений для адміністраторів серверів і команд модерації, які використовують EssentialsX і хочуть мати приблизні географічні дані для модерації або логування на серверах Bukkit/Spigot/Paper.

🏗️ Приклади використання

• Показувати персоналу приблизну країну або місто під час перевірки гравця через /whois.
• Логувати приблизний регіон походження підозрілих підключень, щоб допомогти модерації.
• Приховувати відображення місцезнаходження для гравців, які відмовилися від цього, через permission.

🔐 Дозволи

⚙️ Встановлення

📥 Налаштування

• Встановіть основний плагін EssentialsX (модуль GeoIP вимагає відповідний основний модуль EssentialsX).
• Завантажте JAR-файл модуля EssentialsX GeoIP і помістіть його в каталог plugins/ вашого сервера.
• Запустіть сервер один раз, щоб створити файл plugins/EssentialsGeoIP/config.yml.
• Зареєструйтеся для доступу до бази даних MaxMind GeoLite2, згенеруйте license key і додайте цей ключ у параметр license-key у plugins/EssentialsGeoIP/config.yml.
• Перезапустіть сервер. Модуль завантажить базу GeoLite2 за допомогою наданого ключа та автоматично підтримуватиме її актуальною.

📦 Залежності

• EssentialsX (основний модуль) — потрібна сумісна версія основного плагіна EssentialsX.

🧠 Технічні примітки

• Модуль вимагає погодитися з EULA MaxMind GeoLite2 і дотримуватися її; база даних є приблизною і не повинна використовуватися для визначення точного місцезнаходження гравців.
• Поведінка завантаження та оновлення бази даних є частиною модуля й налаштована на щомісячне оновлення; для автоматичних оновлень потрібно надати дійсний license key MaxMind.
• Показує дані лише там, де основний EssentialsX надає /whois або сповіщення про приєднання; сам модуль не замінює функціональність EssentialsX.

🤝 Коли цей плагін корисний

Якщо ви використовуєте EssentialsX і вам потрібні легкі локальні запити приблизного місцезнаходження для модерації або логування (з дотриманням умов ліцензії MaxMind), EssentialsX GeoIP пропонує інтегроване, автоматично оновлюване рішення на базі GeoLite2.