Disconnect Packet Fix

Мод Disconnect Packet Fix для Minecraft — исправление багов сети на сервере

Disconnect Packet Fix — это утилита для серверов Minecraft, работающая на загрузчиках Fabric и NeoForge. Мод решает проблему, известную как баг MC-271325, которая приводит к тому, что сервер начинает бесконечно заполнять консоль ошибками (stacktraces) при попытке отправить клиенту пакет разделения. Решение базируется на перехвате кода на уровне миксинов, позволяя избежать сбоя в сетевом стеке Netty.

Проблема: спам ошибок в консоли сервера

На серверах Minecraft, работающих на загрузчиках Fabric и NeoForge, может возникать критическая ошибка, известная как баг MC-271325. Проблема проявляется в том, что при попытке сервера отправить клиенту пакет разделения (clientbound/minecraft:disconnect) возникает исключение EncoderException. Вместо корректного завершения соединения или игнорирования события, сервер генерирует длинные стектрейсы исключений, которые быстро заполняют консоль администратора. Это затрудняет мониторинг и управление сервером, так как полезная информация теряется среди повторяющихся сообщений об ошибке отправки неизвестного пакета.

Пример ошибки в логах

[22:35:52] [Netty Epoll Server IO #5/ERROR]: Error sending packet clientbound/minecraft:disconnect
io.netty.handler.codec.EncoderException: Sending unknown packet 'clientbound/minecraft:disconnect'
	at MC/net.minecraft.network.handler.PacketCodecDispatcher.encode(PacketCodecDispatcher.java:47)
	at io.netty.handler.codec.MessageToByteEncoder.write(MessageToByteEncoder.java:107)
	at MC/net.minecraft.network.ClientConnection.send(ClientConnection.java:325)

Решение: минималистичный обходной путь

Мод Disconnect Packet Fix разработан как временное решение (workaround) до момента исправления бага официальными разработчиками Minecraft. Его работа строится на использовании единственного миксина (mixin), который инжектирует код в один конкретный метод сетевого обработчика. Это позволяет перехватить процесс отправки пакета и предотвратить возникновение исключения, которое ранее вызывало спам в логах. Код модификации крайне минималистичен, что снижает вероятность конфликтов с другими дополнениями и обеспечивает стабильность работы.

Важно: назначение модификации

Мод не предоставляет игрокам новых предметов, механик или возможностей. Его единственная цель — техническое исправление бага на стороне сервера. Если проблема на вашем сервере не связана именно с ошибкой отправки пакетов разделения (MC-271325), установка этого мода не поможет устранить её. Мод работает исключительно как утилита для очистки логов и стабилизации сетевого стека.

Технические детали и структура архива

Мод предназначен исключительно для серверной части игры; установка на клиент не поддерживается. В архиве файла содержится всего 13 файлов, из которых 3 являются классами Java, а также используется механизм миксинов. В файле нет исполняемых файлов или встроенных библиотек, что подтверждает его статус как чистой утилиты. Лицензия MIT разрешает свободное распространение и использование модификации, а зависимости от других модов отсутствуют.