Structure Item Mod

Инструмент для создания модификаций

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

Принцип работы

Мод добавляет специальный предмет, который при использовании размещает заранее подготовленные структуры. Все параметры размещения настраиваются через NBT-теги, что обеспечивает гибкость в настройке.

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

Базовый пример конфигурации для версии 1.20 и ниже:

structure_item:item{offset:{X:0,Y:5,Z:0},structure:"structure:mine",allowedOn:"minecraft:stone",blacklist:["minecraft:bedrock"],replaceEntities:0,placeEntities:0,rotate:"north"}

Для версии 1.21 и выше:

structure_item:item[minecraft:custom_data={offset:{X:0,Y:5,Z:0},structure:"structure:mine",allowedOn:"minecraft:stone",blacklist:["minecraft:bedrock"],replaceEntities:0,placeEntities:0,rotate:"north"}]

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

Настройка параметров

Обязательные параметры:

• structure - идентификатор структуры (обязательный параметр)

Дополнительные параметры:

• offset - смещение структуры относительно точки клика (по умолчанию - автоматическое размещение)
• allowedOn - разрешенные блоки для размещения (по умолчанию - любые блоки)
• blacklist - запрещенные блоки для замены (по умолчанию - разрешена замена любых блоков)
• replaceEntities - разрешение на замену существующих сущностей (0 - запрещено, 1 - разрешено)
• placeEntities - размещение сущностей из структуры (0 - запрещено, 1 - разрешено)
• rotate - ориентация структуры (по умолчанию - без поворота)

Расширенное позиционирование с offsetV2

Для более сложного позиционирования используйте offsetV2 с поддержкой математических выражений:

offsetV2:{x:"~",y:"~-sizeY/2",z:"~"}

Данный пример размещает структуру перед блоком с центрированием по вертикали.

Поддерживаемые операции

Арифметические операции: сложение, вычитание, умножение, деление, возведение в степень, унарные операторы, модуль.

Математические функции: abs, acos, asin, atan, cbrt, ceil, cos, cosh, exp, floor, log, log10, log2, sin, sinh, sqrt, tan, tanh, signum.

Специальные функции: dirSelect(dir, down, up, north, south, west, east) - выбор значения в зависимости от стороны блока.

Доступные переменные

• Математические константы: pi, e, φ
• dir - сторона блока
• sizeX, sizeY, sizeZ - размеры структуры

Обработка ошибок

Ошибки конфигурации отображаются в чате, а ошибки использования - крупным текстом в центре экрана.

Кастомизация

Вы можете изменить внешний вид предмета (по умолчанию - палка) и локализацию через языковые файлы.