JarsAuth

JarsAuth

Описание сгенерировано ChatGPT и вычитано автором мода.
В случае неоднозначности обращайтесь к китайским текстам.

Подробное описание на китайском смотрите на 客户端管理 (JarsAuth) - MC百科|最大的Minecraft中文MOD百科

Если хотите оставить комментарий, перейдите в GitHub Discussion

Важное уведомление

Мод обновлён до версии 6.0. Это крупное обновление, и конфигурации НЕ совместимы с версиями 5.x и более ранними. Поэтому:

• Конфигурации на стороне сервера необходимо создать заново
• Клиентам также нужно обновить мод, но конфигурация на стороне клиента не требуется
• В версии 5.x есть критический баг, вызывающий аномально высокую нагрузку на CPU, и она больше не рекомендуется Эта проблема исправлена в 6.0

Изменения в системе конфигурации

• Все конфигурации перенесены в базу данных SQLite

• Разрозненные файлы конфигурации больше не создаются

• Схема базы данных одинакова во всех версиях, что упрощает миграцию

• Предусмотрен встроенный инструмент настройки:

  • Точка входа: новая кнопка Manager внизу серверного GUI
  • Настройку необходимо выполнять в среде с поддержкой GUI
  • Если на вашем сервере нет GUI:
  • Сначала настройте локально
  • Затем скопируйте файл базы данных на сервер
  • Поддержка удалённой настройки может появиться в будущем

• JAR мода также можно запустить как исполняемый JAR, автоматически используя файл базы данных в рабочей директории

• Инструмент настройки содержит подробные пояснения → Наведите курсор на кнопки, чтобы увидеть подсказки

Общее поведение

• Все функции опциональны и отключены по умолчанию

  • Если не вносить изменения в конфигурацию, мод ведёт себя так, будто он не установлен

• Функции работают только на выделенных серверах

  • Поддерживаемые среды: Forge, Fabric, Arclight, Mohist и т.д.
  • Одиночная игра и миры по локальной сети не затрагиваются

• Все сообщения хранятся в языковых файлах (*.json)

  • Если нужно их изменить, распакуйте JAR, отредактируйте, затем упакуйте обратно перед релизом

• Чтобы обеспечить право игроков на информацию, обо всех включённых функциях игрокам сообщается в виде системных сообщений при каждом подключении. Это сообщение обязательно и не может быть отключено.

• Из-за ограниченных ресурсов разработки:

  • Поддерживаются только Minecraft 1.20.1 и более поздние (стабильные релизы)
  • 1.20.1 — последняя версия для Forge
  • Разработка затем перейдёт на NeoForge
  • Возможна разработка на заказ по запросу

Функция 1 – Контрольная сумма файлов

Это изначальная функция мода.

Случаи использования

Обычно загрузчики модов проверяют только совпадение обязательных модов между клиентом и сервером. Они не обнаруживают:

• Клиентские моды (например, миникарты, моды для производительности, читерские моды)
• X-ray или другие ресурспаки

Это серьёзно влияет на честность игры. Традиционные меры противодействия (например, фейковые руды) могут повредить данные чанков или вызвать лаги.

Функция контрольной суммы файлов в этом моде позволяет:

• Проверить, что все клиентские файлы, включая клиентские моды, совпадают с версиями, использованными при создании модпака
• Обнаружить несанкционированные клиентские файлы

Примеры:

• Если миникарты не разрешены, клиентам с модом миникарты будет отказано в подключении
• Если миникарты обязательны, клиентам без них также будет отказано

• Если сервер обновляет некоторые моды, а клиенты — нет:

  • Проверки загрузчика модов могут всё ещё проходить
  • Несовпадение версий может повредить данные сервера → Этот мод может блокировать устаревших клиентов, отключая их канал валидации

Как это работает

1. Мод сканирует все настроенные файлы и вычисляет их хеш-значения
2. Все хеши объединяются в единую подпись клиента

3. Когда клиент подключается:

   • Сервер периодически отправляет список файлов для проверки
   • Клиент вычисляет и возвращает свою подпись
4. Если подпись отсутствует в записях сервера, соединение отклоняется

Важные изменения в конфигурации

• Поддерживается групповое управление с наследованием
• Разные группы клиентов могут иметь разные правила проверки

• Фильтры поддерживают:

  • Простые подстановочные знаки
  • Регулярные выражения
• Фильтры исключений позволяют игнорировать файлы, которые не нужно проверять (например, .DS_Store, desktop.ini)

Функция 2 – Аутентификация клиента

Эта функция работает аналогично системе входа.

Сценарии использования

На серверах в offline-режиме личность игрока определяется только по имени пользователя, что делает подмену лёгкой.

Эта функция добавляет отдельный механизм аутентификации, не позволяя другим игрокам войти под тем же именем пользователя.

Как это работает

• Когда игрок заходит:

  • Сервер проверяет, существует ли ID (UUID) для этого имени пользователя

• Если его нет:

  • Игрок считается входящим впервые

• Если он есть:

  • Сервер запрашивает ID у клиента
  • Если клиент не может предоставить его в течение отведённого времени, соединение отклоняется

• При первом входе:

  • Сервер генерирует ID, привязанный к имени пользователя
  • ID отправляется клиенту и сохраняется на стороне сервера
  • Затем клиент отключается и должен переподключиться для проверки

Функция 3 – Лицензия сервера

Эту функцию можно использовать как защиту от переигрывания.

Сценарии использования

Серверы могут хотеть:

• Ограничить время игры игроков
• Требовать явного разрешения владельца сервера

Эта функция предоставляет тонко настраиваемую систему вайтлиста, где:

• Сервер выдаёт лицензии
• Подключаться могут только игроки с действительными лицензиями

• Лицензии включают:

  • Время истечения
  • Тип
  • Квоту использования

Как это работает

При входе сервер проверяет лицензию игрока:

• Нет лицензии
• Лицензия истекла
• Квота лицензии исчерпана

→ Соединение отклоняется Лицензии также периодически перепроверяются во время игры.

Эта функция полностью серверная и не требует обмена данными с клиентом.

Важные изменения в конфигурации

• Пользователи и правила поддерживают группировку с наследованием
• Удалён тип лицензии, основанный на «количестве подключений»
• Добавлены периодические лицензии, которые автоматически сбрасывают или очищают квоты

Функция 4 – Подпись и обфускация (бета)

Примечание: Эту функцию нужно использовать внутри среды Minecraft. Запуск JAR напрямую её не поддерживает.

Сценарии использования

Серверы могут хотеть, чтобы игроки использовали только модпак, предоставленный сервером.

Эта функция позволяет:

• Экспортировать подписанные пакеты модов для обеспечения уникальности
• Генерировать конфиги обфускации ProGuard в один клик

Важное уведомление

• На странице релиза мода предоставляются только неподписанные пакеты («оригинальные пакеты»)
• Подписанные пакеты никогда не распространяются через публичные веб-ресурсы
• Владельцы серверов должны сами решать, использовать ли подписанные/обфусцированные версии

Установка

Начиная с 6.0 строгие проверки сетевых каналов удалены. Клиент и сервер могут работать независимо, не ломая игровой процесс.

Этапы подготовки

1. Завершите сборку модпака и убедитесь, что:

   • Все моды и файлы размещены правильно
   • Сервер и клиент запускаются и подключаются нормально
2. Скачайте оригинальный пакет
3. Поместите его в папки mods и на сервере, и на клиенте
4. Запустите сервер
5. Откройте инструмент настройки через GUI сервера
6. Включите или отключите нужные функции на вкладке Config

Подписывание (необязательно)

• На вкладке Signing:

  • Сгенерируйте:

  • *-signed.jar (сервер)
  • *-signed-expanded.jar (клиент)
  • Они должны совпадать точно

• Также создаётся файл config.pro

  • Импортируйте его в ProGuard, чтобы сгенерировать:

  • *-signed-expanded-obj.jar
• Обфускация применяется только к клиентским пакетам

• Замените:

  • Серверный мод на подписанный серверный JAR
  • Клиентский мод на соответствующий подписанный/обфусцированный JAR
• Перезапустите сервер

Процесс проверки контрольных сумм файлов

1. Запустите клиент и сервер
2. Выполните /jarsauth record on на сервере (Проверка контрольных сумм файлов должна быть включена)
3. Клиент подключается → файлы записываются → клиент отключается
4. Переключите страницы инструмента настройки, чтобы обновить интерфейс
5. Выполните /jarsauth record off
6. Выберите группы клиентов и настройте фильтры → Изменения применяются сразу

Примечания по аутентификации клиентов

• Инструмент настройки показывает:

  • ID сервера
  • Все записанные ID клиентов

• Чтобы отозвать игрока:

  • Удалите его запись ID

• На стороне клиента:

  • В корневой директории клиента создаётся файл базы данных
  • В нём хранятся все соответствия имени пользователя и ID

  • Обязательно делайте резервную копию

  • Потеря → невозможно войти
  • Утечка → риск подмены аккаунта
  • Использование на нескольких устройствах → копируйте файл базы данных

Примечания по лицензии сервера

• Настройте группы в инструменте
• Обязательная группа default применяется ко всем пользователям

• Игроки могут состоять в нескольких группах

  • Связь групп — ИЛИ
  • Если в любой группе остался лимит, доступ предоставляется

• Лимит всех групп уменьшается одновременно

  • Эффективный лимит = наибольший доступный среди групп

Уведомление о перезагрузке конфигурации

• Перезагрузка конфигурации больше не поддерживается
• Включение/отключение функций требует перезапуска сервера
• Остальные изменения конфигурации вступают в силу сразу

Слова автора мода

Эта часть перенесена на GitHub.