MaterialMaps

--- В Minecraft каждая грань блока — идеально плоский квадрат. Камень, кирпичи, гравий — текстура выглядит шероховатой, но сама поверхность гладкая, поэтому свет падает на неё абсолютно одинаково. Именно поэтому блоки могут выглядеть как наклейки.

MaterialMaps это исправляет.
Многие HD-ресурспаки уже включают дополнительное скрытое изображение для каждой текстуры, которое говорит «этот пиксель выступает, а тот — впадина».
Обычно их может прочитать только шейдерпак.
MaterialMaps читает их сам, так что каждый бугорок ловит свет с нужной стороны и отбрасывает собственную маленькую тень. Камень выглядит высеченным. Кирпичи — сложенными в кладку. Гравий — как настоящий гравий.

• Шейдерпак не нужен, никакого Iris, никакого OptiFine, никакого огромного падения FPS
• Всё ещё выглядит как ванилла, без bloom, без изменения цветов, без навороченного неба. Только глубина
• Работает с вашими текущими паками, если ваш пак это поддерживает, включите мод — и готово

Нужен ли особый ресурспак?

Да, MaterialMaps добавляет детали только там, где их предоставляет пак. HD-паки вроде Prime's HD Textures это делают.
С обычным ванильным паком ничего не изменится.

Всё ещё в активной разработке !

MaterialMaps работает, но он молод. Совместимость с крупными модами на рендеринг пока не гарантируется.
Сообщения об ошибках очень приветствуются.

Сравнение

Скриншоты сделаны с Prime's HD Textures

Возможности

• Нормал-мапы блоков: применяются напрямую к местности через отдельный путь рендеринга, так что ванильная геометрия чанков остаётся нетронутой.
• Нормал-мапы предметов: предметы в руках, выброшенные и в инвентаре получают ту же обработку.
• Карты высот: когда у текстуры есть _h.png, но нет _n.png, MaterialMaps выводит нормал-мапу в тангенциальном пространстве в памяти во время перезагрузки ресурсов.
• Поддержка LabPBR 1.3: распознаются парные карты _n.png и _s.png; нормали X/Y и ambient occlusion читаются из нормал-мапы LabPBR, а её альфа-канал сохраняется как встроенные данные высот.
• Освещение с учётом измерения: направление солнца и луны зависит от измерения, в котором вы находитесь.
• Экспериментальный параллакс: ограниченная выборка высот на ближайших сплошных и cutout-гранях, с опциональным затенением краёв углублений и воксельным рельефом текселей.
• Откат к ванилле: всё, что MaterialMaps не может отрендерить безопасно, передаётся напрямую ванилле с записью причины.

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

Мод	Статус
Sodium	Обязателен
Iris	Опционален. Когда активен шейдерпак Iris, MaterialMaps отключается во избежание конфликтов.
Fabric API	Обязателен

MaterialMaps работает только на клиенте, с ним можно зайти на любой сервер.

Настройка

Откройте настройки из ModMenu или из Настройки графики -> MaterialMaps, когда установлен Sodium. Рендеринг : переключение нормал-мап блоков и предметов, вывод карт высот и откат к ванилле. Освещение : Normal Strength управляет тем, насколько сильно нормал-мапы искажают поверхность, Ambient Strength задаёт минимальное освещение деталей, а Directional Strength задаёт направленный контраст. Экспериментальное : параллакс, масштаб глубины параллакса, края углублений и воксельный рельеф текселей. Отладка : отладочные виды нормал-мап, мировых нормалей и освещения для блоков и предметов, а также статистика рендеринга.

Команды

Для диагностики пака в игре:

/materialmaps summary [blocks|items]   обзор того, что было обнаружено
/materialmaps inspect <material>       показать найденные карты для одной текстуры, блока или предмета
/materialmaps validate                 вывести предупреждения и ошибки ресурспака
/materialmaps renderstats              диагностика рендеринга
/materialmaps dump                     записать полный индекс материалов в файл
/materialmaps reload                   перестроить индекс и нормал-атласы

Для создателей паков

Соглашение об именовании

Размещайте свои карты рядом с базовой текстурой, используя суффиксы _n и _h:

assets/minecraft/textures/block/stone.png
assets/minecraft/textures/block/stone_n.png
assets/minecraft/textures/block/stone_h.png

assets/minecraft/textures/item/iron_pickaxe.png assets/minecraft/textures/item/iron_pickaxe_n.png

Правила, которые стоит знать:
- Явные нормал-мапы всегда имеют приоритет над картами высот.
- Карты высот используются для вывода нормалей только когда включены `Height Maps` и нет `_n.png`.
- Карта должна совпадать по размерам с базовой текстурой, иначе она пропускается.
- Паки LabPBR могут предоставлять пары `_n.png` + `_s.png`.
- Сканируются только `textures/block` и `textures/item`.
Запустите `/materialmaps validate`, чтобы отлавливать осиротевшие карты и несовпадения размеров во время работы, и включите **Strict Validation** в настройках, чтобы считать больше проблем серьёзными ошибками.
### Заметки о параллаксе
Экспериментальная опция параллакса применяет ограниченную выборку высот к ближайшим сплошным и cutout-граням блоков. Она затухает между 24 и 32 блоками и остаётся отключённой для полупрозрачных слоёв. Cutout-блоки сохраняют свой исходный силуэт с альфа-тестом. Это лёгкий прототип — настоящего смещения геометрии или силуэта здесь нет.
### Тестовый пак
Небольшой ресурспак для разработки включён в репозиторий как `materialmaps-test-pack`. Запустите клиент, включите его на экране ресурспаков, затем осмотрите алмаз, железный слиток или палку, чтобы увидеть путь предметов в действии.
## Требования

- Minecraft **26.2**
- Fabric Loader **0.19.3+**
- Fabric API
## Использование ИИ
Не каждая строка кода в этом проекте написана на 100% человеком <br>
ИИ использовался как инструмент для исследований и в помощь при программировании