Structure Gel API

Structure Gel API - это мод для Майнкрафт, который серьёзно упрощает жизнь разработчикам, создающим генерируемые структуры. Особенно если вы работаете с системой jigsaw - тем самым пазлом, из которого собираются деревни, крепости и прочие постройки. Вместо того чтобы вручную прописывать каждый блок и возиться с террейном, этот API берёт рутину на себя.

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

Что внутри?

Building Tool - инструмент для строительства

Это предмет из креативной вкладки "Structure Items", который позволяет делать масштабные операции с блоками прямо в игре. Никаких команд - всё через удобный интерфейс.

Как пользоваться:

• Нажмите ПКМ по воздуху - откроется GUI с настройками.
• ЛКМ выполняет действие в зависимости от выбранного режима.
• Средняя кнопка мыши выбирает блок, на который вы смотрите.
• Shift+ПКМ сбрасывает выделенные позиции.

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

• Extend - продолжает узор от блока, который вы кликнули. Похоже на старый мод Builder's Wands.
• Flood - заливает все воздушные блоки на уровне клика, пока не упрётся в границу, затем идёт вниз. Удобно для заполнения озёр водой.
• Fill - аналог команды /fill, но с GUI. Можно выбрать замену только определённых блоков или сделать только рамку/пустотелую коробку.
• Line - проводит линию из выбранного блока между двумя точками.
• Clone - копирует выделенную область и вставляет туда, куда кликнете. Поддерживает поворот, отражение и вырезание вместо копирования.
• Move - перемещает выделенную область в направлении удара.
• Clear - удаляет все блоки внутри выделения.
• Shape - размещает фигуру (форму можно настроить).

У некоторых режимов есть дополнительные свойства: целостность (сколько блоков реально поставится), замена (все/воздух/только кликнутый блок), поворот и отражение.

Structure Gel Block - гели для заполнения пустот

Это специальные блоки, которые помогают заполнять внутренности структур. Когда структура генерируется, гель заменяется воздухом, а воздух снаружи игнорируется. Так ваша постройка не обрастает лишним ландшафтом. Гель можно проходить насквозь (как структурные пустоты), но он видимый.

Если ставить гель крадучись, он начинает распространяться. У каждого цвета своя логика:

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

Удаление гелей: используйте порох на геле - это вызовет цепную реакцию и уберёт все связанные гели того же типа.

Пример использования

Допустим, вы построили структуру в виде дома. Внутри него вы ставите гель (например, красный), а снаружи оставляете воздух. При генерации гель исчезнет (заменится воздухом), а воздух снаружи не появится - структура будет стоять как надо, без лишних блоков внутри.

Код гелей спроектирован так, что вы можете легко расширить его через интерфейс IStructureGel, если нужно нестандартное поведение.

Важно знать

Это core-мод - он изменяет несколько внутренних классов игры. Если у вас возникает краш только при смешивании с другим модом, возможно причина в этом. Тестируйте перед тем как сообщать о баге.

Для примера работы API можно посмотреть на Dungeons Plus - это открытый проект, использующий Structure Gel API.

Скачайте Structure Gel API и упростите себе создание структур в Майнкрафт!