Hitbox Api
Стандартные хитбоксы в Minecraft — это простые параллелепипеды, и порой они ощущаются грубым инструментом. Hitbox Api решает эту проблему, добавляя в игру продвинутые формы коллизий: ориентированные ограничивающие параллелепипеды (OBB), сферы, капсулы, лучи и составные коллайдеры. Если вы создаёте мод, где важна точность попаданий, или просто хотите, чтобы взаимодействия с сущностями ощущались честнее, этот API заслуживает внимания.
Что даёт Hitbox Api для Minecraft
По сути это библиотека для разработчиков и технически подкованных игроков. Она расширяет набор примитивов, которыми описывается зона столкновения объекта. Вместо одного «куба» вы получаете целый арсенал геометрических форм и возможность комбинировать их в единую составную коллизию.
- Axis-Aligned Bounding Box — классический параллелепипед, выровненный по осям.
- Oriented Bounding Box (OBB) — параллелепипед, который можно поворачивать в пространстве.
- Sphere — сфера для симметричных объектов.
- Capsule — капсула, удобная для вытянутых форм вроде конечностей или снарядов.
- Ray — луч для проверки пересечений по направлению.
- Compound — объединение нескольких коллайдеров в один, причём составные боксы можно вкладывать друг в друга.
Такая гибкость особенно полезна для существ с нестандартной геометрией: летающих созданий, механизмов, многоголовых мобов. Вместо приблизительного куба вы описываете реальную форму объекта, и проверка столкновений становится точнее.
Как установить
Мод ориентирован на современные версии игры и загрузчик Fabric. Перед установкой убедитесь, что у вас подходящая версия Minecraft и установлен Fabric Loader с Fabric API — без него библиотека не заработает. Дальше процесс стандартный:
- Скачайте Hitbox Api в виде jar-файла, соответствующего вашей версии игры.
- Поместите файл в папку mods вашего профиля Fabric.
- Запустите игру через лаунчер с выбранным профилем Fabric.
- Проверьте, что мод появился в списке загруженных модификаций.
Если вы не хотите возиться с ручным подбором файлов и зависимостей, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Hitbox Api находится в один клик, а совместимость версий проверяется автоматически, что избавляет от типичных ошибок при сборке.
Тем, кто ищет, где скачать Hitbox Api без лишних сложностей, стоит помнить: всегда сверяйте версию мода с версией игры и загрузчика. Несовпадение — самая частая причина, по которой библиотека не запускается или ведёт себя непредсказуемо.
Как использовать в игре и коде
Проверка столкновений
В любом месте, где нужна детекция коллизий, создаётся объект-коллайдер, а затем через методы ColliderUtil проверяется, произошло ли столкновение. Это универсальный подход: неважно, обрабатываете вы попадание снаряда или касание моба, логика остаётся единой.
Кэширование для сущностей
Для сущностей (Entity) предусмотрен механизм кэширования через привязку HitboxDataAttachments#COLLISION. Закэшированный коллайдер можно отобразить прямо в игре, нажав F3 + B, — удобный способ отладки, который экономит часы на визуальной проверке форм. Важный нюанс: эти данные не имеют реализации персистентности, то есть не сохраняются между перезапусками и требуют повторной инициализации.
Производительность
Автор провёл замеры через JMH на связке AMD R5 5600G, 32 ГБ памяти и Microsoft OpenJDK 21.0. Настройки стандартные: пять раундов прогрева и пять измерительных. Результаты в операциях в секунду показывают, насколько разные формы отличаются по скорости.
- Axis-Aligned Bounding Box — около 3,56 млрд ops/s, абсолютный лидер.
- Sphere — примерно 119,5 млн ops/s.
- Capsule — порядка 22,3 млн ops/s.
- Rotated Capsule — около 16,8 млн ops/s.
- Oriented Bounding Box — примерно 5,5 млн ops/s.
- Rotated Oriented Bounding Box — около 4,6 млн ops/s.
Вывод простой: чем сложнее форма и чем больше в ней поворотов с пересчётом векторов, тем дороже проверка. Простые боксы и сферы работают молниеносно, а вот повёрнутые OBB стоит применять осознанно — например, только для ключевых объектов, а не для сотен сущностей одновременно.
Итог
Hitbox Api — это аккуратный инструмент для тех, кому мало стандартных кубических хитбоксов. Он даёт разработчикам точную геометрию коллизий, составные формы и удобную отладку через F3 + B, а игрокам — более предсказуемые взаимодействия в модах, которые его используют. Главное — ставить подходящую версию под Fabric и трезво оценивать производительность при выборе сложных повёрнутых коллайдеров.