Model Viewer

Discord для связи и сообщений об ошибках: @swakoza

ModelViewer — клиентский мод для Fabric для Minecraft Java Edition, который помогает понять, какая модель предмета на самом деле используется в игре.

Мод показывает путь к модели, активный ресурспак, итоговый model JSON, цепочку родителей, привязанные текстуры, отсутствующие ресурсы и полный путь, который прошёл Minecraft, чтобы добраться до выбранной модели.

Особенно полезен тем, кто работает с ресурспаками, кастомными предметами, custom_model_data и моделями из Blockbench.

Для чего этот мод?

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

ModelViewer делает это прямо в игре.

Вы выбираете предмет, и мод показывает, откуда взялась его модель, какой ресурспак победил, какие файлы найдены, какие отсутствуют и что именно Minecraft пытается отрендерить.

Что умеет ModelViewer?

• Осматривать предмет в основной руке.
• Осматривать предмет во второй руке.
• Осматривать предмет под курсором в инвентаре.
• Осматривать предметы рядом: сущности-предметы, рамки и витрины.
• Показывать активный minecraft:item_model.
• Находить определение предмета из активных ресурспаков.
• Показывать ресурспак, который фактически победил.
• Показывать переопределённые варианты из других ресурспаков.
• Рекурсивно анализировать дерево моделей предмета.
• Показывать итоговый model JSON, если он существует.
• Показывать цепочку родителей модели.
• Показывать привязки текстур.
• Находить отсутствующие определения предметов, модели и текстуры.
• Обновляться после перезагрузки ресурсов, например после нажатия F3 + T.

Поддержка современных моделей предметов

ModelViewer умеет анализировать современные структуры моделей предметов, включая:

• model
• condition
• select
• range_dispatch
• composite
• empty
• bundle_selected_item
• special

Также поддерживает современный формат minecraft:custom_model_data:

• floats
• flags
• strings
• colors

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

Открытие моделей в Blockbench

ModelViewer может открыть найденную модель прямо в Blockbench.

Если модель лежит в обычной папке ресурспака, мод открывает оригинальный JSON-файл.

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

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

Экран инспектора

В окне подробного инспектора можно увидеть:

• превью предмета;
• активный item_model;
• путь к определению предмета;
• победивший ресурспак;
• дерево трассировки модели;
• итоговый путь модели;
• цепочку родителей;
• привязанные текстуры;
• предупреждения и отсутствующие ресурсы.

Доступные действия:

• переключить цель осмотра;
• скопировать ID предмета;
• скопировать путь к предмету;
• скопировать путь к модели;
• скопировать метаданные;
• обновить данные;
• найти модели;
• открыть модель в Blockbench;
• открыть папку с файлом;
• распаковать ресурспак;
• осмотреть сущности поблизости;
• скопировать PNG-скин видимого игрока.

Осмотр сущностей поблизости

Мод может показывать сущности и предметы поблизости, которые можно осмотреть.

В меню есть поиск и сортировка:

• по алфавиту;
• по расстоянию;
• по категории.

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

Горячие клавиши

Для кого этот мод?

ModelViewer пригодится:

• создателям ресурспаков;
• авторам моделей;
• пользователям Blockbench;
• разработчикам модпаков;
• администраторам серверов, использующим кастомные предметы;
• всем, кто чинит сломанные модели;
• всем, кто работает с custom_model_data.

Если вам нужно понять, почему предмет отображается с неправильной моделью, какой ресурспак его переопределяет или где находится нужный JSON-файл, этот мод может сильно ускорить вашу работу.