Structure Gel API

Structure Gel API - библиотека для Minecraft Java, которая упрощает разработку генерируемых построек, особенно тех, что используют систему jigsaw. Игроку она обычно нужна как зависимость другого мода, а авторам помогает работать со структурами и проверять их прямо в игре. В качестве открытого примера использования указан Dungeons Plus.

Помимо API, проект добавляет творческий строительный инструмент и гелевые блоки. Они пригодятся при создании крупных построек: можно быстро заполнять области, копировать части здания и проверять, как структура поведёт себя при генерации в мире.

Строительный инструмент

Инструмент доступен только в творческом режиме, во вкладке Structure Items. Щёлкните им правой кнопкой мыши по воздуху, чтобы открыть меню. Там выбираются режимы работы, блок для размещения, позиции и дополнительные параметры.

В меню есть отмена и повтор действий. Инструмент сохраняет до 32 последних операций. Наведите курсор на кнопку или предмет в интерфейсе, чтобы увидеть подсказку с описанием. Для некоторых режимов позиции можно задать из меню, если выбрать блок правой кнопкой неудобно или невозможно.

Основные клавиши:

• Средняя кнопка мыши - выбрать состояние блока, на который вы смотрите. То же можно сделать через меню.
• Левая кнопка мыши - выполнить действие, заданное текущим режимом.
• Правая кнопка мыши по воздуху - открыть меню инструмента.
• Правая кнопка мыши по блоку - выполнить действие или задать позицию, если режим это поддерживает.
• Shift + правая кнопка мыши - очистить выбранные позиции.

Режимы работы

• Extend продолжает узор блоков от выбранной грани. По принципу работы он похож на Builder's Wands: помогает быстрее достраивать повторяющиеся участки.
• Flood заполняет воздух в выбранном горизонтальном срезе до границ, а затем продолжает заполнение вниз. Например, так можно залить водой озеро.
• Fill заполняет блоками область между двумя выбранными углами. Можно ограничить замену определёнными блоками или оставить только каркас, создав полую коробку.
• Line проводит линию из блоков между выбранными позициями.
• Clone копирует выделенную область и размещает её в указанном месте. Копию можно повернуть, отразить или вырезать вместо копирования.
• Move перемещает выделенную область в направлении удара.
• Clear удаляет блоки внутри выбранных позиций.
• Shape размещает фигуру в точке клика. Форму и правила замены блоков можно настроить в свойствах режима.

У некоторых операций есть дополнительные параметры. Integrity задаёт, какая доля блоков будет размещена. Replace определяет, что заменять: всё, только воздух или блок, по которому вы щёлкнули. Для клонирования доступны поворот и отражение, в том числе случайный вариант.

Structure Gel и генерация построек

Гелевые блоки нужны для подготовки внутренней части структуры. Во время генерации гель заменяется воздухом, а обычные воздушные блоки не переносятся. Благодаря этому естественный рельеф не заполняет пустоты внутри постройки там, где автор оставил их пустыми.

По гелю можно ходить, как по пустому пространству с блоком-структурной пустотой, но сам блок при этом виден. Это удобно при сборке и проверке постройки в творческом режиме: видно, какие области будут очищены при генерации.

Типы геля

Распространение запускается размещением геля в режиме скрытности. У разных цветов свои правила, поэтому перед использованием полезно проверить поведение выбранного блока.

• Красный гель распространяется по сторонам света и заменяет только воздух.
• Синий гель работает похоже на красный, но не попадает в места, откуда видно небо.
• Зелёный гель распространяется по диагонали в дополнение к обычным направлениям. Он проходит через сложные углы, например участки с лианами, поэтому следите, чтобы гель не вышел за пределы постройки.
• Бирюзовый гель сочетает диагональное распространение зелёного с ограничением синего: он обходит места, где видно небо.
• Оранжевый гель распространяется как красный, но дальность зависит от количества геля в руке при размещении. Это удобно для открытых участков.
• Жёлтый гель распространяется только по плоскости, в направлении которой вы смотрите. Его можно использовать, чтобы перекрыть стену, окно или отверстие, не заполняя соседние области.

Удалить гель можно порохом. Взрыв запускает цепную реакцию и убирает соединённые блоки того же типа.

Совместимость и установка

Structure Gel API - библиотека, поэтому обычному игроку она, как правило, нужна вместе с модом, который от неё зависит. Если мод запрашивает эту зависимость, установите подходящую версию API для той же версии Minecraft и загрузчика. Не стоит брать сборку для другой версии игры: библиотеки и моды должны совпадать по требованиям.

Проект поддерживает несколько версий Minecraft Java, включая 26.1.2, 1.21.4 и 1.20.4, а также более ранние выпуски. Для актуальной версии указан NeoForge; проект также выпускается для Forge. Перед установкой проверьте требования конкретной версии зависимого мода и загрузчика.

Structure Gel API является core-модом и изменяет некоторые внутренние классы игры. Поэтому при совместном использовании с другими модами возможны конфликты и сбои. Если появляется вылет, проверьте запуск с нужной версией игры и загрузчика, а затем выясните, воспроизводится ли проблема без других модов.

Для кого предназначен API

Авторам модов Structure Gel API упрощает работу с генерируемыми структурами и инструментами для их подготовки. Игрокам он даёт строительные функции в творческом режиме, но основная причина установки обычно всё же зависимость другого проекта. Если вы создаёте собственные блоки геля, их поведение можно расширять через методы интерфейса blocks.IStructureGel.