NeoStructureMapper

ОТКАЗ ОТ ОТВЕТСТВЕННОСТИ: Проект ПОЛНОСТЬЮ написан мной в стиле вайб-кодинга с помощью ChatGPT. Хотя предоставляемые функции вряд ли создадут проблемы, дважды подумайте, прежде чем использовать его в большом модпаке/на сервере.

Представляем NeoStructureMapper

NeoStructureMapper — это мод, позволяющий просматривать, аннотировать и экспортировать многосоставную структуру. Вы можете создать выделение с помощью жезла выделения. После создания на него можно поместить схему структуры, и с её помощью вы сможете просматривать, аннотировать и экспортировать структуру.

Просмотр

В центре GUI находится 3D-модель выделения, которую можно вращать, масштабировать и перемещать. Кроме того, можно нажимать «-» и «=» для снятия внешнего слоя, что позволяет взаимодействовать с внутренними слоями. Прозрачность внешних слоёв настраивается. В некоторых редких случаях функция может не показать внутренние блоки так, как вы хотите (например, внутренний блок, окружённый воздухом), или вы просто хотите другой вид — не стесняйтесь переключиться в слоистый режим, нажав кнопку в левом верхнем углу. Вы можете подсвечивать разные слои с помощью «-» и «=». Расстояние между слоями настраивается. Слева в GUI находится панель инструментов. Первая кнопка позволяет создать подвыделение в 3D-модели с 16 доступными цветами (два соединённых подвыделения одного цвета объединятся в 3D-просмотре, так что, если вы не хотите их объединения, используйте разные цвета). Вторая кнопка позволяет удалять подвыделения. Третья — для экспорта, о котором расскажу позже, а последняя — для сброса 3D-модели.

Аннотирование

Правый клик по блоку откроет панель, позволяющую аннотировать. Вы можете вводить текст или рисовать в 16 цветах. Также можно просмотреть 3D-модель подвыделений, к которым принадлежит блок. Как основные выделения, так и подвыделения можно переименовать правым кликом по ним. При наведении курсора на блок отображается текст его аннотации и его инвентарь. (это главная функция с самым кратким описанием, лол)

Экспорт

Портативный формат и файл .ess

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

Файл PNG

Выделение также можно экспортировать в изображение. Эта функция очень (возможно) настраиваемая. Экспорт возможен в обоих режимах 3D-просмотра. Есть 3 режима экспорта: непрозрачный, с пометками и луковичный. Непрозрачный режим просто экспортирует сплошную 3D-модель. Режим с пометками делает все блоки прозрачными, кроме отмеченных. Луковичный режим показывает модель слой за слоем. Также можно настроить угол поворота модели: «fixed» означает изометрические виды, а «custom» использует текущий поворот при экспорте. Аннотации, рисунки и инвентари будут показаны сбоку от 3D-модели. Эту функцию можно отключить по желанию.

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

Клиентская сторона

[diagram]
    #Максимум символов заметки, отображаемых в предпросмотре при наведении.
    # Default: 25
    # Range: 1 ~ 512
    notePreviewCharacters = 25
    #Максимум типов предметов инвентаря, отображаемых в предпросмотре при наведении.
    # Default: 5
    # Range: 1 ~ 64
    contentPreviewItems = 5
    #Максимум типов предметов инвентаря, отображаемых в аннотациях PNG.
    # Default: 64
    # Range: 1 ~ 256
    pngContentItems = 64
    #Включать ли содержимое захваченного инвентаря блока в рамки аннотаций PNG.
    showPngBlockContents = true
    #Дополнительный вертикальный зазор между блоками по оси Y в слоистом режиме чертежа.
    # Default: 1.0
    # Range: 0.0 ~ 16.0
    layerModeGap = 1.0
    #Дополнительное вертикальное смещение блоков, применяемое к слоям выше и ниже выбранного слоя Y.
    # Default: 1.0
    # Range: 0.0 ~ 16.0
    layerModeFocusShift = 1.0
    #Альфа, используемая для снятых и прозрачных слоёв модели.
    # Default: 0.35
    # Range: 0.05 ~ 0.95
    peeledLayerTransparency = 0.35
    #Режим рендеринга при экспорте PNG.
    #Allowed Values: OPAQUE, NOTED, ONION
    pngMode = "ONION"
    #Режим камеры при экспорте PNG. FIXED использует изометрический вид; CUSTOM использует текущий поворот GUI.
    #Allowed Values: FIXED, CUSTOM
    pngViewMode = "FIXED"
    #Рисовать ли рамки аннотаций и выносные линии при экспорте PNG.
    showPngAnnotations = true

Серверная сторона (1.0.1+)

[server]
    #Могут ли клиенты просматривать и импортировать файлы .ess, хранящиеся в папке expstrsch на сервере.
    allowClientServerEssImport = true
    #Могут ли только операторы создавать или удалять основные выделения с помощью жезла выделения.
    requireAdminSelectionWand = true
    #Могут ли только операторы открывать аннотации размещённых схем структур.
    requireAdminStructureDiagramOpen = true
    #Включён ли импорт ESS вообще. Отключение блокирует как локальный клиентский, так и серверный импорт ESS.
    enableEssImport = false