Celeris: библиотека производительности для Minecraft
Если вы наткнулись на мод, который требует Celeris, и не понимаете, что это вообще такое — вы не одиноки. Celeris не добавляет новых блоков, мобов или биомов. Это техническая библиотека, на которой работают другие моды. Сама по себе она невидима в игре, но именно она позволяет тяжёлым модам не превращать ваш мир в слайд-шоу. Разберёмся, зачем она нужна, какие версии поддерживает и как её правильно поставить.
Что такое Celeris и зачем она нужна
Celeris — это библиотека производительности для модов на NeoForge и Fabric. Она даёт другим модам готовые быстрые «кирпичики», чтобы те могли выполнять тяжёлую работу без просадок FPS и подвисаний тиков. Проще говоря, это фундамент: вы устанавливаете Celeris не ради неё самой, а потому что нужный вам мод построен на её возможностях.
Без библиотеки такой мод просто не запустится или откажется работать. С ней — получает доступ к оптимизированным алгоритмам, которые написаны с расчётом на реальные нагрузки Minecraft.
Что Celeris даёт другим модам
Внутри библиотеки собраны несколько независимых подсистем. Каждая решает свою задачу и заметно ускоряет то, что раньше упиралось в главный поток игры.
Работа вне основного потока
Тяжёлые задачи выполняются на рабочих потоках, а результаты возвращаются в игровой поток через очереди без блокировок. Тик или кадр при этом не останавливается.
Меньше давления на сборщик мусора
Крупные буферы живут в памяти вне кучи Java, поэтому большие объёмы данных не вызывают пауз сборщика мусора.
Векторная математика и сжатие
Массовые вычисления задействуют SIMD-блоки процессора, когда Java это позволяет, и обычные циклы, когда нет. Для сжатия данных модов используется нативный zstd, а для сетевых пакетов — deflate.
Предметы в трубах и сигнальные сети
Сети, переносящие предметы от блока к блоку, обходятся без сущности на каждый предмет и сохраняют содержимое при установке, разрушении и сохранении труб. Redstone-подобные графы пересчитывают только то, что затронуло изменение.
Пакетная физика
Тысячи сущностей и выпавших предметов двигаются за один проход по правилам ванильного перемещения.
Безопасность и совместимость
Один из главных плюсов — предсказуемость. У каждого быстрого пути есть чистая Java-реализация: если что-то не может работать быстро на вашей машине, Celeris тихо переключится на медленный вариант вместо краша. Библиотека опциональна с обеих сторон соединения: игроки без неё спокойно заходят на сервер с ней, а клиент на Fabric может подключиться к серверу на NeoForge с Celeris. Сетевые пакеты ограничены по размеру, а заголовки проверяются до использования. Нативный код проходит проверку AddressSanitizer и UBSan в CI, и его результаты побитово совпадают с Java-версией.
Производительность в цифрах
Разработчик приводит замеры на JMH, Java 21 и четырёхъядерной машине. Сжатие оказалось в 12,8 раза быстрее встроенного deflate при почти том же размере, а распаковка — в 3,1 раза быстрее. 32 768 выпавших предметов обрабатываются за 0,88 мс на тик на трёх потоках — это менее 2% тика. Поиск соприкасающихся предметов в куче из 16 384 штук занимает 0,24 мс вместо почти секунды. Передача данных с рабочего потока в игровой идёт в 4,9 раза быстрее, чем через JCTools.
Требования и поддерживаемые версии
- Minecraft: от 1.21 до 26.3 — скачивайте файл, собранный под вашу версию.
- Загрузчик: NeoForge или Fabric (вместе с Fabric API), на клиенте и на сервере.
- Java: 21 для 1.21.x, 25 для 26.x.
Обратите внимание: файлы для разных версий не взаимозаменяемы, поэтому при обновлении игры библиотеку нужно обновить тоже.
Как установить Celeris
Установка стандартная для библиотек. Сначала скачайте Celeris для Minecraft с официальной страницы проекта, выбрав файл под свою версию игры и загрузчик. Затем положите его в папку mods вашего профиля. Для Fabric не забудьте про Fabric API. После запуска игра создаст конфигурационный файл.
Если не хочется вручную подбирать версии и раскладывать файлы, лаунчер foxygame.net позволяет поставить Celeris в один клик из каталога дополнений — он сам подберёт сборку под ваш профиль и проследит за обновлениями библиотеки.
Настройка сжатия сети
В конфиге есть один основной параметр — уровень сетевого сжатия от 0 до 9, по умолчанию 1. Значение 0 отправляет пакеты без сжатия, 1 работает быстрее всего, 9 даёт самые маленькие пакеты. Учитывается настройка только отправителя. На NeoForge путь такой: Mods → Celeris → Config или параметр compressionLevel в config/celeris-common.toml. На Fabric с Mod Menu: Mods → Celeris → Config, либо compressionLevel в config/celeris.properties с перезапуском после ручной правки.
Нативный код и лицензия
Celeris поставляется с двумя нативными библиотеками, собранными из открытого исходного кода через GitHub Actions на раннерах каждой платформы. Это zstd 1.5.7 под лицензией BSD-3-Clause и собственное ядро физики на C++. В релизах также есть полностью Java-версия без нативного кода — на случай, если ваша система капризна. Исходники распространяются под AGPL-3.0, а арт и документация — под CC BY-NC-SA 4.0.
Итог
Celeris — это незаметный работяга, который держит на себе производительность других модов. Если вы встретили её в требованиях — просто поставьте подходящую версию, и всё заработает. А если хотите оценить вклад библиотеки в цифрах, загляните в вики проекта: там есть замеры, флаги JVM и руководство для авторов модов.