Fast Events
Если вы когда-нибудь собирали большой модпак и замечали, что игра начинает подтормаживать даже на мощном железе, причина часто кроется не в тяжёлых текстурах и не в шейдерах, а в шине событий. Мод Fast Events решает именно эту проблему: он делает обработку событий в Forge и NeoForge заметно быстрее, не требуя от вас ни конфигов, ни дополнительных библиотек.
Что такое Fast Events и зачем он нужен
В стандартной реализации шины событий Minecraft и Forge/NeoForge каждый вызов слушателя проходит через одну и ту же точку вызова. JIT-компилятор видит там сотни разных классов слушателей и не может встроить (инлайнить) ни один из них — это называется мегаморфным вызовом. В результате каждый пост события тратит время на виртуальный диспетч и обёртки, а не на полезную логику вашего мода.
Fast Events переписывает места вызова событий во всех загруженных классах и генерирует для каждого набора слушателей собственный диспетчер. Каждая точка вызова видит ровно один тип получателя и инлайнится вплоть до тела слушателя. Проще говоря, стоимость постинга события падает примерно до стоимости прямого вызова ваших обработчиков вручную.
Ключевые особенности
- Ускоряет постинг событий всех модов, а не только собственных — моды не нужно модифицировать.
- Не создаёт объект события, если на него никто не подписан.
- Сохраняет семантику: порядок приоритетов, маркеры фаз, отмену, фильтры по generic-типам и обработку исключений.
- Живой кеш: диспетчеры пересобираются при изменении списка слушателей, поэтому поздно зарегистрированные обработчики тоже работают.
- Никаких Mixin, access transformers и точек входа coremod, за которые борются другие оптимизаторы.
Поддерживаемые версии и загрузчики
Мод поставляется отдельным jar под каждую версию игры. Для Minecraft 1.20.1 с Forge 47.x нужен файл вида fastevents-1.20-*.jar, а для Minecraft 1.21.1 с NeoForge 21.1.x — fastevents-1.21-*.jar. Другие сборки 1.20.x и 1.21.x не поддерживаются. Клиент и сервер работают оба, и обе стороны получают выигрыш.
Кстати, если вы пользуетесь лаунчером foxygame.net, установка Fast Events сводится к паре кликов: дополнение находится в каталоге прямо внутри лаунчера, и вам не придётся вручную подбирать jar под версию игры. Это особенно удобно, когда хочется скачать Fast Events для Minecraft без риска перепутать файл.
Насколько это быстрее: цифры
Замеры в репозитории проекта (наносекунды на один пост, один поток, 8 слушателей на класс события, Java 21) выглядят убедительно. На Minecraft 1.20.1 с Forge 47.4 обычные @SubscribeEvent-слушатели стоили 49,6 нс, а с модом — 9,3 нс, то есть ускорение в 5,3 раза. Слушатели, добавленные через addListener с восемью разными ссылками, ускоряются в 5,7 раза, generic-слушатели в стиле AttachCapabilitiesEvent — в 4,2 раза.
На Minecraft 1.21.1 с NeoForge 21.1 картина похожая: 31,2 нс против 8,8 нс для @SubscribeEvent (в 3,5 раза), 19,0 нс против 8,8 нс для addListener. Даже при 512 слушателях на одном классе события сохраняется двукратный выигрыш. Абсолютная экономия растёт вместе с частотой постинга: если вызов слушателя стоил 50 нс, а стал 9 нс, это ощутимо, когда он выполняется тысячи раз за тик по всему паку.
Как установить
Установка максимально простая и не требует навыков. Порядок действий такой:
- Установите Minecraft 1.20.1 с Forge 47.x либо Minecraft 1.21.1 с NeoForge 21.1.x.
- Поместите подходящий jar в папку mods/.
- Запустите игру — конфигурация не нужна, зависимостей нет.
Мод также работает на classpath лаунчера. Для сервера достаточно установить его на сам сервер: клиентам, которые подключаются, он не обязателен, хотя с ним они тоже получат небольшой прирост. Удалить мод можно в любой момент — он ничего не пишет в мир или конфиги.
Необязательные настройки
Параметры нужны только для отладки, для обычной игры оставьте всё по умолчанию. Свойство -Dfastevents.guard=false отключает пропуск создания new Event() при отсутствии слушателей. -Dfastevents.audit=true проверяет кеш массива слушателей при каждом посте и логирует поздние регистрации. -Dfastevents.diag=true (только 1.20.1) логирует слушателей, зарегистрированных через не переписанный путь.
Совместимость и частые вопросы
Мод не патчит классы событий и не трогает слушателей других модов, поэтому оптимизаторы, работающие с шиной, не конфликтуют с ним. Если другой мод тоже заменяет точки вызова, оба просто оборачивают одно и то же место — результат остаётся корректным, добавляется лишь один уровень косвенности. Не ускоряются и остаются на ванильном пути post(EventPriority, Event) на 1.21 и точки вызова, чью ссылку на шину нельзя разрешить при загрузке — поведение там не меняется.
Порядок слушателей и работа @Cancelable-событий не нарушаются: диспетчер обходит слушателей ровно в том порядке, который построила шина, а отмена проверяется в тех же точках, что и в ваниле. В паках с малым числом модов выигрыш будет скромным, но ваниль сама постит события каждый тик, так что небольшой прирост есть всегда. А вот в крупных сборках, где число слушателей на класс события растёт вместе с количеством модов, экономия проявляется в полную силу.
Fast Events — это узкоспециализированный, но очень аккуратный инструмент: он не меняет API, не требует настройки и делает ровно одну вещь — убирает накладные расходы шины событий. Если ваш модпак активно использует тики, обновления блоков и сущностей, события экрана и capability-события, этот мод станет незаметным, но полезным дополнением к вашей сборке.