AuthBack

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

от litetexУправление Технологии Утилиты

Fabric

Загрузчики: Fabric
Скачиваний на Modrinth: 4,6 тыс.
Подписчиков на Modrinth: 24
версий: 17
Обновлён: 17 сентября 202617 сент.
Опубликован: в 2025

В избранное Следить за обновлениямиСледить

Коротко о моде

Работает на Fabric

Для Minecraft 1.21.10–26.3

Работает и в игре, и на сервере — ставьте, где нужен

Последняя версия — 1.9.0 от 17 сентября 2026

Нужен Fabric API

Лицензия AGPL-3.0-only — бесплатно

Где нужен

В игренеобязателенНа серверенеобязателен

Работает и в игре, и на сервере — ставьте, где нужен

Версии игры1.21.10–26.3

Описание переведено автоматическиПоказать оригинал (EN)

Позволяет играть как обычно, даже когда серверы аутентификации Mojang недоступны. Дополнительно улучшает работу с сетью.

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

Ответы от веб-сервисов/API Mojang кэшируются локально на некоторое время.
Если случается сбой, используются ранее закэшированные ответы.
Например, это позволяет корректно отображать ваш скин.
Каждый клиент локально хранит (или генерирует, если его нет) пару ключей, которая будет использоваться как запасной вариант для аутентификации на серверах, когда серверы аутентификации Mojang недоступны (см. Public-key cryptography).
Обратите внимание:
- На сервере тоже должен быть установлен мод
- Вы должны хотя бы раз заходить на сервер ранее (в течение последних 36 дней)

Мод необязателен как для клиента, так и для сервера.
Однако если на одной из сторон мода нет, подключиться к серверу будет невозможно, когда серверы аутентификации/API Mojang недоступны.

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

Команда

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

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

Клиент

Настроить мод можно через

Options > Online... > AuthBack...
или, если установлен ModMenu: Mods > AuthBack > Click Icon/Settings

Общее

Конфигурация динамически загружается из (отсортировано по убыванию приоритета)

Переменные окружения
- с префиксом ``AUTHBACK_``
  - где variant — это либо SERVER, либо CLIENT
- с префиксом AUTHBACK_
- все свойства записываются в ВЕРХНЕМ РЕГИСТРЕ и используют _ вместо . или -
Системные свойства
- с префиксом ``authback.``
  - где variant — это либо server, либо client
- с префиксом authback.
Файл конфигурации, расположенный в ``.config/authback-.json``
- где variant — это либо server, либо client

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

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

Общие (клиент и сервер)

Свойство	Тип	По умолчанию	Примечания
`discovery-cache.default-reuse-minutes`	`int`	`120` (2ч)	Ответ эндпоинта `discovery` API Mojang почти никогда не меняется. Этот параметр указывает моду повторно использовать последний сохранённый ответ в течение заданного количества минут вместо повторного обращения к API. Использование кэшированного ответа намного быстрее и экономит сетевой трафик при частых перезапусках игры.
`global-public-keys-cache.default-reuse-minutes`	`int`	`120` (2ч)	То же, что и `discovery-cache` выше, но для `global-public-keys`. На момент написания этой документации ключи не менялись последние 3+ года.
`game-profiles.delete-after-days`	`int`	`36`	36 дней выбрано значением по умолчанию, потому что при смене имени игрока это имя становится недоступным на 37 дней
`game-profiles.max-cache-size`	`int`	`250`	Максимальное количество игровых профилей, хранимых в кэше. Если размер превышает максимум, самые старые записи удаляются, пока список не достигнет 90% от заданного максимума.
`username-to-id-resolver.use-vanilla`	`bool`	`false`	Использовать оригинальный/«ванильный» преобразователь имени пользователя в id
`username-to-id-resolver.expire-after-days`	`int`	`36`	Количество дней, после которых запись кэша будет удалена. 36 дней выбрано значением по умолчанию, потому что при смене имени игрока это имя становится недоступным на 37 дней. Ванильная реализация использует 1 месяц.
`username-to-id-resolver.refresh-before-expire-days`	`int`	`14`	Количество дней до истечения срока, когда кэшированная запись будет обновлена при обращении к ней.
`username-to-id-resolver.max-cache-size`	`int`	`1000`	Максимальное количество имён пользователей и id, хранимых в кэше. Если размер превышает максимум, самые старые записи удаляются, пока список не достигнет 90% от заданного максимума.
`username-to-id-resolver.resolve-offline-users-by-default`	`bool`	`true`	Следует ли кэшировать офлайн-пользователей (например, невалидированные аккаунты)?. Обратите внимание кэш офлайн-пользователей полностью отделён от кэша онлайн-пользователей и никогда не сохраняется на диск. Это только начальное значение Клиенты всегда разрешают офлайн-пользователей, а сервер делает это только когда `online-mode` отключён
`username-to-id-resolver.update-on-game-profile-fetch`	`bool`	`true`	При получении gameprofile: следует ли передавать информацию в username-to-id-resolver/кэш? Кэш будет обновлён только при необходимости (например, неизвестное имя пользователя/id или отсутствующая запись)
`username-to-id-resolver.use-game-profile-cache`	`bool`	`true`	Использует GameProfileCacheManager как вторичный кэш, когда все первичные кэши не срабатывают. Использование должно быть крайне редким, но может произойти, если кэш был, например, повреждён
`skip-extract-profile-action-types`	`bool`	`false`	Опция отладки

Сервер

Свойство	Тип	По умолчанию	Примечания
`keys.max-keys-per-player`	`int`	`3`	Максимальное количество публичных ключей, хранимых для одного игрока
`keys.delete-after-unused-days`	`int`	`36`	Если пользователь не входит с публичным ключом в течение этого времени, ключ будет удалён. 36 дней выбрано по умолчанию, потому что при смене имени игрока оно становится недоступным на 37 дней
`fallback-auth.allow-always`	`bool`	`true`	Всегда разрешает использование резервной аутентификации. Установите `false`, если хотите разрешать резервную аутентификацию только когда сервер не может связаться с API Mojang во время входа игрока
`fallback-auth.rate-limit.requests-per-ip-per-minute`	`int`	`20`	Значение по умолчанию допускает запросы каждые 3с. Если установить 0 или меньше, ограничение частоты будет отключено
`fallback-auth.rate-limit.bucket-size`	`int`	`1000`	Количество IP-адресов для хранения (в памяти)
`fallback-auth.rate-limit.ignore-private-addresses`	`bool`	`true`	Следует ли НЕ ограничивать частоту для приватных IP-адресов?
`fallback-auth.rate-limit.ipv6-network-prefix-bytes`	`int`	`8`	Байты (не биты!) сетевого префикса для IPv6. Значение по умолчанию `8` соответствует `/64`.
`force-disable-enforce-secure-profile`	`bool`	`true`	Принудительно отключает `enforce-secure-profile`
`skip-old-user-conversion`	`bool`	`true`	Пропускает миграцию файлов пользователей, использовавшихся серверами до `1.7.6` (выпущена 2014-04). Крайне маловероятно, что это нужно серверу, и требует обращения к API Mojang. Поэтому миграция пропускается по умолчанию
`disable-legacy-query-handler`	`bool`	`true`	Отключает устаревший обработчик query/ping до 1.7 (выпущена 2013-10)
`log-connection-init-ips`	`bool`	`false`	Логирует все удалённые IP, инициирующие/начинающие соединение, на уровне INFO

Клиент

Все клиентские настройки можно изменить / они описаны в интерфейсе настроек игры (см. выше).

FAQ

Где найти свой публичный ключ?

Публичный ключ можно найти/скопировать в

Options > Online... > AuthBack... > Key management
или, если установлен ModMenu: Mods > AuthBack > Click Icon/Settings > Key management

Серверы аутентификации недоступны, я установил мод на свой сервер, но не могу зайти

Это потому, что сервер не знает ваш публичный ключ.

Исправить это можно так:

Убедитесь, что вы заходили на сервер меньше месяца назад
- это потому, что записи в usercache.json — которые будут использованы в таком случае — истекают через месяц
Убедитесь, что можете выполнять команды через консоль сервера/RCON
Добавьте мод в свой локальный клиент/игру и запустите её
и скопируйте оттуда публичный ключ (подробности см. выше)
Затем свяжите публичный ключ на сервере со своим аккаунтом:
- `/authback public_key add name `
- или `/authback public_key add id `

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

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

Серверы аутентификации недоступны, мой друг установил мод, но не может зайти на мой сервер

Это потому, что он никогда раньше не заходил с модом.

Исправить это можно так, если вы админ:

Скажите другу запустить игру с модом
и отправить вам свой публичный ключ (см. «Где найти свой публичный ключ?» выше)
Свяжите публичный ключ на сервере с ним, выполнив `/authback public_key add name `

Как проверить резервную аутентификацию?

Убедитесь, что сервер знает ваш публичный ключ (проверить это на сервере можно командой /authback public_key list)
Убедитесь, что на сервере включён fallback-auth.allow-always (по умолчанию он должен быть включён)
Запустите клиент в офлайн-режиме
Включите Suppress any joinServer error в настройках клиента
Теперь вы сможете подключиться к серверу с помощью резервной аутентификации. Подробности смотрите в логе.

Где мод хранит свои данные?

В папке игры (например, %APPDATA%\.minecraft) внутри директории .mods\authback.

Частые вопросы

Как установить AuthBack?

Установите Fabric под свою версию Minecraft, скачайте AuthBack под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.

Для каких версий Minecraft есть AuthBack?

У AuthBack есть сборки для Minecraft 1.21.10–26.3.

Нужен ли AuthBack на сервере?

Работает и в игре, и на сервере — ставьте, где нужен

Лицензия и источник

GNU Affero General Public License v3.0 onlyможно использовать и распространять; изменённые версии — под той же лицензией и с исходным кодом

Оригинал — Modrinth↗Файлы — без изменений, проверены по SHA-512Это ваш мод? Правообладателям

Скачать для моей игры

Скачать1.9.0 · для 26.3 · Fabric · 328 КБ

Все версии (17)без таймеров и рекламы

Скачать1.9.0 · 328 КБ

Совместимость