Build Guide [1.21.8] [1.20.6] [1.19.4]

Использование

Нажатие клавиши 'Open Build Guide' (по умолчанию: 'B') открывает графический интерфейс Build Guide, изначально находящийся на под-интерфейсе 'Shape'. Переключение чекбокса 'Enable' в левом верхнем углу определяет, будет ли отображаться фигура. Чуть ниже этого чекбокса находятся две кнопки для переключения между доступными фигурами (список в разделе 'Shapes' данного руководства). Кнопка 'Set origin' устанавливает местоположение маленького куба (по умолчанию красного) у ваших ног. Этот куб является основой для фигуры (например, началом линии или центром круга). Позицию точки отсчета также можно изменить с помощью текстовых полей и кнопки ниже 'Set origin'. В середине или справа в интерфейсе находится список свойств выбранной фигуры, таких как радиус или ориентация. Некоторые свойства допускают отрицательные значения, что позволяет, например, отразить фигуру вдоль отрицательной оси.

Кнопка 'Visualization' открывает под-интерфейс с ползунками для изменения цветов большего куба фигуры (по умолчанию белого) и меньшего куба точки отсчета (по умолчанию красного). Здесь также есть опция 'Depth test'; ее отключение позволяет видеть фигуру сквозь блоки.

Нажатие 'Shape list' позволяет использовать несколько фигур одновременно. В этом под-интерфейсе кнопка 'Add' добавляет экземпляр фигуры, показанной выше. Добавляемую фигуру также можно переключать. Каждая фигура в списке имеет свою собственную точку отсчета, по умолчанию расположенную у ваших ног при добавлении. Щелчок по фигуре в списке в центре экрана выделяет ее (черная полоса). Выделенную фигуру можно изменять в интерфейсе 'Shape'. Отключение чекбокса 'Visible' временно скрывает выбранную фигуру и исключает ее из подсчета общего количества блоков. Кнопка 'Delete' удаляет выбранную фигуру. Кнопки и поля 'Global origin' смещают точку отсчета выбранной фигуры аналогично обычным кнопкам в главном интерфейсе, но точки отсчета невыбранных фигур также смещаются относительно, сохраняя относительное положение.

Все фигуры и их настройки привязаны к названию мира (одиночная игра) или IP-адресу сервера (мультиплеер) и измерению. Фигуры можно сохранять между перезапусками клиента, включив опцию конфигурации `persistenceEnabled`. В противном случае фигуры будут потеряны при закрытии клиента.

Фигуры (Shapes)

Catenary: Цепная линия между двумя точками с длиной дуги (длиной веревки), равной расстоянию между этими точками плюс заданное дополнительное расстояние.

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

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

Cuboid: Полый прямоугольный параллелепипед с включаемыми/выключаемыми стенками.

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

Ellipsoid: Эллипсоид, который также можно преобразовать в один из шести возможных куполов, направленных вдоль оси.

Grid: Сетка блоков с заданным размером шага и количеством шагов по каждой из трех осей.

Line: Линия в одном из шести направлений вдоль оси.

Parabola: Парабола с заданной полушириной и высотой, направленная в заданном направлении и повернутая на заданный угол.

Paraboloid: Параболоид, направленный вдоль любой из трех осей, с двумя заданными полуширинами и высотой.

Polygon: Треугольник, квадрат, пятиугольник, шестиугольник и т.д. Может вращаться вокруг любой из трех осей и накладываться для формирования стен или труб.

Polygonal pyramid: Пирамида с основанием в виде многоугольника. Может вращаться вокруг любой из трех осей.

Sphere: Сфера, которую также можно преобразовать в один из шести возможных куполов, направленных вдоль оси.

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

Графический интерфейс Build Guide

Доступен через назначенную клавишу (по умолчанию 'B'). Интерфейс разделен на четыре под-интерфейса: 'Shape', 'Visualization', 'Shape list' и 'Configuration'. Вверху слева глобальный чекбокс 'Enable' включает/отключает отображение фигур. Также существует клавиша 'Toggle enabled' (по умолчанию не назначена) как альтернатива чекбоксу. Вверху отображается общее количество блоков для выбранной фигуры и всех фигур. Кнопка 'X' вверху справа закрывает интерфейс.

Под-интерфейс 'Shape'

Разделен на три секции: 'Shape', 'Origin', 'Shape properties'.

Shape: Определяет отображаемую фигуру. Кнопки-стрелки переключают доступные фигуры.

Origin: Управляет позицией маленького красного куба (точки отсчета фигуры). Кнопка 'Set origin' перемещает его к ногам игрока. Поля и кнопки 'X', 'Y', 'Z' позволяют точно задать координаты.

Shape properties: Содержит параметры выбранной фигуры (радиус, длина, ориентация и т.д.).

Под-интерфейс 'Visualization'

Две группы ползунков управляют цветом (RGBA) блоков фигуры (левая группа) и блока точки отсчета (правая группа). Кнопка 'Set' применяет цвета, 'Default' возвращает стандартные цвета (белый и красный). Чекбокс 'Depth test' определяет, будут ли блоки фигуры скрываться за другими блоками мира.

Под-интерфейс 'Shape List'

Позволяет работать с несколькими фигурами.

Add new shape: Переключение и кнопка 'Add' добавляет новую фигуру (точка отсчета - у ног игрока).

Selected shape: Чекбокс 'Visible' скрывает/показывает выбранную фигуру. Кнопка 'Delete' удаляет ее.

Global origin: Кнопки и поля смещают точку отсчета выбранной фигуры. Точки отсчета других фигур смещаются относительно, сохраняя их взаимное расположение. Кнопка 'Set global origin' имеет клавишу-аналог.

Shapes: Список активных фигур. Щелчок по фигуре выделяет ее. Цвета в 'Visualization' применяются только к выбранной фигуре. 'Depth test' глобальный (влияет на все фигуры).

Под-интерфейс 'Configuration'

Прямой интерфейс для редактирования файла конфигурации. Изменения вступают в силу мгновенно.

Фигуры (Shapes) - Детали

Большинство фигур по умолчанию имеют нечетный размер из-за центра на блоке. Чекбокс 'Even mode' позволяет использовать четные размеры (сдвигая точку отсчета). Отрицательные значения параметров могут отражать фигуру.

Catenary: Точки определяются точкой отсчета и смещением ('Delta X/Y/Z'). Кнопка 'Set endpoint' устанавливает вторую точку у ног. 'Additional distance' (≥1) - добавка к длине дуги.

Circle: 'Direction' - ось вращения. 'Radius' - радиус (целое >0). 'Depth' - глубина (высота цилиндра).

Cone: 'Direction' - ось направления. 'Radius' - радиус основания (целое >0). 'Height' - высота (может быть отрицательной).

Cuboid: 'X', 'Y', 'Z' - размеры сторон (целые >0). 'Walls' - включенные стенки (X, Y, Z, '-' - каркас). Можно выбрать угол или центр как точку отсчета.

Ellipse: Аналогична кругу, но использует две полуоси.

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

Grid: 'Steps' - количество блоков, 'Step size' - расстояние между ними по осям.

Line: Определяется точкой отсчета и смещением ('Delta X/Y/Z'). Кнопка 'Set endpoint'.

Parabola: 'Half-width' - полуширина, 'Height' - высота. 'Direction' - направление, 'Rotation' - угол поворота. 'Depth' - глубина (слои).

Paraboloid: Две полуширины. 'Direction' определяет ось и вращение.

Polygon: 'Sides' - количество сторон (≥3). 'Radius' - расстояние от центра до стороны (целое >0). 'Direction' - ось вращения. 'Rotation' - поворот (кратно 90°). 'Height' - высота.

Polygonal pyramid: Аналогична многоугольнику, но параметр 'Height' задает высоту пирамиды.

Sphere: 'Radius' - радиус (целое >0). 'Dome' - режим купола ('-' - выкл.).

Torus: 'Direction' - ось вращения. 'Outer radius' - радиус кольца (целое >0). 'Inner radius' - радиус трубы (целое >0). 'Outer radius' ≥ 'Inner radius'.

Переход между мирами, серверами и измерениями

Состояние мода (фигуры, настройки) уникально для каждой комбинации мир/сервер и измерение. Опция конфигурации `persistenceEnabled` сохраняет состояние между перезапусками клиента (экспериментально, возможны проблемы на Forge). Восстановление происходит при открытии интерфейса.