Custom Block Outlines (CBO): свои хитбоксы блоков в Minecraft

Custom Block Outlines (CBO) для Minecraft меняет форму и коллизию блоков через JSON-паки. Узнайте, как установить мод и настроить кубоиды.

Custom Block Outlines (CBO)

Задумывались ли вы, почему у цветка хитбокс размером с целый блок, а у лестницы он повторяет её ступени? Custom Block Outlines (CBO) — это Fabric-мод, который отдаёт форму коллизии и контура блоков вам в руки. Хотите, чтобы факел занимал ровно свой столбик, а не кубометр пространства? Или чтобы декоративная колонна не мешала проходу? Здесь это решается парой строк в JSON.

Сразу оговоримся: проект помечен автором как deprecated — обновлений и поддержки официально не будет, разве что разработчик внезапно передумает. Но мод по-прежнему рабочий и востребованный, особенно среди картостроителей и датапакеров. Если вы ищете, где скачать Custom Block Outlines (CBO) без сюрпризов, дальше разберём всё по шагам.

Что умеет Custom Block Outlines (CBO) в Minecraft

Мод не трогает модели и текстуры — он работает исключительно с логикой столкновений и контуром выделения. Условно у него две функции:

  • Копирование формы другого блока: вы указываете ID и нужное состояние (blockstate), и целевой блок перенимает чужой хитбокс.
  • Ручное построение формы из кубоидов: вы описываете фигуру набором параллелепипедов с координатами от 0 до 16.

Второй вариант даёт полную свободу. Например, можно собрать хитбокс варочной стойки из двух кубов, и тогда игрок будет проходить сквозь пустоту вокруг неё, а не упираться в невидимую стену.

Как установить Custom Block Outlines (CBO)

Требования и загрузчик

Мод написан под Fabric и требует Fabric API — без него игра просто не запустится. Что касается версий Minecraft, ориентируйтесь на актуальные сборки 1.19–1.20.x: именно под них чаще всего распространяется Custom Block Outlines (CBO) для Minecraft. Точный список поддерживаемых версий всегда смотрите в описании конкретного релиза, потому что после отказа от поддержки новые ветки игры мод не получал.

Порядок действий стандартный: ставим Fabric Loader, кладём в папку mods сам мод и Fabric API, запускаем игру. Если не хочется возиться с ручной раскладкой файлов, обратите внимание на лаунчер foxygame.net — он подтягивает Custom Block Outlines (CBO) вместе с зависимостями в один клик и сам следит за тем, чтобы версия мода совпадала с версией вашего профиля.

Первый запуск и папка outlinepacks

После первого старта с установленным модом в директории запуска (обычно это .minecraft) появится папка outlinepacks. Именно сюда вы кладёте свои наборы — outline packs. Каждый пак — это просто папка с JSON-файлами, где имя файла равно ID блока: brewing_stand.json, redstone_wire.json и так далее. Название самого пака значения не имеет, главное — содержимое.

Синтаксис JSON: копирование и кубоиды

Копируем форму другого блока

Самый простой путь — взять готовый хитбокс у ванильного блока. В файле poppy.json пишем:

  • "override" с полем "id" — например, minecraft:spruce_stairs;
  • "blockstate" — состояние, форму которого копируем, скажем facing=north,half=bottom,shape=straight.

Важный нюанс: если копируемый блок меняет положение в зависимости от координат (цветы, бамбук, pointed dripstone), добавьте тег "pos" с массивом координат. Для одуванчика на позиции 24, 65, -121 это будет "pos": [24, 65, -121]. Тег blockstate в таком случае необязателен.

Строим собственный хитбокс

Для ручной формы используется массив "cubes". Каждый куб записывается как [x1, y1, z1, x2, y2, z2], где точка (0, 0, 0) — нижний северо-западный угол блока, а (16, 16, 16) — верхний юго-восточный. Пример для варочной стойки — два куба: [0, 0, 0, 8, 8, 8] и [8, 8, 8, 16, 16, 16].

Кубы могут выходить за пределы стандартных 16x16x16, но визуально и физически это начинает вести себя странно. И не увлекайтесь количеством: десятки кубов на блок легко превратят игру в слайд-шоу. Если в JSON присутствуют одновременно "override" и "cubes", приоритет всегда у override — кубоиды будут проигнорированы.

Игра на сервере и совместимость

Ключевой момент для мультиплеера: одинаковые паки должны стоять и на сервере, и у клиента. Иначе краша не случится, но начнутся рассинхроны — рывки, проваливание в блоки и прочая «глючная» физика. Это не баг мода, а прямое следствие расхождения данных о коллизии.

Если вы собираете модпак или просто не хотите вручную сверять версии, в каталоге дополнений лаунчера foxygame.net Custom Block Outlines (CBO) отмечен как совместимый с Fabric-профилями, а автообновление избавит от ситуации, когда мод и Fabric API разошлись по версиям.

Итог

Custom Block Outlines (CBO) — узкоспециализированный, но очень мощный инструмент. Он не преобразит игру визуально, зато даёт точный контроль над тем, как блоки взаимодействуют с игроком и мобами. Картостроителям, авторам декоративных построек и всем, кого раздражают огромные хитбоксы мелких объектов, мод сэкономит массу времени. Учитывайте только статус проекта: скачивайте Custom Block Outlines (CBO) под свою версию Minecraft заранее и держите копию паков в надёжном месте — обновлений от автора ждать не стоит.