🛡 EpicGuard

Простая и эффективная система защиты от ботов для современных версий Minecraft, обеспечивающая комплексную безопасность серверов.

✅ Совместимость и требования

• Paper 1.20.1+ (включая все форки Paper)
• Velocity 3.3+
• Java 17

🔧 Основные возможности

Система предлагает 8 настраиваемых проверок для защиты от ботов:

• Географическая проверка - черный и белый списки стран и городов
• Обнаружение VPN/прокси - настраиваемые сервисы проверки с кэшированием
• Проверка никнеймов - блокировка по шаблонам с использованием регулярных выражений
• Повторное подключение - требование повторного входа с тем же адресом и никнеймом
• Список серверов - обязательный пинг сервера перед подключением
• Проверка настроек - подтверждение отправки пакета настроек после входа
• Режим блокировки - временное ограничение подключений при высокой нагрузке
• Схожесть имен (BETA) - обнаружение похожих никнеймов
• Лимит аккаунтов - ограничение количества учетных записей

Дополнительные функции

• Поддержка SQLite и MySQL
• Статистика в реальном времени на панели действий
• Автоматическое добавление в белый список
• Фильтрация консоли

📋 Команды и разрешения

Для использования команд требуется разрешение epicguard.admin. На разных платформах доступны дополнительные псевдонимы команд, такие как /guardvelocity или /epicguardpaper.

🔌 Использование API EpicGuard в вашем проекте

API пока не очень развит, но уже предоставляет базовые возможности для интеграции.

Gradle (Kotlin)

repositories {
    // Снимки
    maven("https://s01.oss.sonatype.org/content/repositories/snapshots/")
    // Релизы
    mavenCentral()
}
dependencies {
    compileOnly("com.github.4drian3d:epicguard-api:[ВЕРСИЯ ЗДЕСЬ]")
}

Gradle (Groovy)

repositories {
    maven {
      url = 'https://s01.oss.sonatype.org/content/repositories/snapshots/'
    }
  mavenCentral()
}
dependencies {
    compileOnly 'com.github.4drian3d:epicguard-api:[ВЕРСИЯ ИЛИ ID КОММИТА ЗДЕСЬ]'
}

Maven

  <repositories>
    <!-- Только для снимков -->
    <repository>
      <id>sonatype-oss-snapshots1</id>
      <url>https://s01.oss.sonatype.org/content/repositories/snapshots/&lt;/url&gt;
    </repository>
  </repositories>
  <dependencies>
      <dependency>
         <groupid>com.github.4drian3d</groupid>
         <artifactid>epicguard-api</artifactid>
         <version>[ВЕРСИЯ ЗДЕСЬ]</version>
         <scope>provided</scope>
     </dependency>
  </dependencies>

Использование API

Убедитесь, что EpicGuard полностью загружен до вашего плагина.

Нажмите, чтобы увидеть класс API

// Импорт класса API.
import me.xneox.epicguard.core.EpicGuardAPI;
import me.xneox.epicguard.core.manager.AttackManager;
public class EpicGuardAPIExample {
  // Доступ к экземпляру EpicGuardAPI.
  EpicGuardAPI api = EpicGuardAPI.INSTANCE;
  // Получение экземпляра AttackManager:
  AttackManager attackManager = api.attackManager();
  // Проверка, находится ли сервер под атакой.
  boolean isUnderAttack = attackManager.isUnderAttack();
  // Проверка текущих подключений в секунду.
  int cps = attackManager.connectionCounter();

  // Проверка страны пользователя:
  String countryId = api.geoManager().countryCode("127.0.0.1");
}

🔒 Политика конфиденциальности

Плагин подключается к различным внешним сервисам для полноценной работы:

• Базы данных MaxMind's Geolite2 (страны и города) загружаются при первом запуске и обновляются еженедельно. Геолокация пользователей проверяется локально на вашем сервере.
• В конфигурации по умолчанию IP-адреса подключающихся пользователей отправляются на https://proxycheck.io/ для проверки использования прокси или VPN.
• IP-адреса и связанные с ними никнеймы хранятся в локальной базе данных в виде обычного текста.
• Плагин периодически проверяет последнюю версию в этом репозитории. Эту функцию можно отключить.
• Отсутствует система метрик или любой другой сбор данных.

Это обновленная версия EpicGuard для последних версий Paper, Waterfall и Velocity.