Build Guide

Руководство по сборке

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

Краткое руководство по использованию

Показать

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

Нажатие клавиши «Открыть руководство по сборке» (по умолчанию: «B») откроет графический интерфейс руководства по сборке, который изначально находится в суб-GUI Shape. Переключение флажка «Включить» в левом верхнем углу определяет, будет ли отображаться фигура. Немного ниже этого флажка вы можете найти две кнопки для переключения доступных фигур, которые можно найти в разделе «Фигуры» внизу данного руководства по использованию. Кнопка «Установить начало координат» задаст местоположение маленького кубика (по умолчанию красного цвета) у ваших ног. Этот куб — ​​это то, на чем будет основана фигура (например, начало линии или центр круга). Начало координат также можно изменить с помощью текстовых полей и кнопки под кнопкой «Установить начало координат». В середине или справа от графического интерфейса находится список свойств, принадлежащих выбранной в данный момент фигуре, например радиус или ориентация. Некоторые свойства также допускают отрицательные значения, которые могут, например, перевернуть фигуру в сторону отрицательной оси.

Кнопка «Визуализация» переводит вас в дополнительный графический интерфейс с ползунками для изменения цвета большего куба фигуры (по умолчанию белый) и меньшего исходного куба (по умолчанию красного). Этот суб-GUI также содержит опцию для переключения «Тест глубины»; отключение теста глубины позволяет вам видеть форму сквозь блоки.

Нажатие «Список фигур» позволит вам использовать несколько фигур одновременно. В этом дополнительном графическом интерфейсе нажатие кнопки «Добавить» добавляет экземпляр фигуры, показанной выше. Фигуру, которую нужно добавить, можно снова циклически менять, какую фигуру добавлять. Каждая фигура в списке имеет собственное начало координат, которое по умолчанию находится у вас под ногами при первом добавлении. Щелкнув фигуру в списке в центре экрана, вы выберете ее, обозначенную черной полосой. Выбранная фигура — это та фигура, которую можно изменить в графическом интерфейсе фигуры. Установка флажка «Видимый» может временно скрыть выбранную фигуру и игнорировать ее при общем количестве блоков. Нажатие «Удалить» удалит выбранную фигуру. Кнопки «Глобальное начало координат» и текстовые поля смещают начало координат выбранной фигуры так же, как обычные кнопки начала координат в главном графическом интерфейсе, но начало координат невыделенных фигур также будет выполнять те же относительные сдвиги, сохраняя относительное начало координат.

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

Фигуры

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

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

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

Кубоид: Полый кубоид с переключаемыми стенками.

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

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

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

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

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

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

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

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

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

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

Полное руководство по использованию

Показать

Графический интерфейс сборки

Доступ к графическому интерфейсу руководства по сборке можно получить с помощью сочетания клавиш. По умолчанию эта привязка клавиш будет «B», но, как и любую другую привязку клавиш, ее можно изменить в настройках Minecraft (при закрытом графическом интерфейсе выберите Escape-> Параметры -> Управление для Minecraft 1.17 и более ранних версий, Escape -> Параметры -> Управление -> Привязки клавиш для Minecraft 1.18 и более поздних версий). В этом суб-GUI вы можете обрабатывать только одну фигуру одновременно. Графический интерфейс разделен на четыре подинтерфейса, доступ к которым осуществляется с помощью четырех кнопок вверху: «Форма», «Визуализация», «Список форм» и «Конфигурация». В левом верхнем углу находится глобальный флажок «Включить», который включает отрисовку фигур. Также существует несвязанная по умолчанию привязка клавиш, которая называется «Включено включено» в качестве альтернативы флажку «Включить». Общее количество блоков для выбранной фигуры и для всех фигур в целом можно найти вверху. Первая строка — точное количество блоков. Вторая строка показывает эту сумму в количестве стопок плюс остаток. Кнопка «X» в правом верхнем углу закроет графический интерфейс, как и нажатие Escape.

Вложенный графический интерфейс Shape

Подинтерфейс Shape разделен на три раздела: «Форма», «Происхождение» и «Свойства формы».

Форма

Раздел «Форма» определяет, какая форма отображается. Изначально это будет первая фигура, о которой мод знает, и это должен быть круг. Нажатие кнопок со стрелками слева и справа от названия текущей фигуры будет переключаться между доступными фигурами.

Происхождение

На данный момент у вас должна быть произвольная фигура, которая визуализируется (если вы установили флажок «Включить»). Скорее всего, вам захочется переместить эту фигуру, и именно этому посвящен этот раздел дополнительного графического интерфейса. Предполагая, что вы еще не прикоснулись к графическому интерфейсу визуализации, вы должны увидеть два типа блоков; множество белых блоков, которые обрисовывают форму, и один маленький красный блок, который называется «начало» формы. Это начало координат является основой формы и обычно представляет собой что-то вроде центра круга или начала линии. Исходным источником будет то место, где вы находились, когда впервые открыли графический интерфейс. Кнопки в разделе «Происхождение» меняют местоположение начала координат, и блоки, отслеживающие форму, будут перемещаться вместе с ним. Первая кнопка «Установить начало координат» просто переместит начало координат на ноги. Остальные три линии позволяют более точно контролировать каждую из трех составляющих позиции (X, Y и Z). Кнопки «-» и «+» уменьшают и увеличивают соответствующий компонент соответственно. Точное значение можно ввести в черное текстовое поле. Нажатие кнопки «Установить» попытается установить для компонента значение, указанное в текстовом поле. Если это значение не является

допустимое целое число, компонент не будет обновляться, а текст станет красным. При попытке ввести действительный номер он снова станет белым. Кроме того, существует привязка клавиш, по умолчанию несвязанная, которая действует как кнопка «Установить начало координат» и имеет то же имя.

Свойства формы

Наконец, «Свойства формы» содержат параметры формы; длина, радиус, ориентация и т. д. Параметры для каждой формы и описания параметров можно найти в разделе «Фигуры» далее в этом руководстве по использованию. При циклическом переключении между фигурами их параметры будут сохраняться.

Вложенный графический интерфейс визуализации

Подинтерфейс визуализации можно открыть, нажав кнопку «Визуализация». Подграфический интерфейс визуализации в основном содержит два набора из четырех ползунков и двух кнопок. Левый набор управляет цветом блоков, которые обрисовывают форму, а правый набор управляет цветом небольшого исходного блока. Каждый из четырех слайдов управляет одним из цветовых компонентов соответствующего типа блока: красный, зеленый, синий и альфа. Последний из них, Альфа, — это прозрачность блоков. После того, как ползунки окажутся в нужном положении, цвет можно применить, нажав «Установить». Нажатие кнопки «По умолчанию» вернет цвета по умолчанию: белый для блоков трассировки формы и красный для исходного блока. Флажок «Тест глубины» внизу определяет, будет ли использоваться тестирование глубины во время рендеринга, что является техническим термином, означающим «рисовать это только в том случае, если между ним и камерой нет чего-то». Другими словами, сняв флажок «Проверка глубины», вы сможете увидеть блоки трассировки формы и исходный блок по всему миру. Это нельзя использовать как разновидность рентгена или другого вида чита, поскольку мод никак не взаимодействует с миром.

Вложенный графический интерфейс списка форм

Нажав кнопку «Список фигур», вы перейдете в графический интерфейс списка фигур. Как и субграфический интерфейс фигуры, субграфический интерфейс списка фигур разделен на четыре раздела: «Добавить новую фигуру», «Выбранная фигура», «Глобальное происхождение» и «Фигуры».

Добавить новую фигуру

В этом разделе вы снова сможете переключаться между фигурами. Перейдя к нужной фигуре и нажав кнопку «Добавить» под ней, вы добавите фигуру в список в разделе «Фигуры». Начало координат вновь добавленной фигуры будет у ваших ног. Вы можете свободно переключаться и добавлять другие фигуры, не затрагивая те, которые вы добавили ранее.

Выбранная фигура

Отключение флажка «Видимый» скроет выбранную фигуру, обозначенную тем, что она теперь перечеркнута в списке фигур. Нажатие кнопки «Удалить» удалит фигуру из списка фигур.

Глобальное происхождение

Этот раздел работает аналогично обычному разделу «Происхождение» в графическом интерфейсе Shape. С помощью кнопок и текстовых полей можно установить начало координат выбранной в данный момент фигуры. Однако происхождение всех остальных фигур также изменится, и фигуры сохранят то же относительное положение. Также, как и при обычной обработке источника, кнопка «Установить глобальное происхождение» имеет альтернативную привязку клавиш под тем же именем, которая по умолчанию не привязана.

Формы

В списке в разделе «Фигуры» перечислены активные в данный момент фигуры. Нажатие на одну из фигур в списке выберет ее, обозначенную черной рамкой вокруг нее. Если добавлено слишком много фигур, чтобы поместиться на экране, справа от списка появится полоса прокрутки. Список можно прокрутить либо перетаскиванием полосы прокрутки, либо использованием колеса прокрутки мыши. Установка цвета в графическом интерфейсе визуализации также повлияет только на текущую выбранную фигуру. Однако на данный момент флажок проверки глубины по-прежнему является глобальной настройкой, то есть он влияет на все фигуры, а не только на выбранную. Это поведение, вероятно, изменится в будущем и будет больше соответствовать остальным возможностям визуализации. Если вы удалили все фигуры из списка, многие кнопки в большинстве дополнительных графических интерфейсов будут отключены, поскольку не будет никакой формы, с которой можно было бы действовать. Добавление формы снова включит их.

Вложенный графический интерфейс конфигурации

Нажатие кнопки «Конфигурация» откроет графический интерфейс конфигурации. Этот дополнительный графический интерфейс предлагает прямой и мгновенный интерфейс к файлу конфигурации (см. раздел «Конфигурация» в конце описания мода). Изменение значений не потребует перезагрузки, чтобы вступило в силу.

Формы

По умолчанию большинство фигур могут иметь только нечетный размер, поскольку начало координат находится в центре одного блока (например, таким образом круги могут иметь размеры только 3х3, 5х5, 7х7 и т. д.). Все подобные фигуры имеют флажок «Четный режим», позволяющий сместить начало координат на полблока в соответствующих направлениях (из предыдущего примера круги теперь могут быть только 4x4, 6x6, 8x8 и т. д.). Некоторые параметры также допускают отрицательные значения, которые могут, например, перевернуть фигуру в сторону отрицательной оси.

Цепная линия

Цепная линия, также известная как цепная линия или веревочная линия, представляет собой форму веревки, висящей между двумя точками. Двумя точками, на которых основана цепная линия, являются начало координат и точка относительно начала координат, описываемая параметрами «Дельта X», «Дельта Y» и «Дельта Z». Эту вторую точку также можно установить с помощью кнопки «Установить конечную точку», которая помещает это положение у ваших ног. Длина дуги контактной сети (длина веревки) определяется расстоянием между двумя точками плюс значение, указанное в «Дополнительном расстоянии», которое должно быть 1 или более.

Круг

Простой круг. Свойство «Направление» определяет, по какой оси движется круг. Например, если установлено значение «X», круг будет расширяться в направлениях Y и Z. «Радиус» задает радиус круга и может быть любым положительным целым числом. Увеличение «Глубины» создаст цилиндрическую трубку в направлении, заданном «Направление».

Конус

Конус. Свойство «Направление» определяет, на какую ось указывает конус. «Радиус» задает радиус конуса и может быть любым положительным целым числом. «Высота» задает высоту конуса и может быть отрицательной.

Кубоид

Кубоид — это полый куб, длина каждой стороны которого задается параметрами «X», «Y» и «Z», которые все должны быть положительными целыми числами. Параметр «Стены» показывает стены, которые в данный момент активны, где, например, наличие «X» означает, что стены в отрицательном направлении X и положительном направлении X включены, и аналогично для «Y» и «Z». '-' означает, что стены не включены, а кубоид представляет собой только каркас. Вы можете выбрать, будет ли начало координат угол или центр кубоида.

Эллипс

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

Эллипсоид

Эллипсоид относится к сфере, как эллипс к кругу. Единственное отличие сферы в том, что у нее теперь вместо радиуса три полуоси. Как и сфера, он также имеет купольные режимы.

Сетка

Сетка блоков. Количество блоков и размер шага между блоками могут быть изменены для каждого направления.

Линия

Простая линия. Две точки, на которых основана линия, — это начало координат и точка относительно начала координат, описываемая параметрами «Дельта X», «Дельта Y» и «Дельта Z». Эту вторую точку также можно установить с помощью кнопки «Установить конечную точку», которая помещает это положение у ваших ног.

Парабола

Парабола. Его форма описывается параметрами «Полуширина» и «Высота», так что точка (Полуширина,Высота) является частью параболы. «Направление» и «Вращение» позволяют параболе смотреть в определенном направлении и поворачиваться на заданную величину. Параметр «Глубина» добавит слои к «Направлению» и может быть отрицательным.

Парабоид

Параболоид. Он работает аналогично параболе, но теперь имеет две полуширины в направлениях, заданных именами параметров. Вращение теперь задается только параметром «Направление».

Многоугольник

Многоугольник – это правильная фигура с заданным числом сторон. Это количество сторон задается параметром «Стороны»; 3 дает треугольник, 4 дает квадрат, 5 дает пятиугольник и т. д. Параметр «Стороны» должен быть целым числом 3 или больше. «Радиус» — это несколько расплывчатая интерпретация радиуса и представляет собой расстояние между началом координат и одной из сторон. «Радиус» должен быть положительным целым числом. «Направление» работает так же, как и с кругом, поскольку определяет, по какой оси движется многоугольник. «Поворот» кратен 90°, на который будет повернут многоугольник. Наконец, «Глубина» снова работает как с кругом.

Многоугольная пирамида Пирамида с основанием многоугольника. Он работает идентично обычному многоугольнику, но вместо «Глубины» у него есть «Высота» для высоты пирамиды.

Сфера

Сфера с радиусом, заданным параметром «Радиус», который является положительным целым числом. «Купол» устанавливает купольный режим сферы: «-» означает отключенный, а любая другая опция будет отображать только одно полушарие сферы в том направлении, которое она описывает.

Торус

Также известен как пончик. Как и круг, параметр «Направление» определяет, по какой оси он движется. Если представить тор как трубку вокруг кольца, то «Внешний радиус» — это радиус кольца, а «Внутренний радиус» — это радиус трубки. Оба они должны быть положительными целыми числами, а «Внешний радиус» всегда должен быть больше или равен «Внутреннему радиусу». Если «Внешний радиус» установлен меньше, чем «Внутренний радиус», или «Внутренний радиус» установлен больше, чем «Внешний радиус», для другого параметра будет установлено то же значение.

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

Планирование форм обычно выполняется в очень специфической среде; формы в вашем однопользовательском мире могут не восприниматься на вашем любимом сервере или в другом мире, а здание, которое вы запланировали в Верхнем мире, совершенно бесполезно в Конце, где оно парит в пустоте в 500 блоках от вас. Таким образом, последняя версия мода будет иметь разное состояние для каждой уникальной комбинации IP-адреса мира/сервера и измерения. На момент написания статьи в любом случае не было возможности перенести это состояние в другой мир/сервер/измерение, но в будущей версии мода будет реализовано переключение этого поведения и перемещение/копирование состояния. По умолчанию формы и состояния теряются между перезапусками клиента. Включение опции конфигурации persistenceEnabled позволяет моду сохранять формы и состояния в файлы и восстанавливать их при перезапуске клиента. Из-за технических ограничений восстановление состояния начнется при открытии графического интерфейса.

Минимальные требования

Версии, обозначенные, например, как 1.21/1.21.1, построены на базе 1.21, но должны работать и на 1.21.1.

Forge 1.20/1.20.1: Minecraft Forge 46.0.14.
Forge 1.20.2/1.20.3: Minecraft Forge 48.1.0.
Forge 1.20.4/1.20.5: Minecraft Forge 49.2.8.
Фордж 1.20.6: Майнкрафт Фордж 50.2.9.
Forge 1.21/1.21.1: Minecraft Forge 51.0.33.
Фордж 1.21.3: Майнкрафт Фордж 53.1.11.
Фордж 1.21.4: Майнкрафт Фордж 54.1.17.
Фордж 1.21.5: Майнкрафт Фордж 55.1.11.
Фордж 1.21.8: Майнкрафт Фордж 58.1.19.
Фордж 1.21.10: Майнкрафт Фордж 60.1.11.
Forge 1.21.11: Minecraft Forge 61.1.19.
Фордж 26.1.2: Майнкрафт Фордж 64.0.11.
Фордж 26.2: Майнкрафт Фордж 65.0.4.
Фордж 26.3: Майнкрафт Фордж 66.0.9.

Fabric 1.20/1.20.1: загрузчик Fabric 0.19.3 и API Fabric 0.83.0.
Fabric 1.20.2/1.20.3: загрузчик Fabric 0.19.3 и API Fabric 0.91.6.
Fabric 1.20.4/1.20.5: загрузчик Fabric 0.19.3 и API Fabric 0.97.3.
Fabric 1.20.6: загрузчик Fabric 0.19.3 и API Fabric 0.100.8.
Fabric 1.21/1.21.1: загрузчик Fabric 0.19.3 и API Fabric 0.102.0.
Fabric 1.21.3: загрузчик Fabric 0.19.3 и API Fabric 0.114.1.
Fabric 1.21.4: загрузчик Fabric 0.19.3 и API Fabric 0.119.4.
Fabric 1.21.5: загрузчик Fabric 0.19.3 и API Fabric 0.128.2.
Fabric 1.21.8: загрузчик Fabric 0.19.3 и API Fabric 0.136.1.
Fabric 1.21.10: загрузчик Fabric 0.19.3 и API Fabric 0.138.4.
Fabric 1.21.11: загрузчик Fabric 0.19.3 и API Fabric 0.141.4.
Fabric 26.1.2: загрузчик Fabric 0.19.3 и API Fabric 0.154.2.
Fabric 26.2: загрузчик Fabric 0.19.3 и API Fabric 0.154.2.
Fabric 26.3: загрузчик Fabric 0.19.5 и API Fabric 0.161.0.

NeoForge 1.21/1.21.1: NeoForge 21.0.167.
NeoForge 1.21.3: NeoForge 21.3.96.
NeoForge 1.21.4: NeoForge 21.4.157.
NeoForge 1.21.5: NeoForge 21.5.97.
NeoForge 1.21.8: NeoForge 21.8.53.
NeoForge 1.21.10: NeoForge 21.10.64.
NeoForge 1.21.11: NeoForge 21.11.42.
NeoForge 26.1.2: NeoForge 26.1.2.80.
NeoForge 26.2: NeoForge 26.2.0.18-бета.
NeoForge 26.3: NeoForge 26.3.0.45-бета.

Совместимость

Совместимость с шейдерами через Optifine не гарантируется. Известно, что шейдеры в Optifine нарушают прогнозы из-за проблемы, которая, по-видимому, возникает на стороне Optifine. Функции, не связанные с шейдерами, в Optifine работают отлично.

Мод должен быть явно совместим с Iris, начиная с Minecraft 1.21.5, даже с включенными шейдерами.

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

Конфигурация

Файл конфигурации можно найти в папке config в каталоге игры и называется buildguide.cfg. Для его редактирования также можно использовать графический интерфейс конфигурации. Можно настроить следующие параметры:

debugGenerationTimingsEnabled (по умолчанию: false)
Опция отладки для печати времени, необходимого для создания формы в журналах.

asyncEnabled (по умолчанию: true)
Если этот параметр включен, фигуры будут генерироваться асинхронно, то есть фигуры будут объединяться в фоновом режиме без необходимости блокировать ваш клиент. Включение этой опции может привести к небольшому миганию проекций фигур, поэтому, если вы чувствительны к миганию изображений, особенно если вы чувствуете дискомфорт при использовании мода, рассмотрите возможность отключения этой опции. Когда-нибудь этот вопрос должен быть решен.

shapeListRandomColorsDefaultEnabled (по умолчанию: false)
Если эта опция включена, при добавлении новых фигур в графический интерфейс списка фигур их цвета будут генерироваться случайным образом вместо использования белого и красного по умолчанию.

persistenceEnabled (по умолчанию: false)
Экспериментальная опция, которая по умолчанию отключена из-за некоторых странных проблем в Forge. Когда эта опция включена, формы и состояния будут сохраняться в файл, что позволит моду восстанавливать формы при перезапуске клиента.

Модпаки

Не стесняйтесь добавлять его в модпак!