PacketRateLimiter — защита сервера Minecraft от дюпов и лагов

PacketRateLimiter — защита сервера Minecraft от дюпов и лагов Каждый администратор сервера Minecraft хотя бы раз сталкивался с ситуацией, когда хитрый игрок за доли секунды проворачивает серию инвентарных трюков и получает несметные богатства. Дюпы не только разрушают экономику, но и порождают во...

Скачать PacketRateLimiter для Minecraft 1.21.2, 1.20.6

Оригинальное название: PacketRateLimiter

Версии Minecraft: 1.20.6, 1.21.2

ФайлВерсияЗагрузчикРазмер
PacketRateLimiter-0.1.0.jar1.20.6—23 КБСкачать
PacketRateLimiter-0.2.0.jar1.20.6—23 КБСкачать
PacketRateLimiter-0.3.0.jar1.21.2—4.5 МБСкачать

PacketRateLimiter — защита сервера Minecraft от дюпов и лагов

Каждый администратор сервера Minecraft хотя бы раз сталкивался с ситуацией, когда хитрый игрок за доли секунды проворачивает серию инвентарных трюков и получает несметные богатства. Дюпы не только разрушают экономику, но и порождают волну жалоб от честных игроков. А когда несколько человек одновременно начинают спамить кликами, сервер начинает задыхаться — TPS падает, блоки перестают ломаться, мобы замирают. PacketRateLimiter решает обе эти проблемы на корню, работая на сетевом уровне ещё до того, как сервер начнёт обрабатывать подозрительные пакеты.

Почему серверы страдают от дюпов и лагов

Классические методы борьбы с дюпами через Bukkit-события часто дают осечку. Когда плагин отменяет событие уже после того, как клиент отправил пакет, на стороне игрока возникает десинхронизация: предметы мигают, перемещаются фантомно, а инвентарь показывает неверное количество. Злоумышленники этим пользуются, намеренно вызывая рассинхрон для эксплуатации уязвимостей. Кроме того, лавина инвентарных пакетов от ботов или неосторожных игроков нагружает главный поток сервера, снижая производительность для всех.

Что такое PacketRateLimiter и как он работает

PacketRateLimiter — это лёгкий серверный плагин, который перехватывает пакеты инвентаря на потоке Netty I/O с помощью библиотеки PacketEvents. Он анализирует каждое действие ещё до того, как оно дойдёт до серверной логики. Если игрок пытается выполнить слишком много операций за короткий промежуток, плагин просто отбрасывает лишние пакеты. Клиент даже не узнает, что его клик не прошёл — никаких фантомных предметов и рассинхрона.

Принцип работы на уровне пакетов

Для каждого игрока создаётся собственный токен-бакет в конкурентной карте. Представьте ведро, которое медленно наполняется водой. Каждое действие тратит определённое количество воды. Если ведро опустело — действие блокируется до тех пор, пока не накопится достаточно токенов. При выходе игрока бакет корректно удаляется, не оставляя утечек памяти. Сообщения о превышении лимита дебаунсятся, чтобы не засорять чат.

Какие действия ограничивает плагин

PacketRateLimiter контролирует именно те механики, которыми чаще всего злоупотребляют дюперы и лаггеры. Под прицел попадают:

  • Клики по инвентарю, включая Shift-клик и перенос через цифровые клавиши;
  • Перетаскивание предметов с зажатой кнопкой мыши (стоимость зависит от количества задействованных слотов);
  • Выбрасывание предметов клавишей Q;
  • Смена предмета в левую руку клавишей F.

При этом игроки в творческом режиме полностью освобождены от ограничений — их действия никогда не блокируются. Это позволяет администраторам и строителям работать без помех.

Гибкая конфигурация под любой сервер

Плагин поставляется с продуманными настройками по умолчанию, но каждый параметр можно тонко подстроить под особенности вашего сервера. Вы управляете скоростью восполнения токенов (limiter.refill_per_sec: 12.0), ёмкостью бакета для пиковых нагрузок (limiter.burst_capacity: 20.0) и стоимостью каждого типа действий. Например, одно перетаскивание может стоить 1.0 плюс дополнительные 1.0 за каждые четыре затронутых слота. Такая детализация позволяет сохранить комфортную игру для обычных пользователей, но надёжно отсекает автоматизированные скрипты. Если вы экспериментируете с лимитами и хотите быстро проверить их в деле, удобно использовать лаунчер foxygame.net — гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню и моментально подключиться к тестовому серверу, не тратя время на ручную настройку клиента.

Команды и разрешения

Управление плагином минималистично и не требует запоминания десятка команд. Доступна единственная команда /prlreload для перезагрузки конфигурации на лету — она требует административных прав, прописанных в plugin.yml. Для отдельных игроков или групп можно выдать разрешение packetratelimiter.bypass, которое полностью отключает ограничения. Это полезно для модераторов или доверенных тестеров, которые должны иметь возможность быстро манипулировать инвентарём.

Технические детали: как это работает изнутри

В основе PacketRateLimiter лежит перехват пакетов на самом низком уровне — до того, как они попадают в очередь обработки сервера. Это стало возможным благодаря библиотеке PacketEvents, которая интегрируется напрямую в Netty-канал. Такой подход исключает классическую проблему Bukkit-событий: когда плагин отменяет действие после его частичной обработки, клиент успевает отобразить изменение, а затем получает откат. Здесь же пакет либо проходит, либо молча отбрасывается, и интерфейс игрока остаётся консистентным. Токен-бакеты реализованы в ConcurrentHashMap, что гарантирует потокобезопасность без лишних блокировок. При событии PlayerQuit бакет удаляется, предотвращая утечку памяти. Сообщения-предупреждения отправляются не чаще одного раза в заданный промежуток (по умолчанию 1500 мс), чтобы не раздражать игрока при случайном всплеске активности.

Заключение

PacketRateLimiter — это элегантное решение для администраторов, которые хотят защитить сервер от дюпов и лагов без ущерба для честного геймплея. Работа на сетевом уровне, гибкие настройки и нулевое влияние на клиентскую часть делают его незаменимым инструментом в арсенале любого технического администратора. Плагин не требует установки модов на стороне игроков и легко вписывается в любую сборку сервера, обеспечивая честную игру и стабильный TPS.