SmoothLogin
Асинхронный мод для входа, который убирает лаги при подключении игроков.
- Загрузчики
- FabricQuilt
- Скачиваний на Modrinth
- 33
- Подписчиков на Modrinth
- 1
- версия
- 1
- Обновлён
- 25 августа 202625 авг.
- Опубликован
- в 2026
Коротко о моде
Ставится только на сервер; игрокам ставить не нужно
SmoothLogin
Уберите файловую работу при входе из серверного потока и сохраните плавный вход игроков. SmoothLogin — серверный мод для Fabric, повышающий производительность: он асинхронно готовит данные игрока до того, как игрок войдёт в мир. NBT игрока, статистика и достижения читаются и разбираются в настраиваемом пуле воркеров, что снижает объём тяжёлой файловой работы, выполняемой в серверном потоке при массовых входах. Мод также включает опциональный набор инструментов для миграции UUID для серверов, меняющих режим аутентификации. Автоматическая миграция по умолчанию отключена и может быть включена явно после проверки конфигурации и создания резервной копии.
Зачем SmoothLogin?
Вход игрока затрагивает несколько файлов. Чтение NBT игрока и разбор статистики или достижений в основном потоке могут превратить медленное хранилище или множество одновременных входов в заметные подвисания тиков. SmoothLogin готовит эти данные в выделенных воркерах и передаёт подготовленный результат обратно в обычный процесс входа на сервере. Сохранения пользовательского кэша также сериализуются через асинхронный писатель, чтобы одновременные входы не перезаписывали обновления друг друга.
Возможности асинхронного входа
- Подготовка данных игрока вне потока — чтение NBT игрока без блокировки обычного цикла тиков сервера.
- Предварительно разобранные статистика и достижения — чтение файлов и разбор JSON происходят до того, как они понадобятся потребителю в основном потоке.
- Настраиваемый пул воркеров — выберите от 1 до 32 воркеров входа в зависимости от CPU и хранилища сервера.
- Сериализованная запись пользовательского кэша — предотвращает перезапись обновлений
usercache.jsonдруг другом при одновременных задачах входа. - Безопасное кэширование жизненного цикла — подготовленные данные привязаны к своему входу и очищаются после использования или отключения.
- Только на стороне сервера — игрокам не нужно устанавливать мод.
Опциональная миграция UUID
Изменения аутентификации могут назначить одному и тому же игроку другой UUID. SmoothLogin включает инструменты миграции для переноса данных, привязанных к UUID, между офлайн-режимом, аутентифицированными скин-станциями и аутентификацией Mojang.
- Автоматическая миграция по желанию — отключена по умолчанию; при включении она обнаруживает предыдущий UUID, связанный с тем же именем игрока, и мигрирует только при прохождении проверок политики и безопасности.
- Инструменты ручной миграции — просмотр истории идентичностей, привязка известного старого UUID, запуск миграции или отмена последней миграции без включения автоматической миграции.
- Широкий охват данных — поддерживает ванильные данные игрока, статистику, достижения, операторов, белый список и баны, а также поддерживаемые пути с именами UUID и ссылки на UUID в данных мира.
- Транзакционная безопасность — проверяет состояние источника и цели, создаёт резервные копии, записывает историю миграции и пытается выполнить откат при неудачной миграции.
- Защита от конфликтов — никогда не перезаписывает существующего целевого игрока автоматически. Неоднозначные случаи записываются для проверки администратором.
- Защита при входе — миграция отклоняется, пока исходный или целевой игрок онлайн или уже входит.
Поддерживаемое окружение
- Minecraft 26.1 или новее
- Fabric Loader 0.17.3 или новее
- Fabric API
- Выделенный сервер; установка на клиент не требуется
Установка
- Установите Fabric Loader и Fabric API на сервер.
- Поместите SmoothLogin в директорию
modsсервера. - Запустите сервер один раз, чтобы сгенерировать
config/smoothlogin.json. - Асинхронный конвейер входа работает с конфигурацией по умолчанию; настройка миграции не требуется.
- Если нужна миграция UUID, проверьте её настройки и сделайте полную резервную копию мира перед включением
autoMigrateили запуском команд миграции.
Команды
Все команды требуют прав администратора.
| Команда | Назначение |
|---|---|
| `/smoothlogin info ` | Показать совпадающие идентичности пользовательского кэша и последнюю запись миграции. |
| `/smoothlogin migrate ` | Обнаружить старую идентичность и запустить миграцию, когда это безопасно. |
| `/smoothlogin bind ` | Вручную мигрировать известный старый UUID на текущий разрешённый UUID игрока. |
| `/smoothlogin undo ` | Восстановить последнюю отменяемую миграцию, используя её точную резервную копию. |
/smoothlogin conflicts list | Показать неразрешённые конфликты миграции. |
| `/smoothlogin conflicts resolve <keep|old|new>` | Записать решение администратора без автоматического удаления файлов игрока. |
/smoothlogin automigrate | Показать, включена ли автоматическая миграция. |
/smoothlogin automigrate <on|off> | Включить или отключить автоматическую миграцию и сохранить настройку. |
/smoothlogin reload | Перезагрузить конфигурацию и применить настройки времени выполнения. |
Конфигурация
Файл конфигурации — config/smoothlogin.json.
| Опция | По умолчанию | Описание |
|---|---|---|
autoMigrate | false | Включить автоматическую миграцию UUID при входе. Асинхронная подготовка входа не требует этой опции. |
notifyPlayerOnMigrate | true | Уведомлять игрока после успешной миграции. |
| backupKeep | 10 | Количество сохраняемых резервных копий миграции. | | migratePlayerdata | true | Переносить инвентарь, местоположение и другие NBT игрока. | | migrateStats | true | Переносить статистику. | | migrateAdvancements | true | Переносить достижения. | | migrateOpsWhitelistBans | true | Синхронизировать записи операторов, белого списка и банов. | | skinStationNamesUnique | true | Разрешить автоматическую миграцию по именам для настроенной среды аутентификации. Отключите, если уникальность имён не гарантируется. | | strictMode | false | Отклонять менее надёжные доказательства по именам и требовать ручной проверки. | | usercacheMaxEntries | 10000 | Максимальное количество сохраняемых записей кэша пользователей. | | loginThreadPoolSize | 4 | Рабочие потоки для подготовки входа; допустимый диапазон — 1–32. |
Важные замечания
- Миграция UUID — необязательная функция, она не требуется для асинхронной подготовки входа.
- SmoothLogin не может доказать, что две личности принадлежат одному человеку, при любой настройке аутентификации. Если включаете автоматическую миграцию, используйте
strictMode, отключитеskinStationNamesUniqueили применяйте ручную привязку, когда имена не являются надёжным якорем идентичности. - Автоматическая миграция требует пригодной истории идентичности, обычно из кэша пользователей сервера.
- Существующие данные по целевому UUID считаются конфликтом и не перезаписываются.
- Держите независимую полную резервную копию сервера. Транзакционные резервные копии SmoothLogin предназначены для отдельных миграций, а не для замены обычной политики резервного копирования. Лицензировано под GPL-3.0-only.
Частые вопросы
Как установить SmoothLogin?
Установите Fabric под свою версию Minecraft, скачайте SmoothLogin под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.
Для каких версий Minecraft есть SmoothLogin?
У SmoothLogin есть сборки для Minecraft 26.1–26.2.
Нужен ли SmoothLogin на сервере?
Ставится только на сервер; игрокам ставить не нужно