Structure Gel API

API для упрощения создания сгенерированных структур разработчиком.

---

Structure Gel — это мод API, призванный упростить разработчикам создание структур, особенно тех, которые используют систему головоломки. Весь код имеет открытый исходный код и документирован.
Некоторые из его функций включают в себя:

📚 Прочтите документацию по API Structure Gel здесь

Рабочий пример этого API с открытым исходным кодом можно найти на странице Dungeons Plus

.

Вы можете найти подробную информацию о том, как разработать и использовать этот API в зависимости от версии Minecraft.

Последняя документация

• https://gitlab.com/modding-legacy/structure-gel-api/-/blob/1.21.4/README.md?ref_type=heads

🧪 Последние функции

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

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

• Его можно найти на вкладке творческого режима «Элементы структуры».
• Щелкните правой кнопкой мыши по строительному инструменту в воздухе, чтобы открыть графический интерфейс. После открытия вы можете выбрать, какой режим вы хотите использовать, отменить, повторить, выбрать свою позицию и многое другое.
  
  

ГПИ

Графический интерфейс содержит различные кнопки для изменения настроек Building Tool, а также некоторые удобные инструменты.

• Нажатие, enter, e, escape или щелчок в любом месте экрана, кроме кнопки, закроет графический интерфейс.
• При наведении курсора на любой элемент графического пользовательского интерфейса справа отобразится всплывающая подсказка, объясняющая, что он делает и как его использовать.
• Используя круговое меню, вы можете выбрать режим, который хотите использовать.
• Некоторые режимы поддерживают позиции. Если да, то в левом верхнем углу появится кнопка для выбора позиции в зависимости от вашего текущего местоположения. В основном это полезно, когда щелчок правой кнопкой мыши по блоку невозможен или крайне неудобен.
• Кнопки «Отменить» и «Повторить» слева созданы для того, чтобы делать именно то, что они говорят. Они пытаются отменить или повторить последнее действие, которое вы выполнили с помощью Building Tool. Сохраняется до 32 действий, которые можно отменить.
• Некоторые режимы имеют дополнительные настройки, эти настройки отображаются под кнопками отмены и повтора.
• Кнопка посередине используется для выбора блока, который вы хотите использовать. При нажатии на него откроется текстовое поле, в котором можно ввести состояние блока. Это можно сделать и в игре, но на некоторые блоки, например воду, нажать более чем сложно.

Управление

• Средний щелчок: выбирает текущее состояние блока, на которое вы смотрите (также можно сделать в графическом интерфейсе).
• Левый клик: это общая клавиша «сделать дело» в зависимости от того, в каком режиме вы находитесь.
• Щелчок правой кнопкой мыши по воздуху: открывает графический интерфейс.
• Блокировка правого щелчка: в некоторых режимах это используется для установки позиций, но в других режимах это также не позволяет «делать свое дело».
• Shift + щелчок правой кнопкой мыши: очищает текущие выбранные позиции.

Режимы

Режимы строительного инструмента — это различные операции, которые может выполнять Строительный инструмент.

• Расширить: обнаруживает шаблон на основе стороны блока, на котором вы щелкаете, и пытается разместить блоки перед ним, чтобы продолжить этот шаблон. Если вы знакомы со старым модом Builder's Wands, то по сути это та же идея.
  
  
  
  
• Наводнение: заполняет все воздушные блоки внутри фрагмента уровня y, на котором вы щелкаете, пока он не достигнет границы, а затем продолжает заполнять вниз. Это полезно, например, для наполнения озера водой.
  
  .
• Заливка: Очень похоже на стандартную команду заливки. Выберите два угла, а затем щелкните левой кнопкой мыши, чтобы заполнить область между ними выбранным в данный момент блоком. Имеет возможность замены определенных блоков и размещения только рамы или полого ящика.
  
  
• Линия: размещает линию блоков между выбранными позициями, используя текущий выбранный блок.
  
  .
• Клонировать: копирует выбранный регион и вставляет его в то место, куда вы щелкнули. Позволяет вращать, зеркально отражать и вырезать вместо копирования.
  
  
  
  
• Переместить: перемещает выбранный регион в том направлении, в котором вы нажимаете.
  
  
• Очистить: удаляет все блоки в выбранных позициях.
  
  .
• Фигура: размещает фигуру там, где вы щелкаете. Форму и блоки, которые будут заменены, можно изменить с помощью свойств режима в графическом интерфейсе.
  
  

Свойства режима

Некоторые режимы поддерживают дополнительные настройки для изменения их поведения. Некоторые примеры включают:

.

• Целостность: определяет, сколько блоков будет фактически размещено.
• Replace: определяет, что будет заменено в режиме при размещении блоков. «Все» заменяет все, «Воздух» заменяет только воздух, а «Нажатие» заменяет блок, на который вы нажали.
• Поворот и зеркало: вращает или зеркально отображает клонированную область. Также позволяет выбрать случайное значение.

🍡 Блок структурного геля

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

Размещая гель во время подкрадывания, вы можете активировать механику распространения. Каждый гель распределяется по-разному, и вы можете прочитать, как они работают, наведя курсор на предмет.

🍮 Знакомьтесь, Гели!

🟥Красный гель

Красный гель использует механику распространения по умолчанию: распространяется по сторонам света, заменяя только воздух.

Спойлер

🟦 Синий гель

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

Спойлер

🟩 Зеленый гель

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

. Спойлер

🟦 Голубой гель

Голубой гель действует как комбинация зеленого и синего геля, распределяясь по диагонали и избегая неба.

Спойлер

🟧 Апельсиновый гель

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

Спойлер

🟨 Желтый гель

Желтый гель при размещении будет растекаться только вдоль той плоскости, к которой вы смотрите, что делает его идеальным для герметизации стен, окон или других отверстий, через которые в противном случае гель мог бы пройти.

Спойлер

---

Удаление гелей

Гель можно удалить, нанеся на него порох. Это вызовет цепную реакцию, удаляющую все связанные гели одного типа.

. Спойлер

---

Примеры

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

Спойлер

Код этого блока спроектирован таким образом, что вы можете легко расширить его и подключиться к его поведению с помощью методов в блоках IStructureGel, если вам нужно поведение, которое еще не реализовано.

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

---

🌐 API Translate Structure Gel — помогите преодолеть языковой барьер!

Здесь указаны все переводчики. Спасибо всем, кто помогает сделать этот мод доступным!

| Флаг | Язык | Переводчики | |------|----------|-------------| | | Немецкий | A1403, Барион | | | Португалия (Бразилия) | габисау, симсгеймебо | | | Нидерланды (Нидерланды) | Фаас.мр | | | Испанский (Испания) | Минадерм, гильермоджуэготаблет, джаггерногк | | | Украинская (Украинская) | Киз | | | Türkçe (Тюркье) | асимемир58, демиргоклер406 | | | עברית ('Иврийþ) | пекан1245 | | | Испанский (Аргентина) | патрициофагетти | | | Итальяно (Италия) | Антониоаусиелло226 | | | Летувью | УэриRGMCA |

---

🤚 Поддержка: Если у вас есть вопросы или проблемы с нашими модами, прочтите FAQ! Вы также можете отправить проблему в систему отслеживания проблем или зайти на наш сервер Discord, где мы сможем вам помочь!