Hitbox Api: расширенные коллизии для Minecraft

Hitbox Api для Minecraft добавляет OBB, капсулы и сферы для точной коллизии сущностей. Узнайте, как установить и использовать мод.

Скачать hitboxapi neo для Minecraft 1.21.3

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

Версии Minecraft: 1.21.3

Загрузчик: NeoForge

ФайлВерсияЗагрузчикРазмер
hitboxapi-neo-1.21.1-1.0.0.jar1.21.3NeoForge1.5 МБСкачать

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 и трезво оценивать производительность при выборе сложных повёрнутых коллайдеров.