Ошибки подключения к серверу Minecraft и как их исправить

Коротко: Connection refused, Connection timed out и Unknown host значат, что клиент не достучался до сервера — сервер выключен, порт закрыт или не проброшен, адрес с ошибкой. Failed to verify username, Invalid session и Incompatible client — сервер ответил, но не пустил: не подтвердился аккаунт Mojang или не совпали версии. You are not white-listed, The server is full и You logged in from another location — сработало правило сервера. Ниже — каждая ошибка с причиной и решением.

Как читать текст ошибки#

Сообщения самой игры русский клиент показывает в переводе: «Не удалось проверить имя пользователя!» — это Failed to verify username!. Сетевые ошибки Java не переводятся: под заголовком «Не удалось подключиться к серверу» стоит строка вида io.netty.channel.AbstractChannel$AnnotatedConnectException: Connection refused: <адрес> — сетевая библиотека игры Netty дописывает к ошибке адрес, к которому шёл клиент. Часть сообщений Paper берёт из spigot.yml: по умолчанию они на английском при любом языке клиента, и их можно перевести.

Вторая половина картины — лог сервера logs/latest.log. После запуска в нём есть строка Starting Minecraft server on *:25565: звёздочка значит, что сервер слушает все адреса машины, число — порт. Если вместо неё **** FAILED TO BIND TO PORT!, порт занят или в server-ip вписан чужой адрес — Minecraft Wiki советует оставлять server-ip пустым. Как разбирать лог — в статье логи и краши.

Клиент не достучался до сервера#

Разница между refused и timed out подсказывает, где искать. По Minecraft Wiki, refused значит, что на порту нет процесса и система сама сообщила клиенту об отказе, а timed out — что фаервол проигнорировал попытку подключения. Брандмауэр Windows и большинство домашних роутеров по умолчанию именно молчат, поэтому timed out встречается чаще.

Проверка по шагам: где обрывается связь

1. 1

   Сервер слушает порт

   В логе есть строка Starting Minecraft server on, а на Linux ss -tlnp показывает процесс java на нужном порту. Нет — проблема в самом сервере, а не в сети.

2. 2

   Зайдите с той же машины

   Адрес localhost (с портом через двоеточие, если он не 25565). Работает — сервер в порядке, ищите проблему в сети.

3. 3

   Зайдите из той же сети

   По внутреннему IP вида 192.168.1.20 — как его узнать, в статье как узнать IP сервера. Не работает — фаервол на компьютере с сервером.

4. 4

   Проверьте снаружи

   Проверкой сервера онлайн или с мобильного интернета. Не работает только снаружи — проброс порта или NAT провайдера. Для домена с нестандартным портом проверьте SRV-запись: её поля соберёт генератор SRV-записи.

# 1. сервер слушает порт (Linux): в выводе должен быть процесс java
ss -tlnp | grep 25565

# 2. строка в logs/latest.log после запуска
[Server thread/INFO]: Starting Minecraft server on *:25565

Сервер ответил, но не пустил#

Какую версию держать на сервере, чтобы таких ошибок было меньше, — в статье какую версию выбрать. ViaVersion выходит через несколько дней после обновления игры, поэтому сразу после релиза новой версии Outdated server у игроков с обновлённым клиентом — нормально.

Сработало правило сервера#

Ошибки в сети за Velocity#

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

• Unable to connect you to <сервер>. Please try again later. — прокси не смог подключить игрока к серверу из [servers]: тот выключен, ещё запускается или адрес в velocity.toml неверный.
• There are no available servers to connect you to. Try again later or contact an admin. — не отвечает ни один сервер из списка try.
• Your server did not send a forwarding request to the proxy. Make sure the server is configured for Velocity forwarding. — на игровом сервере не включена передача данных игроков: proxies.velocity.enabled: true в config/paper-global.yml.
• You are already connected to this proxy! — второй вход под тем же ником. По умолчанию (kick-existing-players = false) Velocity не пускает новое подключение, а первое не трогает.
• You are not logged into your Minecraft account. … — аналог Failed to verify username на прокси с online-mode = true.

Порядок настройки прокси, секрет передачи данных и файрвол для серверов за ним — в статье настройка Velocity.

Ошибка подключения или наказание античита#

Когда игрок пишет «меня выкинуло», сначала отделите сетевую ошибку от наказания. Тексты выше выдают игра, Paper и Velocity; кик или бан античита видно в журнале. DGuard — лучший античит для современного сервера Minecraft — ведёт в панели журнал наказаний с отчётами, если в plugins/DGuard/config.yml включён punishment-log: true: кого, когда и за какой чит наказали, с выгрузкой в CSV. Игрока в журнале нет — ищите причину в таблицах выше.

Самый неприятный случай — Connection refused у всех сразу, потому что сервер упал. Панель DGuard замечает и его: если сервер 10 минут не выходит на связь, DGuard пишет в Telegram или на почту вам и администраторам команды — и ещё раз, когда сервер вернётся. Входящих портов DGuard не открывает, ему нужен только исходящий HTTPS; он работает за Velocity и BungeeCord, а игроков с клиентов 1.21–26.x, зашедших через ViaVersion, проверяет так же, как остальных.

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