Клиентский мод, который проецирует в мир фигуры, например окружности и сферы. Работает в одиночной и многопользовательской игре, даже если на сервере мод не установлен.
0 скачиваний0 просмотров
Клиентский мод, который проецирует в мир фигуры, например окружности и сферы. Работает в одиночной и многопользовательской игре, даже если на сервере мод не установлен.
Краткое руководство по использованию
Нажатие клавиши «Open Build Guide» (по умолчанию: «B») открывает интерфейс Build Guide, изначально находящийся в подменю Shape. Переключатель «Enable» в левом верхнем углу определяет, будет ли отображаться фигура. Чуть ниже этого переключателя находятся две кнопки для перебора доступных фигур, которые перечислены в разделе «Фигуры» внизу этого руководства. Кнопка «Set origin» устанавливает местоположение маленького куба (по умолчанию красного) у ног игрока. Этот куб служит основой для фигуры (например, началом линии или центром окружности). Начало также можно изменить с помощью текстовых полей и кнопки под кнопкой «Set origin». В середине или справа интерфейса находится список свойств выбранной фигуры, например радиус или ориентация. Некоторые свойства также допускают отрицательные значения, что позволяет, например, развернуть фигуру в сторону отрицательной оси.
Кнопка «Visualization» открывает подменю с ползунками для изменения цветов большого куба фигуры (по умолчанию белого) и меньшего куба начала (по умолчанию красного). В этом подменю также есть опция переключения «Depth test»; при отключённой проверке глубины фигуру видно сквозь блоки.
Нажатие «Shape list» позволяет использовать несколько фигур одновременно. В этом подменю кнопка «Add» добавляет экземпляр фигуры, показанной выше. Добавляемую фигуру можно переключать, чтобы изменить, какая фигура будет добавлена. У каждой фигуры в списке есть собственное начало координат, которое при первом добавлении по умолчанию находится у ног игрока. Щелчок по фигуре в списке в центре экрана выбирает её, что обозначается чёрной полосой. Выбранную фигуру можно изменять в окне Shape. Флажок «Visible» позволяет временно скрыть выбранную фигуру, и она не учитывается в общем количестве блоков. Кнопка «Delete» удаляет выбранную фигуру. Кнопки и текстовые поля «Global origin» смещают начало координат выбранной фигуры так же, как обычные кнопки начала координат в главном окне, но начала координат невыбранных фигур также смещаются относительно, сохраняя взаимное расположение.
Все фигуры и их настройки привязаны к названию мира (одиночная игра) или IP-адресу сервера (многопользовательская игра) и измерению. Фигуры можно сохранять между перезапусками клиента, включив параметр конфигурации persistenceEnabled
. В противном случае фигуры будут потеряны при закрытии клиента.
Цепная линия: цепная линия (также называемая линией цепи или верёвки) между двумя точками с длиной дуги (длиной верёвки), равной расстоянию между этими точками плюс заданное дополнительное расстояние.
Окружность: окружность, которая может быть ориентирована вокруг любой из трёх осей и может складываться в стены или трубы.
Конус: конус, который может быть направлен вдоль любой из трёх осей с заданными радиусом и высотой.
Прямоугольный параллелепипед: полый прямоугольный параллелепипед с отключаемыми стенками.
Эллипс: эллипс, который может быть ориентирован вокруг любой из трёх осей и может складываться в стены или трубы.
Эллипсоид: эллипсоид, который также можно превратить в один из шести возможных куполов, направленных вдоль оси.
Сетка: сетка блоков с заданным шагом и числом шагов по каждой из трёх осей.
Линия: линия в одном из шести направлений вдоль оси.
Парабола: парабола с заданной полушириной и высотой, обращённая в заданном направлении и повёрнутая на заданный угол.
Параболоид: параболоид, направленный вдоль любой из трёх осей, с двумя заданными полуширинами и заданной высотой.
Многоугольник: треугольник, квадрат, пятиугольник, шестиугольник и т. д. Его можно поворачивать вокруг любой из трёх осей и складывать в стены или трубы.
Многоугольная пирамида: пирамида с многоугольником в основании. Её можно поворачивать вокруг любой из трёх осей. Учтите, что заданная высота может не быть итоговой высотой.
Сфера: сфера, которую также можно превратить в один из шести возможных куполов, направленных вдоль оси.
Тор: форма в виде пончика с настраиваемыми радиусом и толщиной, которую можно расположить вокруг любой из трёх осей.
Полное руководство по использованию
Интерфейс 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', 'Origin' и 'Shape properties'.
Shape
Раздел 'Shape' определяет, какая фигура отображается. Изначально это первая фигура, известная моду, — предположительно круг. Кнопки со стрелками слева и справа от названия текущей фигуры переключают доступные фигуры.
Origin
К этому моменту у вас должна отображаться случайная фигура (если вы установили флажок «Enable»). Скорее всего, вы захотите перемещать эту фигуру — именно этому посвящён данный раздел вспомогательного интерфейса. Если вы ещё не трогали интерфейс визуализации, вы увидите два вида отрисованных блоков: множество белых блоков, обрисовывающих фигуру, и один небольшой красный блок — так называемый «origin» (начало) фигуры. От этого начала фигура отсчитывается; обычно это что-то вроде центра окружности или начала линии. Изначально началом служит место, где вы находились при первом открытии интерфейса. Кнопки в разделе «Origin» меняют положение начала, и обрисовывающие фигуру блоки перемещаются вместе с ним. Первая кнопка, «Set origin», просто переносит начало вам под ноги. Остальные три строки позволяют точнее управлять каждой из трёх составляющих позиции (X, Y и Z). Кнопки «-» и «+» соответственно уменьшают и увеличивают нужную составляющую. Точное значение можно ввести в чёрное текстовое поле. Нажатие кнопки «Set» попытается установить составляющую в значение из текстового поля. Если это значение не является допустимым целым числом, составляющая не обновится, а текст станет красным. При вводе допустимого числа текст снова станет белым. Кроме того, существует привязка клавиши, по умолчанию не назначенная, которая действует как кнопка «Set origin» и носит то же название.
Свойства фигуры
Наконец, раздел «Shape properties» содержит параметры фигуры: длину, радиус, ориентацию и т. д. Параметры каждой фигуры и их описания приведены в разделе «Shapes» далее в этом руководстве. При переключении между фигурами их параметры сохраняются.
Подменю «Visualization» открывается нажатием кнопки «Visualization». В нём в основном два набора по четыре ползунка и две кнопки. Левый набор управляет цветом блоков, обрисовывающих фигуру, а правый — цветом небольшого блока начала координат. Каждый из четырёх ползунков отвечает за одну цветовую составляющую соответствующего типа блоков: красную, зелёную, синюю и альфа. Последняя, альфа, задаёт прозрачность блоков. Когда ползунки установлены в нужное положение, цвет применяется нажатием «Set». Кнопка «Default» возвращает цвета по умолчанию: белый для блоков, обрисовывающих фигуру, и красный для блока начала координат. Флажок «Depth test» внизу определяет, будет ли при рендеринге использоваться проверка глубины — технический термин, означающий «рисовать это, только если между ним и камерой ничего нет». Иными словами, если снять флажок «Depth test», блоки, обрисовывающие фигуру, и блок начала координат будут видны сквозь мир. Это нельзя использовать как разновидность x-ray или иного читерства, поскольку мод никак не взаимодействует с миром.
Нажатие кнопки «Shape list» переводит в подменю «Shape List». Как и подменю «Shape», подменю «Shape List» разделено на четыре раздела: «Add new shape», «Selected shape», «Global origin» и «Shapes».
Add new shape
В этом разделе снова можно переключаться между фигурами. Переключение на нужную фигуру и нажатие кнопки «Add» под ней добавляет фигуру в список в разделе «Shapes». Начало координат для только что добавленной фигуры будет у ваших ног. Можно свободно переключаться и добавлять другие фигуры, не затрагивая добавленные ранее.
Selected shape
Если снять флажок «Visible», выбранная фигура скрывается, о чём свидетельствует её зачёркивание в списке фигур. Нажатие кнопки «Delete» удаляет фигуру из списка фигур.
Глобальное начало координат
Этот раздел работает аналогично обычному разделу «Origin» в подменю Shape. Кнопки и текстовые поля задают начало координат выбранной фигуры. При этом начала координат всех остальных фигур тоже изменяются так, чтобы фигуры сохраняли взаимное расположение. Как и при обычной работе с началом координат, у кнопки «Set global origin» есть альтернатива в виде привязки клавиш с тем же названием, по умолчанию не назначенной.
Фигуры
Список в разделе «Shapes» содержит активные фигуры. Щелчок по фигуре в списке выбирает её, что обозначается чёрной рамкой вокруг неё. Если фигур слишком много и они не помещаются на экране, справа в списке появляется полоса прокрутки. Прокручивать список можно перетаскиванием полосы прокрутки или колесом мыши. Задание цвета в меню Visualization также влияет только на выбранную фигуру. Однако сейчас флажок проверки глубины по-прежнему является глобальной настройкой, то есть действует на все фигуры, а не только на выбранную. Вероятно, в будущем это поведение изменится, чтобы больше соответствовать остальным настройкам визуализации. Если удалить из списка все фигуры, многие кнопки в большинстве подменю станут недоступны, так как не будет фигуры, к которой можно применить действие. Добавление фигуры снова включает их.
Нажатие кнопки «Configuration» открывает подменю Configuration. Это подменю предоставляет прямой и мгновенный доступ к файлу конфигурации (см. раздел Configuration в конце описания мода). Изменения значений не требуют перезапуска для вступления в силу.
Большинство фигур по умолчанию могут быть только нечётного размера, потому что начало координат центрировано на одном блоке (например, так круги могут быть только 3x3, 5x5, 7x7 и т. д.). У таких фигур есть флажок «Even mode», который сдвигает начало координат на полблока в соответствующих направлениях (из предыдущего примера круги теперь могут быть только 4x4, 6x6, 8x8 и т. д.). Некоторые параметры также допускают отрицательные значения, что может, например, перевернуть фигуру в сторону отрицательной оси.
Цепная линия
Цепная линия, также известная как линия цепи или линия верёвки, — это форма верёвки, провисающей между двумя точками. Две точки, на которых основана цепная линия, — это начало координат и точка относительно начала координат, задаваемая параметрами «Delta X», «Delta Y» и «Delta Z». Эту вторую точку также можно задать кнопкой «Set endpoint», которая помещает эту позицию у ваших ног. Длина дуги цепной линии (длина верёвки) определяется расстоянием между двумя точками плюс значение, указанное в «Additional distance», которое должно быть 1 или больше.
Круг
Простой круг. Свойство «Direction» определяет, вокруг какой оси идёт круг. Например, при значении «X» круг будет простираться в направлениях Y и Z. «Radius» задаёт радиус круга и может быть любым положительным целым числом. Увеличение «Depth» создаёт цилиндрическую трубу в направлении, заданном «Direction».
Конус
Конус. Свойство «Direction» определяет, в какую ось направлен конус. «Radius» задаёт радиус конуса и может быть любым положительным целым числом. «Height» задаёт высоту конуса и может быть отрицательной.
Прямоугольный параллелепипед
Прямоугольный параллелепипед — это полая фигура в форме куба, где длина каждой стороны задаётся параметрами 'X', 'Y' и 'Z', которые должны быть положительными целыми числами. Параметр 'Walls' показывает, какие стены сейчас активны: например, наличие 'X' означает, что включены стены в направлении отрицательной X и положительной X, аналогично для 'Y' и 'Z'. '-' означает, что ни одна стена не включена и параллелепипед представляет собой только каркас. Можно выбрать, будет ли началом координат угол или центр параллелепипеда.
Эллипс
Эллипс очень похож на окружность. Единственное отличие в том, что вместо радиуса он использует две полуоси. Эти полуоси работают похоже на радиус, но если радиус действует в двух направлениях, то полуоси действуют только в одном направлении — том, которое указано в названии параметра.
Эллипсоид
Эллипсоид относится к сфере так же, как эллипс к окружности. Его единственное отличие от сферы в том, что теперь у него три полуоси вместо радиуса. Как и сфера, он также имеет режимы купола.
Сетка
Сетка из блоков. Количество блоков и шаг между блоками можно изменять для каждого направления.
Линия
Простая линия. Две точки, на которых основана линия, — это начало координат и точка относительно начала координат, задаваемая параметрами 'Delta X', 'Delta Y' и 'Delta Z'. Эту вторую точку также можно задать кнопкой 'Set endpoint', которая помещает эту позицию вам под ноги.
Парабола
Парабола. Её форма задаётся параметрами 'Half-width' и 'Height' так, что точка (Half-width,Height) принадлежит параболе. 'Direction' и 'Rotation' позволяют параболе быть обращённой в определённом направлении и быть повёрнутой на заданную величину. 'Depth' добавляет слои в направлении 'Direction' и может быть отрицательным.
Параболоид
Параболоид. Работает аналогично параболе, но теперь имеет две полуширины в направлениях, задаваемых именами параметров. Поворот теперь задаётся только параметром «Direction».
Многоугольник
Многоугольник — правильная фигура с заданным числом сторон. Это число сторон задаётся параметром «Sides»; 3 даёт треугольник, 4 — квадрат, 5 — пятиугольник и т. д. Параметр «Sides» должен быть целым числом от 3 и выше. «Radius» — довольно вольная трактовка радиуса: это расстояние между началом координат и одной из сторон. «Radius» должен быть положительным целым числом. «Direction» работает так же, как у окружности: определяет ось, вокруг которой располагается многоугольник. «Rotation» — это кратное 90° значение, на которое многоугольник будет повёрнут. Наконец, «Depth» снова работает как у окружности.
Многоугольная пирамидаПирамида с основанием в виде многоугольника. Работает так же, как обычный многоугольник, но вместо «Depth» у неё есть «Height» — высота пирамиды.
Сфера
Сфера с радиусом, задаваемым параметром «Radius», который является положительным целым числом. «Dome» задаёт режим купола сферы: «-» означает отключено, а любой другой вариант покажет только одно полушарие сферы в направлении, которое он описывает.
Тор
Также известен как пончик. Как и у окружности, параметр «Direction» определяет ось, вокруг которой он располагается. Если представить тор как трубку вокруг кольца, то «Outer radius» — это радиус кольца, а «Inner radius» — радиус трубки. Оба должны быть положительными целыми числами, и «Outer radius» всегда должен быть больше или равен «Inner radius». Если «Outer radius» задать меньше «Inner radius» или «Inner radius» задать больше «Outer radius», другой параметр будет установлен в то же значение.
Планирование фигур обычно выполняется в очень специфической среде; фигуры в вашем одиночном мире могут не иметь смысла на вашем любимом сервере или в другом мире, а постройка, запланированная в Верхнем мире, совершенно бесполезна в Крае, где она висит в пустоте в 500 блоках от вас. Поэтому последняя версия мода будет иметь отдельное состояние для каждой уникальной комбинации мира/IP сервера и измерения. На момент написания нет способа перенести это состояние в другой мир/сервер/измерение, но будущая версия мода реализует переключение этого поведения и перемещение/копирование состояния. По умолчанию фигуры и состояния теряются между перезапусками клиента. Включение параметра конфигурации persistenceEnabled позволяет моду сохранять фигуры и состояния в файлы и восстанавливать их при перезапуске клиента. Из-за технических ограничений восстановление состояния начинается при открытии GUI.
Минимальные требования
Версии, обозначенные, например, как 1.21/1.21.1, собраны на 1.21, но должны работать на 1.21.1.
Fabric 1.20/1.20.1: Fabric Loader 0.19.3 и Fabric API 0.83.0. Fabric 1.20.2/1.20.3: Fabric Loader 0.19.3 и Fabric API 0.91.6. Fabric 1.20.4/1.20.5: Fabric Loader 0.19.3 и Fabric API 0.97.3. Fabric 1.20.6: Fabric Loader 0.19.3 и Fabric API 0.100.8. Fabric 1.21/1.21.1: Fabric Loader 0.19.3 и Fabric API 0.102.0. Fabric 1.21.3: Fabric Loader 0.19.3 и Fabric API 0.114.1. Fabric 1.21.4: Fabric Loader 0.19.3 и Fabric API 0.119.4. Fabric 1.21.5: Fabric Loader 0.19.3 и Fabric API 0.128.2. Fabric 1.21.8: Fabric Loader 0.19.3 и Fabric API 0.136.1. Fabric 1.21.10: Fabric Loader 0.19.3 и Fabric API 0.138.4. Fabric 1.21.11: Fabric Loader 0.19.3 и Fabric API 0.141.4. Fabric 26.1.2: Fabric Loader 0.19.3 и Fabric API 0.154.2. Fabric 26.2: Fabric Loader 0.19.3 и Fabric API 0.154.2. Fabric 26.3: Fabric Loader 0.19.5 и Fabric API 0.161.0.
Совместимость с шейдерами через OptiFine не гарантируется. Известно, что шейдеры в OptiFine ломают проекции из-за проблемы, которая, судя по всему, находится на стороне OptiFine. Остальные возможности OptiFine, не связанные с шейдерами, по-видимому, работают без нареканий.
Начиная с Minecraft 1.21.5 мод должен быть явно совместим с Iris, в том числе при включённых шейдерах.
Мод рассчитан на работу исключительно на клиенте. Устанавливать мод на сервер не рекомендуется, но были предприняты попытки предотвратить немедленный сбой серверов, а клиентам не должно отказываться в доступе из-за отсутствия (правильной версии) мода, хотя такое поведение на стороне сервера не поддерживается и не гарантируется.
Настройка
Файл конфигурации находится в папке config в каталоге игры и называется buildguide.cfg. Изменить настройки можно и через подменю конфигурации. Доступны следующие параметры:
debugGenerationTimingsEnabled (по умолчанию: false) Отладочный параметр, который выводит в логи время генерации фигуры.
asyncEnabled (по умолчанию: true) Если параметр включён, фигуры генерируются асинхронно: они собираются в фоне, не блокируя клиент. При включённом параметре проекции фигур могут немного мерцать, поэтому при чувствительности к мерцающим изображениям, особенно если при использовании мода возникает дискомфорт, стоит отключить этот параметр. Проблему планируется исправить в будущем.
shapeListRandomColorsDefaultEnabled (по умолчанию: false) Если параметр включён, при добавлении новых фигур в подменю списка фигур их цвета будут генерироваться случайно вместо стандартных белого и красного.
persistenceEnabled (по умолчанию: false) Экспериментальный параметр, отключённый по умолчанию из-за некоторых странных проблем на Forge. Если параметр включён, фигуры и состояния сохраняются в файл, что позволяет моду восстанавливать фигуры после перезапуска клиента.