Icterine

Мод Icterine для Minecraft — снижение нагрузки InventoryChangeTrigger

Icterine — это мод для серверов Minecraft, направленный на оптимизацию работы системы достижений. Основная задача проекта — ускорить обработку событий изменения инвентаря (InventoryChangeTrigger), которые вызываются при сборе предметов, их выбросе или перемещении между слотами. Мод работает исключительно на стороне сервера, что делает его идеальным решением для выделенных серверов с множеством активных игроков и пачками модов. В ходе тестов на сервере с более чем 200 модами и пакетом достижений BlazeandCave (свыше 950 условий) производительность работы InventoryChangeTrigger выросла почти в 2.5 раза, снизив потребление времени тика с 20% до около 7.5%.

Проблема ванильной системы достижений

В стандартном Minecraft механизм отслеживания достижений опирается на событие InventoryChangeTrigger. Оно срабатывает практически при любом изменении инвентаря: при сборе предметов, их выбросе (включая целые стопки), перемещении между слотами и даже при открытии контейнеров. При открытии сундука или печи игра ошибочно считает, что изменились все слоты инвентаря, включая пустые, и вызывает триггер для каждого из них. Это приводит к тому, что система проходит по всем зарегистрированным критериям достижений, проверяя каждый предмет на соответствие требованиям. Особенно ресурсоёмкой становится проверка совпадения предметов по тегам: сначала проверяется тип предмета, а затем количество, чары и другие данные NBT. На серверах с большим количеством игроков и сложными наборами достижений этот процесс может занимать до 20% времени игрового тика.

Как работает оптимизация Icterine

Мод Icterine кардинально меняет подход к обработке событий инвентаря, устраняя вызовы InventoryChangeTrigger там, где они не нужны. Триггер не срабатывает при выбросе стопок или перемещении предметов из инвентаря в контейнеры (управляется параметром ignore_triggers_for_emptied_stacks). Также оптимизация пропускает вызов, если изменение количества предмета не привело к его полному исчезновению (контролируется ignore_triggers_for_decreased_stacks). Дополнительно, если размер стопки увеличился, но не достиг порога для какого-либо достижения, триггер не вызывается (optimize_triggers_for_increased_stacks). При открытии экрана контейнера мод модифицирует логику, чтобы не считать все стопки изменёнными сразу (initialize_inventory_last_slots). На этапе проверки множественных требований (например, полного набора брони) мод сначала проверяет, соответствует ли изменённый слот какому-либо условию, и только затем проверяет остальные предметы (optimize_multiple_predicate_trigger). Наконец, при сравнении предметов сначала проверяется их количество, чтобы избежать лишних проверок тегов, а также используется предыдущее значение количества для экономии ресурсов (check_count_before_item_predicate_match). Все изменения вносятся исключительно на стороне сервера, что делает мод безопасным для клиентских настроек.

Результаты тестирования

Эффективность оптимизации была подтверждена живым тестом на выделенном сервере с тремя активными игроками. Тестирование проводилось на кастомном Forge-пакете модов, содержащем более 200 модов, в сочетании с пакетом достижений BlazeandCave, добавляющим свыше 950 условий. Статистика была собрана с помощью Spark в течение одного часа. Результаты показали значительное улучшение производительности: с модом Icterine InventoryChangeTrigger выполнялся почти в 2.5 раза быстрее (на версии 1.1.0), занимая около 7.5% времени тика вместо 20%. Для версии 1.0.0 мод обеспечивал ускорение примерно в 2 раза. Эти улучшения достигаются за счёт пропуска ненужных проверок и оптимизации порядка выполнения логики, что особенно заметно на серверах с большим количеством игроков и сложными системами достижений.

Настройки и обратимость изменений

Каждый инъект в код ванильной игры, вносимый модом, можно отключить через файл конфигурации. Это позволяет администраторам сервера гибко настраивать поведение модификации и тестировать различные сценарии. Несмотря на то, что мод может нарушить паритет с ванильной версией, он не влияет на стандартные достижения и, как ожидается, не затрагивает подавляющее большинство модов и наборов данных. Автор гарантирует, что даже если мод влияет на какое-то достижение, оно всё равно должно быть доступно при простом выбросе и сборе одного из требуемых предметов. На данный момент известные несовместимости отсутствуют.

Технические детали и распространение

Мод распространяется под лицензией GPL-3.0-or-later. В архиве файла Icterine-neoforge-1.20.3-4-1.3.0.jar (для NeoForge) содержится 31 файл, включая 15 файлов классов, размер архива составляет 37 809 байт. Мод использует миксины (mixins) для внедрения изменений. В файле зависимостей указан только сам мод как обязательный (icterine), других зависимостей не требуется. Мод не поддерживает работу на клиенте и предназначен исключительно для серверной части. Русский язык в архиве не обнаружен. Мод поддерживает широкий спектр версий игры и платформ: версия 1.3.0 работает с Fabric и Quilt для версий Minecraft 1.20 — 1.20.4, а также с Forge для версий 1.19.3 — 1.20.4. Для NeoForge поддерживаются версии 1.20.1 — 1.20.4. Ранее выпущенная версия 1.2.0 была совместима с Fabric/Quilt от 1.18.2 до 1.19.4 и с Forge от 1.18.2 до 1.19.2. При выборе файла для установки необходимо использовать фильтр на странице версий, чтобы подобрать правильный дистрибутив под конкретную сборку.

Связанные материалы

• Sodium Extra — похожий мод
• ModernFix — похожий мод
• More Culling — похожий мод
• Dynamic FPS — похожий мод
• Krypton — похожий мод

Автор: Mephodio · Лицензия: GPL-3.0-or-later