AuthCore

Фортресс-фреймворк для серверов Minecraft. Единая кодовая база для 1.16.0 → 26.x+ на Fabric, Forge и NeoForge.
Закалён против любых сценариев атак, свободен от гонок при пиковых нагрузках и спроектирован выдерживать 500k+ зарегистрированных аккаунтов и тысячи игроков онлайн с ровным, без всплесков, потреблением ресурсов.

Быстрый старт • Главное • Матрица Jar • Архитектура • Команды • Конфигурация • Модель безопасности • Живые метрики • Сообщество

---

📑 Содержание

✨ Главное и основная философия

🚀 Быстрый старт за 5 минут

graph LR
    A[Выбери Range Jar] --> B[Закинь в mods/ или plugins/]
    B --> C[Запусти сервер]
    C --> D[Автосоздание конфига и БД]
    D --> E[Игроки заходят и авторизуются]

1. Выбери нужный jar: Подбери jar под свой загрузчик и версию Minecraft из таблицы jar-ов на Modrinth или в GitHub Releases.
2. Установка: Закинь jar-файл прямо в папку mods/ своего сервера (или в plugins/ прокси).
3. Запусти сервер: AuthCore работает из коробки без обязательной настройки. Встроенная база данных SQLite (authcore.db) автоматически создаётся в config/authcore/.

4. Первый вход:

   • Premium-игроки: Проверяются асинхронно через сессионные серверы Mojang с фоновыми повторными попытками. Автоматически входят без пароля.
   • Cracked / офлайн-игроки: Помещаются в безопасное limbo-лобби, где им предлагаются интерактивные кнопки в чате или команды: `/register или/login `.
5. Администрирование: Запусти /authcore validate для проверки целостности конфигурации или открой интерактивную веб-панель по адресу https://127.0.0.1:25570.

┌─────────────────────────────────────────────────────────────┐
│  ✓  AUTHCORE v1.0.0 — FORTRESS FRAMEWORK INITIALIZED       │
├─────────────────────────────────────────────────────────────┤
│  Platform         : Fabric / Forge / NeoForge / Velocity   │
│  Minecraft        : 1.16.0 → 26.x+ (Universal Range Engine) │
│  Database         : SQLite (WAL) / MySQL / PostgreSQL       │
│  Security Stack   : 7-Layer Detection Bypass Resistance     │
│  Crypto           : Argon2id (M:64MB, T:3, P:1) + SCRAM     │
│  Proxy Forwarding : Auto-Detected (Velocity HMAC / Bungee)  │
│  Web Panel        : https://127.0.0.1:25570 (Token Guarded) │
│  Status           : 0 Warnings · 180+ Security Audits PASS  │
└─────────────────────────────────────────────────────────────┘

[!NOTE] Впервые с AuthCore? Загляни в полное руководство для админа сервера — там пошаговые инструкции с картинками, настройка прав и топологии прокси.

📦 Какой jar мне нужен?

Каждый скомпилированный jar выполняет обе роли: нативный мод для сервера (Fabric, Forge или NeoForge) и плагин для прокси BungeeCord/Velocity (определяется автоматически при запуске). Выбери jar под свой диапазон версий Minecraft и загрузчик:

[!TIP] Зачем jar-ы с диапазонами? Minecraft 26.0+ поставляется с полностью необфусцированным кодом, а Fabric intermediary устарел начиная с 26.x (см. анонс Fabric). Каждый jar с диапазоном тщательно проверен на всех крайних версиях своего диапазона с помощью нашего параллельного Docker-тестового стенда.

🧩 Архитектура и жизненный цикл аутентификации

flowchart TD
    subgraph Connect["1. Рукопожатие и перехват угроз"]
        Join([Игрок заходит на сервер]) --> DetectProxy["Определение прокси и форвардинга\n(BungeeCord / Velocity HMAC)"]
        DetectProxy --> Intercept["Проверка ClientGuard\nФлуд пакетами · Аномалии призраков · Разброс взгляда"]
        Intercept --> RateLimit{"Превышены лимиты\nили IP в чёрном CIDR?"}
        RateLimit -->|Да| KickDrop["Сброс соединения / Оповещение ханипота"]
        RateLimit -->|Нет| Limbo["Удержание игрока в Limbo\nИнертный инвентарь · Нулевой дрейф · Ограниченная телепортация"]
    end

    subgraph AuthEval["2. Аутентификация и верификация"]
        Limbo --> CheckMode{"Режим сервера / аккаунта"}
        CheckMode -->|Premium авто-вход| MojangCheck["Асинхронная проверка сессии Mojang\n(Устойчиво к сбоям Mojang API)"]
        MojangCheck -->|Подтверждено| PassAuth["Обход парольной аутентификации"]
        CheckMode -->|Offline / Cracked| PromptAuth["Показ динамического заголовка / Action Bar\nЗапрос /register или /login"]
        PromptAuth --> CaptchaCheck{"Сработал риск-скор?"}
        CaptchaCheck -->|Высокий риск| TaskCaptcha["Принудительная капча действием\n(Присесть / Прыжок / Поворот головы)"]
        CaptchaCheck -->|Обычный| CredentialCheck["Проверка хеша (Argon2id/BCrypt/SCRAM)\nИли TOTP 2FA / Email OTP"]
        TaskCaptcha --> CredentialCheck
    end

    subgraph SessionBind["3. Привязка сессии и выпуск в игру"]
        CredentialCheck -->|Успех| PassAuth
        PassAuth --> SessionIssue["Выдача токена сессии и SSO-рассылка через Redis"]
        SessionIssue --> RestoreState["Восстановление позиции игрока, инвентаря и возможностей"]
        RestoreState --> InGame([Полный доступ к игре предоставлен])
    end

🛡️ Устойчивость к обходу обнаружения

AuthCore разворачивает 7-слойный стек защиты в глубину, призванный сделать автоматические обходы клиентов, атаки бот-ферм и атаки с подстановкой учётных данных математически и практически неосуществимыми:

Архитектурные гарантии безопасности

• Fail-Closed по умолчанию: Аутентификация прокси требует синхронизации через Redis; пустой список trusted-proxies автоматически отключает небезопасный приём прокси.
• Криптографическая независимость: В бинарнике нет захардкоженных ключей; секреты аттестации динамически генерируются высокоэнтропийным CSPRNG при первом запуске.
• Целостность состояния и защита памяти: Все карты обнаружения и отслеживания IP имеют принудительные границы кардинальности и автоочистку на тике для противодействия атакам на исчерпание памяти.
• Нет единой точки отказа: Каждый слой защиты работает независимо; даже если атакующий обойдёт проверки бренда клиента, анализ таймингов пакетов и поведения остаётся активным.

🛠️ Команды

Команды игрока

Команды администратора

Доступ требует уровня OP 3+ в Minecraft, права LuckPerms или выполнения из консоли сервера.

⚙️ Конфигурация

AuthCore создаёт все конфигурационные файлы в config/authcore/. Архитектура использует один файл на домен конфигурации, что гарантирует чистые диффы в системе контроля версий и отсутствие утечки учётных данных в игровые конфиги:

Пример фрагмента конфигурации

# settings.conf
language = "en"              # en | zh | es | de | fr | pt | ru
cache-max-users = 20000      # Ограниченный размер LRU-кэша

# session.conf
session {
    # Режим online/offline сервера определяется автоматически из server.properties!
    timeout-ms = 3600000     # Время жизни активной сессии (60 минут)

    account-lock {
        enabled = true
        max-failed-logins = 8
        lock-duration-ms = 600000
    }

    security {
        webhook-url = "https://discord.com/api/webhooks/..." # Оповещения безопасности в Discord
    }

    proxy-support {
        enabled = false       # Включите, если сервер стоит за Velocity или BungeeCord
        protocol = "auto"     # Поддерживает "auto", "velocity", "bungeecord"
    }

    web-panel {
        enabled = false       # REST-панель администратора
        host = "127.0.0.1"
        port = 25570
        token = "CHANGE_ME"   # Сгенерируйте через: openssl rand -hex 16
    }

    email {
        enabled = false       # Коды восстановления по SMTP и оповещения о входе
        host = "smtp.gmail.com"
        port = 587
        username = "admin@example.com"
        password = "app-password"
        from = "AuthCore Security <admin@example.com>"
    }
}

# lobby.conf
lobby {
    movement-correction-radius = 1.5      # Дистанция до плавного возврата без дёрганья
    movement-correction-interval-ms = 600 # Минимальное время между корректировками позиции
}

🚦 Настройка функций одним взглядом

Все функции AuthCore модульные и опциональные. Для базового использования SQLite никакой настройки не требуется. Включайте только то, что нужно вашей сети:

🌍 Языки

AuthCore из коробки включает 7 языков, переведённых сообществом. Активный язык задаётся параметром language = "en" в settings.conf:

[!TIP] Свои локализации: Положите файл `messages-.confвconfig/authcore/`. AuthCore автоматически подхватит ваши строки и запишет в лог все отсутствующие ключи относительно английского шаблона.

🔁 Прокси и сеть (Velocity / BungeeCord)

AuthCore изначально поддерживает современные прокси-архитектуры Minecraft — как при установке в качестве мода на бэкенде, так и прямо на прокси:

• Универсальное автоопределение IP-форвардинга: Автоматически разбирает legacy-пейлоады рукопожатия BungeeCord и Velocity (ip\0uuid\0properties). Настоящий удалённый IP сразу используется для GeoIP-поиска, проверки сессии, ограничения частоты запросов и анализа входов.
• Modern Identity Forwarding в Velocity: Защищённый HMAC-проверкой приём логина velocity:player_info безопасно считывает данные, используя общий velocity-secret, заданный в velocity.toml.
• Канал межмодового взаимодействия (authcore:auth): Отправляет сетевые пакеты `AUTH_CHANGED|||<1|0>`, позволяя AuthCore без конфликтов работать рядом со сторонними бэкенд-плагинами авторизации.
• Redis SSO при переброске хаб → игровой сервер: Игроки, авторизованные на хабе/в лимбо, сохраняют активную сессию при переброске между игровыми нодами без повторного ввода пароля.
• Fail-Closed при включённом прокси: Прямые подключения в обход прокси отклоняются сразу, если поддержка прокси активна.

⚡ Производительность

С самого начала спроектирован так, чтобы без усилий масштабироваться до 500 000+ зарегистрированных аккаунтов и тысяч одновременных входов без борьбы за потоки и скачков памяти:

• O(1) безблокировочные резолверы пользователей: События горячего пути (перехват пакетов, проверки движения, клики в инвентаре и события чата) находят игрока за O(1) через ConcurrentHashMap с ключом по UUID (User.getUser(player)). Ноль аллокаций строк и ноль запросов к базе на горячих путях.
• Многопоточность без дедлоков: Потокобезопасный канонический кэш пользователей в памяти гарантирует ровно один экземпляр User на аккаунт. Запросы к базе при промахе кэша сериализуются под гранулярными блокировками; фоновые операции ввода-вывода выполняются в ограниченном пуле демонов.
• Плоские кривые памяти и троттлинг пакетов: Метки активности пользователя обновляются не чаще раза в минуту, а не на каждый пакет. Коррекции позиции в лимбо соблюдают минимальный интервал, предотвращая флуд пакетами позиции и убирая дрожание камеры.
• Ноль работы на тик: Плагин не выполняет циклических опросов по тикам. Вся логика жизненного цикла строго событийная — по сетевому пакету, входу, логину или отключению.
• Оптимизация кэша на высокой скорости: SQLite работает в режиме журнала WAL с synchronous=NORMAL и настроенными кэшами страниц. MySQL и PostgreSQL используют пулы соединений с автоматической подготовкой запросов.

🪶 Серверы с малыми ресурсами (≤ 250 МБ RAM / 1 ядро)

Для сверхкомпактных нод (например, VPS или дешёвых облачных контейнеров с 256 МБ RAM) добавьте эти флаги в скрипт запуска:

java -Xmx192M -Xms64M -XX:+UseSerialGC -XX:TieredStopAtLevel=1 \
     -XX:-UsePerfData -XX:MaxMetaspaceSize=96M -jar fabric-server.jar nogui

Рекомендации по оптимизации: Оставьте cache-max-users = 5000 в settings.conf, используйте встроенное хранилище SQLite по умолчанию (это избавляет от сетевых драйверов внешней БД) и держите веб-панель отключённой.

🔮 Совместимость с несколькими версиями и загрузчиками

AuthCore поддерживает единую унифицированную кодовую базу, используя условную компиляцию Stonecutter и Stonecraft:

src/main/java/          --> Общее каноническое дерево исходников Java
├── in/potenfyr/authcore/
│   ├── api/            --> Публичный API AuthCore для разработчиков
│   ├── auth/           --> Контроллеры аутентификации и 2FA
│   ├── cache/          --> Высокопроизводительные неблокирующие кэши
│   ├── command/        --> Кроссплатформенные обработчики команд
│   ├── config/         --> Менеджер разделённой конфигурации HOCON
│   ├── database/       --> Драйверы SQLite, MySQL, PostgreSQL, Redis
│   ├── listener/       --> Кросс-загрузочные слушатели событий
│   ├── mixin/          --> Универсальные платформенные миксины
│   ├── model/          --> Модели данных пользователей и сессий
│   ├── proxy/          --> IP-форвардинг Velocity и BungeeCord
│   ├── security/       --> 7-уровневый обход детекции и ClientGuard
│   └── web/            --> REST веб-панель с HTTPS-аутентификацией по токену

• Независимость от загрузчика: Тонкие точки входа (FabricEntry, ForgeEntry, NeoForgeEntry) связывают нативные хуки загрузчиков с универсальным движком AuthCore.
• Совместимость с необфусцированными 26.x: Прямая совместимость с маппингами Mojang позволяет мгновенно собирать сборки под современные и будущие версии Minecraft.
• Ненавязчивые миксины: Миксины затрагивают только этапы входа и сетевой аутентификации, обеспечивая нулевую несовместимость с модами оптимизации производительности, включая Lithium, C2ME, Krypton, ModernFix, FerriteCore и Spark.

🧑‍💻 Сборка из исходников

AuthCore требует JDK 25 для компиляции всех целей проекта (обеспечивается современным конвейером сборки 26.1–26.2). Если нужны портативные JDK, выполните test/install-java-and-provided-jars.sh для автоматической установки Adoptium JDK 17, 21 и 25.

# Собрать ВСЕ 6 вариантов диапазонов (jar-файлы автоматически размещаются в dist/)
./gradlew buildAll

# Собрать текущий активный вариант (1.21.11-fabric)
./gradlew build

# Собрать конкретный загрузчик и целевую версию
./gradlew :1.18.2-fabric:build      # -> dist/authcore-1.16-1.18-fabric-1.0.0.jar
./gradlew :1.18.2-forge:build       # -> dist/authcore-1.16-1.18-forge-1.0.0.jar
./gradlew :1.21.11-fabric:build     # -> dist/authcore-1.19-1.21-fabric-1.0.0.jar
./gradlew :1.21.11-neoforge:build   # -> dist/authcore-1.19-1.21-neoforge-1.0.0.jar
./gradlew :26.2-fabric:build        # -> dist/authcore-26.1-26.2-fabric-1.0.0.jar
./gradlew :26.2-neoforge:build      # -> dist/authcore-26.1-26.2-neoforge-1.0.0.jar

🧪 Тестирование безопасности

AuthCore включает автономный стенд тестирования безопасности, расположенный в test/, с более чем 180 автоматическими модульными и криптографическими проверками:

# Скомпилировать и запустить полный набор тестов безопасности
./gradlew buildAll
test/run-security-tests.sh

# Запустить сквозную локальную валидацию (компиляция + набор тестов безопасности + дымовые тесты Docker-хоста)
./gradlew testAll

Проверяемые компоненты включают:

• Алгоритмы хеширования: Argon2id, BCrypt, SCrypt, PBKDF2, SHA-256 и прозрачное автообновление устаревших хешей.
• Криптографическая безопасность: Уникальность соли CSPRNG, сравнения с постоянным временем и предотвращение утечек по времени.
• Защита от эксплойтов и злоупотреблений: Жизненный цикл конечного автомата капчи, истечение срока действия SMTP-токена, разброс паттернов движения камеры и обнаружение параллельных ботоферм.
• Движок миграции: 18 автоматических проверок, валидирующих миграцию с устаревшего единого файла на разделённую конфигурацию.

🐳 Проверка в Docker (тесты на хосте)

Чтобы гарантировать безупречную стабильность во время работы, наш тестовый стенд параллельно запускает каждый jar-файл диапазона в реальных контейнерах серверов Minecraft, используя официальные образы JRE Eclipse Temurin:

# Execute smoke matrix across all loader targets
test/docker/run-tests.sh

# Execute full matrix across all range endpoints
test/docker/run-tests.sh --all

# Run specific version brackets
test/docker/run-tests.sh --groups 1.16-1.18 --java 17
test/docker/run-tests.sh --groups 1.19-1.21 --java 21
test/docker/run-tests.sh --groups 26.1-26.2 --java 25

Каждый автоматический тест проверяет:

1. Чистый запуск сервера с 0 ошибок и 0 серьёзных предупреждений.
2. Корректность баннера (скомпилированная строка версии, целевой загрузчик и среда Java).
3. Выполнение команд из админ-консоли (/authcore validate, /authcore reload, /authcore backup).
4. Генерацию конфигурации, инициализацию базы данных SQLite и привязку сетевого порта.

📚 Документация

Подробные руководства размещены на authcore.potenfyr.in:

❓ FAQ

🗺️ План развития

• [x] Универсальная поддержка нескольких загрузчиков: Единая кодовая база для Fabric, Forge и NeoForge от 1.16.0 → 26.x+.
• [x] 7-уровневая эшелонированная защита: Профилирование поведения, конечные автоматы пакетов, анализ паттернов взгляда и приманки.
• [x] Многофакторная аутентификация: Приложения-аутентификаторы TOTP, резервные коды восстановления и одноразовая верификация по email через SMTP.
• [x] Движок против злоупотреблений: Блокировки при брутфорсе, динамические капчи-действия, фильтры IP по CIDR и теневые баны.
• [x] Корпоративное хранилище: Высокопроизводительный SQLite (WAL), MySQL, PostgreSQL и шины событий SSO на Redis.
• [x] Браузерная веб-панель: REST-интерфейс администрирования с аутентификацией по токену и живыми метриками.
• [x] Паритет с прокси: Современный HMAC-форвардинг Velocity, определение устаревшего BungeeCord и безопасность по принципу fail-closed.
• [x] Строгость автоматизированного тестирования: 180+ автоматических криптографических и проверок безопасности с параллельными тестами на Docker-хостах.
• [x] Раздельная архитектура конфигурации: Отдельные конфиги по доменам (lobby.conf, session.conf, database.conf) с автоматической миграцией со старых версий.

📈 Активность, история звёзд и метрики

🌟 История звёзд в реальном времени

_{📈 Живой график звёзд, отрисованный через star-history.com. Обновляется в реальном времени, когда пользователи ставят звезду репозиторию.}

🤝 Сообщество и участие

Мы рады вкладу сообщества, сообщениям об ошибках и предложениям по функциям!

• Нашли баг или есть идея? Создайте issue в трекере задач или начните обсуждение в Discussions.
• Хотите отправить код? Форкните репозиторий, создайте ветку с понятным названием и отправьте Pull Request, соответствующий стандартам Google Java Format.
• Нужна поддержка сообщества или прямая помощь? Присоединяйтесь к нам в Discord!

📜 Лицензия

Этот проект распространяется под лицензией CC0 1.0 Universal (Public Domain). Вы можете свободно использовать, изменять, распространять и интегрировать AuthCore в личные, коммерческие или модпак-сборки без ограничений.

Создано с любовью студией PotenFYR Studios
Поддержка и вопросы: support@potenfyr.in