Build Guide
Мод, работающий только на стороне клиента, для проецирования фигур, таких как круги и сферы, в мир. Он работает как в одиночной игре, так и в многопользовательской, даже если на сервере не установлен мод.
Краткое руководство по использованию
Использование
Нажатие клавиши '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`. В противном случае фигуры будут потеряны при закрытии клиента.
Фигуры
Catenary: Цепная линия (также известная как линия цепи или веревки) между двумя точками с длиной дуги (длиной веревки), равной расстоянию между этими точками плюс заданное дополнительное расстояние.
Circle: Круг, который может быть расположен вокруг любой из трех осей и может быть сложен для формирования стен или труб.
Cone: Конус, который может быть направлен по любой из трех осей с заданным радиусом и высотой.
Cuboid: Полый кубоид с переключаемыми стенками.
Ellipse: Эллипс, который может быть расположен вокруг любой из трех осей и может быть сложен для формирования стен или труб.
Ellipsoid: Эллипсоид, который также можно превратить в один из шести возможных куполов в направлении вдоль оси.
Grid: Сетка блоков с заданным размером шага и количеством шагов по каждой из трех осей.
Line: Линия в одном из шести направлений вдоль оси.
Parabola: Парабола с заданной половинной шириной и высотой, обращенная в заданном направлении и повернутая на заданный угол.
Paraboloid: Параболоид, направленный по любой из трех осей с двумя заданными половинными ширинами и заданной высотой.
Polygon: Треугольник, квадрат, пятиугольник, шестиугольник и т.д. Может быть повернут вокруг любой из трех осей и может быть сложен для формирования стен или труб.
Polygonal pyramid: Пирамида с основанием в виде многоугольника. Может быть повернута вокруг любой из трех осей.
Sphere: Сфера, которую также можно превратить в один из шести возможных куполов в направлении вдоль оси.
Torus: Форма, похожая на пончик, с настраиваемым радиусом и толщиной, которая может быть расположена вокруг любой из трех осей.
Полное руководство по использованию
Графический интерфейс Build Guide
К графическому интерфейсу Build Guide можно получить доступ с помощью назначенной клавиши. По умолчанию эта клавиша — 'B', но, как и любую другую назначенную клавишу, ее можно изменить через настройки Minecraft (при закрытом интерфейсе, Escape -> Options -> Controls для Minecraft 1.17 и ниже, Escape -> Options -> Controls -> Key Binds для Minecraft 1.18 и выше). В этом под-интерфейсе вы можете работать только с одной фигурой за раз. Интерфейс разделен на четыре под-интерфейса, доступных через четыре кнопки вверху: 'Shape', 'Visualization', 'Shape list' и 'Configuration'. В верхнем левом углу находится глобальный флажок 'Enable', который переключает отображение фигур. Также существует назначенная клавиша (по умолчанию не назначена) под названием 'Toggled enabled' как альтернатива флажку 'Enable'. Общее количество блоков для выбранной фигуры и для всех фигур в целом можно найти вверху. Первая строка показывает точное количество блоков. Вторая строка показывает это количество в виде числа стаков плюс остаток. Кнопка 'X' в верхнем правом углу закроет интерфейс, так же как и нажатие Escape.
Под-интерфейс Shape
Под-интерфейс Shape разделен на три раздела: 'Shape', 'Origin' и 'Shape properties'.
Shape
Раздел 'Shape' определяет, какая фигура отображается. Изначально это будет первая фигура, известная моду, которой должен быть круг. Нажатие кнопок со стрелками слева и справа от названия текущей фигуры перебирает доступные фигуры.
Origin
На данный момент у вас должна быть случайная фигура, которая отображается (если вы нажали флажок 'Enable'). Скорее всего, вы захотите переместить эту фигуру, для чего и предназначен этот раздел под-интерфейса. Предполагая, что вы еще не касались интерфейса Visualization, вы должны видеть два вида отображаемых блоков; много белых блоков, которые очерчивают фигуру, и один маленький красный блок, который называется 'origin' (точка отсчета) фигуры. Эта точка отсчета является основой фигуры и обычно представляет собой что-то вроде центра круга или начало линии. Исходная точка отсчета будет находиться в том месте, где вы находились, когда впервые открыли интерфейс. Кнопки в разделе 'Origin' изменяют местоположение точки отсчета, и блоки, очерчивающие фигуру, будут перемещаться вместе с ней. Первая кнопка, 'Set origin', просто перемещает точку отсчета к вашим ногам. Другие три строки позволяют более точно управлять каждой из трех компонент позиции (X, Y и Z). Кнопки '-' и '+' уменьшают и увеличивают соответствующую компоненту соответственно. Точное значение можно ввести в черное текстовое поле. Нажатие кнопки 'Set' попытается установить компоненту в значение из текстового поля. Если это значение не является допустимым целым числом, компонента не будет обновлена, и текст станет красным. Ввод допустимого числа снова сделает его белым. Кроме того, существует назначенная клавиша (по умолчанию не назначена) с тем же названием, которая действует как кнопка 'Set origin'.
Shape properties
Наконец, раздел 'Shape properties' содержит параметры фигуры; длина, радиус, ориентация и т.д. Параметры для каждой фигуры и их описания можно найти в разделе 'Shapes' далее в этом руководстве. При переключении между фигурами их параметры сохраняются.
Под-интерфейс Visualization
Под-интерфейс Visualization можно открыть, нажав кнопку 'Visualization'. Под-интерфейс Visualization в основном содержит два набора из четырех ползунков и две кнопки. Левый набор управляет цветом блоков, очерчивающих фигуру, а правый набор управляет цветом маленького блока точки отсчета. Каждый из четырех ползунков управляет одной из цветовых компонент соответствующего типа блоков: Красный, Зеленый, Синий и Альфа. Последняя, Альфа, — это прозрачность блоков. После того как ползунки установлены в желаемое положение, цвет можно применить, нажав 'Set'. Нажатие 'Default' вернет цвета к значениям по умолчанию: белый для блоков, очерчивающих фигуру, и красный для блока точки отсчета. Флажок 'Depth test' внизу определяет, будет ли использоваться тест глубины при отображении, что является техническим термином для "рисовать это только если между этим и камерой ничего нет". Другими словами, снятие флажка 'Depth test' позволит вам видеть блоки, очерчивающие фигуру, и блок точки отсчета сквозь мир. Это нельзя использовать в качестве формы рентгеновского зрения или другого вида читов, так как мод никак не взаимодействует с миром.
Под-интерфейс Shape List
Нажатие кнопки 'Shape list' переведет вас в под-интерфейс Shape List. Как и под-интерфейс Shape, под-интерфейс Shape List разделен на четыре раздела: 'Add new shape', 'Selected shape', 'Global origin' и 'Shapes'.
Add new shape
В этом разделе вы снова сможете перебирать фигуры. Переход к desired фигуре и нажатие кнопки 'Add' под ней добавит фигуру в список в разделе 'Shapes'. Точка отсчета для вновь добавленной фигуры будет у ваших ног. Вы можете свободно перебирать и добавлять другие фигуры, не влияя на те, которые вы добавили ранее.
Selected shape
Отключение флажка 'Visible' скроет выбранную фигуру, что указывается ее зачеркиванием в списке фигур. Нажатие кнопки 'Delete' удалит фигуру из списка фигур.
Global origin
Этот раздел работает аналогично обычному разделу 'Origin' в под-интерфейсе Shape. Использование кнопок и текстовых полей установит точку отсчета выбранной в данный момент фигуры. Однако точки отсчета всех других фигур также изменятся таким образом, что фигуры сохранят те же относительные позиции. Также, как и при обычном управлении точкой отсчета, для кнопки 'Set global origin' существует альтернатива в виде назначенной клавиши с тем же названием, которая по умолчанию не назначена.
Shapes
Список в разделе 'Shapes' перечисляет текущие активные фигуры. Щелчок по одной из фигур в списке выделит ее, что указывается черной рамкой вокруг нее. Если добавлено слишком много фигур, чтобы уместиться на экране, справа от списка появится полоса прокрутки. Перетаскивание полосы прокрутки или использование колесика мыши позволит прокручивать список. Установка цвета в интерфейсе Visualization также будет влиять только на выбранную в данный момент фигуру. Однако на данный момент флажок теста глубины все еще является глобальной настройкой, meaning что он влияет на все фигуры, а не только на выбранную. Это поведение, вероятно, изменится в будущем, чтобы быть более согласованным с остальными визуальными настройками. Если вы удалили все фигуры из списка, многие кнопки в большинстве под-интерфейсов будут отключены, так как не будет никакой фигуры, на которую можно было бы воздействовать. Добавление фигуры снова включит их.
Под-интерфейс Configuration
Нажатие кнопки 'Configuration' откроет под-интерфейс Configuration. Этот под-интерфейс предлагает прямой и мгновенный доступ к файлу конфигурации (см. раздел Configuration в конце описания мода). Изменение значений не потребует перезапуска для вступления в силу.
Фигуры
Большинство фигур по умолчанию могут быть только нечетного размера, потому что точка отсчета центрирована на одном блоке (например, таким образом, круги могут быть только 3x3, 5x5, 7x7 и т.д.). У всех таких фигур есть флажок 'Even mode' для смещения точки отсчета на полблока в соответствующих направлениях (из предыдущего примера, круги теперь могут быть только 4x4, 6x6, 8x8 и т.д.). Некоторые параметры также допускают отрицательные значения, что может, например, перевернуть фигуру в сторону отрицательной оси.
Catenary
Цепная линия, также известная как линия цепи или веревки, которая представляет собой форму веревки, свисающей между двумя точками. Две точки, на которых основана цепная линия, — это точка отсчета и точка относительно точки отсчета, описанная параметрами 'Delta X', 'Delta Y' и 'Delta Z'. Эту вторую точку также можно установить с помощью кнопки 'Set endpoint', которая помещает эту позицию у ваших ног. Длина дуги цепной линии (длина веревки) определяется расстоянием между двумя точками плюс значение, указанное в 'Additional distance', которое должно быть равно 1 или более.
Circle
Простой круг. Свойство 'Direction' определяет, вокруг какой оси расположен круг. Например, при установке на 'X' круг будет расширяться в направлениях Y и Z. 'Radius' устанавливает радиус круга и может быть любым положительным целым числом. Увеличение 'Depth' создаст цилиндрическую трубку в направлении, заданном 'Direction'.
Cone
Конус. Свойство 'Direction' определяет, на какую ось направлен конус. 'Radius' устанавливает радиус конуса и может быть любым положительным целым числом. 'Height' устанавливает высоту конуса и может быть отрицательным.
Cuboid
Кубоид — это полая кубообразная форма, где длина каждой стороны задается параметрами 'X', 'Y' и 'Z', которые должны быть положительными целыми числами. Параметр 'Walls' показывает стенки, которые в данный момент активны, где, например, наличие 'X' означает, что стенки в направлении отрицательной X и положительной X включены, и аналогично для 'Y' и 'Z'. '-' означает, что никакие стенки не включены, и кубоид является только каркасом. Вы можете выбрать, является ли точка отсчета углом или центром кубоида.
Ellipse
Эллипс очень похож на круг. Единственное различие заключается в том, что вместо радиуса он использует две полуоси. Эти полуоси работают аналогично радиусу, но, если рассматривать радиус, работающий в двух направлениях, эти полуоси работают только в одном направлении, которое указано в названии параметра.
Ellipsoid
Эллипсоид относится к сфере так же, как эллипс к кругу. Его единственное отличие от сферы заключается в том, что теперь у него три полуоси вместо радиуса. Как и сфера, он также имеет режимы купола.
Grid
Сетка блоков. Количество блоков и размер шага между блоками можно изменять для каждого направления.
Line
Простая линия. Две точки, на которых основана линия, — это точка отсчета и точка относительно точки отсчета, описанная параметрами 'Delta X', 'Delta Y' и 'Delta Z'. Эту вторую точку также можно установить с помощью кнопки 'Set endpoint', которая помещает эту позицию у ваших ног.
Parabola
Парабола. Ее форма описывается параметрами 'Half-width' и 'Height', так что точка (Half-width,Height) является частью параболы. 'Direction' и 'Rotation' позволяют параболе быть обращенной в определенном направлении и повернутой на заданную величину. 'Depth' добавит слои в направлении 'Direction' и может быть отрицательным.
Paraboloid
Параболоид. Он работает аналогично параболе, но теперь имеет две половинные ширины в направлениях, заданных названиями параметров. Поворот теперь задается только параметром 'Direction'.
Polygon
Многоугольник — это правильная форма с заданным количеством сторон. Это количество сторон задается параметром 'Sides'; 3 дает треугольник, 4 дает квадрат, 5 дает пятиугольник и т.д. Параметр 'Sides' должен быть целым числом, равным 3 или более. 'Radius' — это несколько свободная интерпретация радиуса, и это расстояние между точкой отсчета и одной из сторон. 'Radius' должен быть положительным целым числом. 'Direction' работает так же, как и с кругом, определяя, вокруг какой оси расположен многоугольник. 'Rotation' — это кратное 90°, на которое будет повернут многоугольник. Наконец, 'Height' работает так же, как и с кругом.
Polygonal pyramid
Пирамида с основанием в виде многоугольника. Она работает идентично обычному многоугольнику, но вместо 'Depth' у нее есть 'Height' для высоты пирамиды. Обратите внимание, что заданная высота может не быть конечной высотой.
Sphere
Сфера с радиусом, заданным 'Radius', который является положительным целым числом. 'Dome' устанавливает режим купола сферы: '-' означает отключено, а любой другой вариант будет показывать только одно полушарие сферы в направлении, которое он описывает.
Torus
Также известен как пончик. Как и круг, параметр 'Direction' определяет, вокруг какой оси он расположен. Если представить тор как трубку вокруг кольца, то 'Outer radius' — это радиус кольца, а 'Inner radius' — радиус трубки. Оба они должны быть положительными целыми числами, и 'Outer radius' всегда должен быть больше или равен 'Inner radius'. Если 'Outer radius' установлен меньше, чем 'Inner radius', или 'Inner radius' установлен больше, чем 'Outer radius', другой параметр будет установлен в то же значение.
Перемещение между мирами, серверами и измерениями
Планирование фигур обычно выполняется в очень специфической среде; фигуры в вашем одиночном мире могут не иметь смысла на вашем любимом сервере или в другом мире, а здание, которое вы запланировали в Верхнем мире, совершенно бесполезно в Энде, где оно парит в пустоте в 500 блоках от вас. Поэтому последняя версия мода будет иметь разное состояние для каждой уникальной комбинации мира/IP-адреса сервера и измерения. На момент написания нет возможности передать это состояние в другой мир/сервер/измерение, но будущая версия мода реализует переключение этого поведения и перемещение/копирование состояний. По умолчанию фигуры и состояния теряются между перезапусками клиента. Включение опции конфигурации `persistenceEnabled` позволяет моду сохранять фигуры и состояния в файлы и восстанавливать их при перезапуске клиента. Из-за технических ограничений восстановление состояния начнется, когда вы откроете графический интерфейс.
