Mismatched mod list и Timed out: почему игрок не заходит на сервер модов

Игрок нажимает «Подключиться», и вместо игры появляется окно с ошибкой: «Mismatched mod list» или «Timed out». Оба сообщения выглядят как поломка сервера, но чаще всего это несовпадение сборок. Разберём, что говорит каждое сообщение, и как быстро найти виновника.

Коротко

Mismatched mod list (у Forge и NeoForge формулировка зависит от версии загрузчика: сообщения о несовпадении списка модов или каналов обмена) означает, что список модов или их версии у игрока и на сервере различаются. Исправляется сверкой сборки: одинаковая версия Minecraft, загрузчика и каждого мода. Timed out — обрыв связи: сервер или клиент перестал отвечать вовремя. Частые причины — тяжёлый вход, нехватка памяти и медленная загрузка модов. Для обоих случаев первый шаг — посмотреть консоль и сверить сборку.

Что значит mismatched mod list

Сообщение появляется при входе, когда клиент и сервер обмениваются списком модов. Текст и место проверки зависят от загрузчика. В Forge и NeoForge клиент и сервер сверяют не только список модов, но и каналы обмена данными. Если хоть один канал у игрока не совпадает с сервером, вход отклоняется. У Fabric проверка мягче: если мод не требует наличия на клиенте, игрок может зайти и столкнуться с ошибкой позже, когда сервер пришлёт содержимое, которого у клиента нет. Мод, который обязан быть и на сервере, и у игрока, отклонит вход сразу.

Поэтому точной формулировки в ошибке может не быть, а причина одна: разные моды или версии. Типичные варианты:

у игрока стоит клиентский мод, которого нет на сервере (например, шейдеры не влияют на вход, а мод с новыми блоками влияет);
у игрока другая версия мода: сборка обновилась на сервере, а игрок не обновил лаунчер;
у игрока не та версия загрузчика или Minecraft;
на сервере осталась лишняя серверная версия мода, которой нет у игрока.

Симптом → причина → решение

Что видит игрок	Почему так	Что сделать
`Mismatched mod list` сразу при входе	моды или версии различаются	выровнять сборку у игрока и на сервере
Ошибка появилась после обновления сборки	на сервере новая версия, у игрока старая	обновить сборку у игрока в лаунчере
Ошибка только у одного игрока	у него лишний клиентский мод	убрать мод у игрока или поставить тот же набор
`Timed out` при входе, сервер работает	долгая загрузка модов или нехватка памяти	проверить память и консоль, см. ниже
`Timed out` в середине игры	обрыв связи, перегрузка сервера	смотреть TPS, сеть, «Can’t keep up!» в логе
Ошибка «Unsupported class file» в логе сервера	не та версия Java	поставить Java, которую требует ядро

Как сверить сборку

Версия игры. Версия Minecraft у игрока и на сервере — одна и та же (например, 1.20.1). Проверяется в лаунчере и на странице сервера.
Загрузчик. Forge, NeoForge или Fabric — одинаковый. Версия загрузчика тоже важна: NeoForge 21.1.x и 21.1.y могут не совпадать.
Список модов. Сравните список на сервере (раздел «Моды и плагины» → «Установлено») и список у игрока (его лаунчер или папка mods/).
Версии модов. Одинаковое название не значит одинаковая версия. Если в списке разные версии одного мода, ставьте одну.
Клиентские моды. Шейдеры, миникарты и интерфейсы не должны мешать входу. Если сомневаетесь, временно уберите клиентский мод у игрока и проверьте вход.

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

Что делать с Timed out

Timed out — не всегда сеть. Minecraft разрывает соединение с этим сообщением, когда одна из сторон не отвечает на служебные проверочные пакеты (keep-alive) около 30 секунд. Чаще всего сервер просто не успевает ответить на запрос клиента: например, при входе сервер грузит тяжёлую сборку или не хватает памяти, и соединение обрывается по таймауту.

Раздел «Доктор сервера» с зависимостями и причиной падения

Порядок проверки:

Консоль. Откройте «Консоль» и посмотрите, что происходит в момент входа игрока. Строки Can't keep up! говорят о нагрузке. Строки Out of memory — о памяти.
Память. Посмотрите график памяти. Если сервер близок к лимиту, повысьте тариф или уменьшите число модов.
Первый вход. Сервер после запуска может долго генерировать мир и кэши. Дайте ему время, прежде чем пускать игроков.
Игрок. Пусть игрок выделит своему клиенту больше памяти. Для тяжёлых сборок 6–8 ГБ в настройках лаунчера — частый ориентир.
Сеть. Если Timed out случается только у одного игрока, проверьте его соединение и попробуйте другую сеть.

Если сервер падает, а не просто разрывает соединение, пользуйтесь «Доктором сервера»: окно «Почему сервер не запускается» покажет причину по логам и предложит поставить недостающий мод или отключить виновника одной кнопкой.

Пример: вход после обновления сборки

Вы обновили сборку на сервере, а двое игроков жалуются на «Mismatched mod list». Что делаете:

Сравниваете версию сборки в панели (раздел «Моды» показывает, какая сборка стоит на сервере) с версией в лаунчере игроков.
Видите, что у игроков осталась прошлая версия: у одного в списке мод старой версии, а на сервере уже новая.
Просите игроков обновить сборку в лаунчере до той же версии.
Проверяете вход сами на новой сборке.
Если у кого-то не заходит, снова сверяете список модов из «Установлено» и список у игрока.

Проверка со стороны игрока

Иногда ошибка видна только в клиенте. Игрок может найти причину сам, если посмотрит журнал лаунчера:

Откройте лаунчер, найдите профиль сборки и папку игры.
Откройте logs/latest.log в этой папке и найдите последние строки после попытки входа.
Ищите слова mismatch, missing, disconnect и название мода.
Сравните версию мода в папке mods/ с версией на сервере.

Такой журнал — лучший способ объяснить игроку, что исправить. Попросите его прислать фрагмент лога, а не просто «не заходит».

Что написать игрокам

Когда вы меняете сборку, игрокам нужен понятный анонс. Вот шаблон:

Обновили сборку до версии 1.4.0. Чтобы зайти, обновите профиль в лаунчере до этой же версии. Если ошибка «Mismatched mod list» осталась, пришлите нам фрагмент logs/latest.log.

Короткий анонс с номером версии сэкономит десятки одинаковых вопросов в поддержке.

Пример: один игрок и Timed out

Вход у одного игрока обрывается по Timed out, у остальных всё нормально. Что проверяем:

Консоль в момент его входа: нет ли Can't keep up! и других предупреждений о нагрузке.
Версия сборки у игрока: совпадает ли она с сервером.
Соединение игрока: попробуйте другую сеть или Wi-Fi.
Если повторяется, попросите игрока выделить клиенту больше памяти и повторить вход.

Если Timed out есть у всех и сервер при этом не падает, смотрите память и график нагрузки: это почти всегда признак нехватки ресурсов.

Частые ошибки

Меняют сборку на сервере и забывают сообщить игрокам. Игрок продолжает играть на старой версии. Пишите анонс со ссылкой на версию сборки.
Ставят клиентские моды на сервер ради «совместимости». Это не решает ошибку, а ломает сервер.
Винят сеть без проверки. Большинство Timed out на сервере с модами — нагрузка или память, а не провайдер.
Не смотрят консоль. Причина почти всегда записана в логе.

Итог

Mismatched mod list — несовпадение модов, исправляется сверкой сборки у игрока и на сервере. Timed out — обрыв связи, часто из-за тяжёлого входа и памяти. Первый шаг в обоих случаях один: открыть консоль, посмотреть момент входа и сверить версии. Если сборка совпадает, а ошибка остаётся, смотрите память и логи.

Дальше по теме:

Вопросы и ответы

Что значит «Mismatched mod list»?

Список модов или их версии у игрока и на сервере различаются. Сверьте версию Minecraft, загрузчика и каждого мода.

Почему появляется Timed out при входе?

Сервер не успевает ответить вовремя: тяжёлая загрузка модов, нехватка памяти или перегрузка. Проверьте консоль и память.

Нужно ли ставить на сервер клиентские моды, чтобы исправить ошибку?

Нет. Клиентские моды на сервере обычно ломают запуск. Ошибку исправляют сверкой списка у игрока.

Что делать, если сборка совпадает, а ошибка остаётся?

Посмотрите консоль в момент входа, память и версию Java. Если сервер падает, откройте «Доктора сервера».