Ошибка в логах выглядит так:
io.netty.handler.codec.DecoderException: java.lang.IndexOutOfBoundsException: Index 26 out of bounds for length 9
или похожие варианты с другим числом. Обычно это происходит при подключении к серверу и клиент Minecraft получает данные в формате, который не совпадает с ожидаемым.
На практике чаще всего причина в несовпадении версий (клиент vs сервер) или в модах/плагинах, которые меняют сетевой протокол.
Как понять, что именно ломается
Схема почти всегда одна:
- Minecraft начинает подключение:
Connecting to ... :25565 - Затем сразу пишет
Client disconnected - В причине указан
Internal Exception: io.netty.handler.codec.DecoderException: java.lang.IndexOutOfBoundsException: ...
Такой DecoderException относится к сетевому разбору пакетов. То есть клиент видит пакет, который “должен быть короче/другой структуры”, чем пришедшие байты. Это типичный симптом несовместимости версий или протокола, а не проблем с видеодрайвером или Java “в целом”.
Шаг 1. Проверь версию Minecraft и совместимость
- Открой лаунчер и посмотри точную версию клиента (например, 1.20.x).
- На сервере в Aternos/на сайте сервера проверь версию, которая реально запускается.
- Сверь совпадение. Если сервер поднимается с другой сборкой (Fabric/Forge/Vanilla), тоже проверь совместимость.
Если версия отличается, начни с приведения к одному варианту. Это самый частый сценарий, когда подключение отваливается сразу после этапа чтения пакетов.
Шаг 2. Убери моды и плагины с сетевыми изменениями
Если ты играешь через модпак или Forge/Fabric, попробуй отключить все моды на время теста:
- Сделай чистый профиль в лаунчере.
- Запусти Minecraft только в выбранной платформе (Vanilla, Forge, Fabric) без модов.
- Подключись к серверу.
Если с чистым клиентом заходишь, значит причина в моде. Чаще всего виноваты моды, которые:
- добавляют новые сетевые пакеты,
- меняют синхронизацию сущностей или инвентаря,
- подменяют протокол, работают через “оптимизации”/клиент-сервер совместимость.
Для серверов с модами проверь список модов на сервере и поставь ровно то же на клиент. Aternos иногда скрывает, что сервер запущен с модом или особой сборкой.
Шаг 3. Проверь сборку: Forge/Fabric/Vanilla
Многие ошибки именно в связке “не та платформа”:
- сервер Forge, а клиент Vanilla
- сервер Fabric, а клиент Forge
- разные версии loader (Fabric Loader, Forge)
Убедись, что клиент и сервер используют одну платформу и близкие версии.
Шаг 4. Действия для сервера Aternos (если ты админ)
Если ты подключаешься к Aternos-серверу, проверь такие вещи:
- Отключи моды/датапаки, которые не нужны для теста.
- Переключи версию сервера на ту же, что у клиента.
- После изменений перезапусти сервер полностью.
- В модах проверь “совместимость версий” - если сервер обновили, а клиент остался прежним, именно это и дает DecoderException.
В похожих случаях пользователи описывали, что подключение ломается сразу и в логе повторяются сообщения о DecoderException и IndexOutOfBoundsException - с серверами, которые несогласованны по сборке/протоколу.
Частые ошибки
| Что сделано | Почему ломается | Что сделать |
|---|---|---|
| Клиент другой версии Minecraft, чем сервер | пакет не соответствует ожидаемой структуре | привести версии к одному номеру |
| Разные платформы (Forge/Fabric/Vanilla) | протокол и пакеты отличаются | поставить одинаковую платформу и loader |
| На клиенте есть моды, а на сервере нет или наоборот | сетевые изменения не совпадают | временно убрать моды, затем вернуть совместимые по списку сервера |
| Сервер обновился, но клиент остался на старом профиле | несовместимость “по умолчанию” | обновить клиент или откатить сервер до нужной версии |
Мини-чеклист для быстрого результата
- Совпади по версии клиента и сервера.
- Зайди чистым клиентом без модов.
- Если работает - включай моды обратно по одному, пока ошибка не вернется.
- Если ошибка не ушла - проверь платформу (Forge/Fabric/Vanilla) и loader-версии.
- Если ты админ Aternos - оставь только нужные сборки и моды, перезапусти сервер.
Полезные ссылки
- https://www.minecraftforum.net/forums/support/java-edition-support/3187521-problem-io-netty-handler-codec-decoderexception
- https://forums.minecraftforge.net/topic/119626-%C2%A0internal-exception-ionettyhandlercodecdecoderexception-javalangindexoutofboundsexception-readerindex19139-length1/
- https://forums.minecraftforge.net/topic/119593-1192-internal-exception-ionettyhandlercodecdecoderexception-javalangindexoutofboundsexception-readerindex12/