Сначала уточните, что именно не работает
У шейдеров есть три разных этапа: загрузка мода рендера, обнаружение набора и компиляция его программ видеокартой. Отсутствующая кнопка выбора чаще указывает на профиль или мод. Пустой список — на папку и структуру архива. Чёрный экран после выбора набора — на его настройки, совместимость или драйвер. Проверяйте соответствующий этап, чтобы не переставлять всю игру без причины.
Эта инструкция относится к Java Edition с Iris. Файлы Iris нельзя установить в Bedrock; там используются собственные графические возможности и поддерживаемые наборы. Перед тестами запишите версии Minecraft, Iris, Sodium, название набора шейдеров и модель видеокарты. Особенно важно указать конкретный выпуск игры, поскольку одна общая надпись «1.21» скрывает разные сочетания файлов.
Кнопка шейдеров отсутствует
В лаунчере откройте Java Edition → Установки и выберите действительно установленный Iris/Fabric-профиль. В игре зайдите Esc → Настройки → Настройки графики → Shader Packs. Если экрана нет, скачайте совместимый Iris и указанный в его выпуске Sodium, положите JAR в mods выбранной установки и перезапустите клиент. ZIP в shaderpacks не добавляет отсутствующий графический загрузчик.
Сравните Iris и Sodium с требованиями выбранных выпусков. Iris устанавливается вместе с совместимым Sodium либо требует подобрать его отдельно по инструкции проекта. Не добавляйте OptiFine или OptiFabric как «ещё один способ включить шейдеры»: несколько рендеров в одном профиле способны конфликтовать. Официальный Iris также отмечает несовместимость с Canvas и модами, переводящими рендер на Vulkan.
Сначала добейтесь рабочей кнопки выбора в чистом профиле, затем возвращайте остальные моды. Установка Iris с нуля.
Набор не появился в списке
В Shader Packs нажмите Open Shader Pack Folder. В открытом каталоге должен лежать готовый ZIP релиза, например из официального списка MakeUp. Откройте ZIP архиватором: внутри должен быть каталог shaders самого пакета. Если видите только ещё один ZIP или репозиторий с обёрткой, скачайте релиз заново; переименование файла не исправляет внутреннюю структуру. Вернитесь в игру и обновите список через повторное открытие Shader Packs.
Файл ресурспака, сборка картинок и файл страницы загрузки не являются набором шейдеров. Проверьте назначение файла на странице автора и расширение. Если автор распространяет набор папкой, внутри неё должна сохраняться нужная структура. Не объединяйте несколько наборов в один архив: меню выбирает отдельный пакет со своими программами и настройками.
Перезапустите меню выбора после копирования. Если набор виден, но отключён, включите использование шейдеров и подтвердите выбор. Дождитесь компиляции: краткая задержка после переключения не обязательно означает зависание. При настоящем сбое сохраните logs/latest.log до следующего запуска.
Чёрный экран после включения
Если меню читается, в Shader Packs отключите шейдеры, нажмите Apply и проверьте возвращение обычной картинки. Выберите проблемный пакет, откройте Shader Pack Settings и сбросьте его пользовательские опции предусмотренной кнопкой Reset. Если интерфейс полностью не читается, закройте игру и в этой тестовой игровой папке сохраните копию config/iris.properties, затем поменяйте строку enableShaders=true на enableShaders=false. При следующем запуске Iris должен стартовать без shader pack; остальные файлы не удаляются.
Создайте чистый профиль с совместимыми Iris и Sodium, без остальных графических дополнений. В новом обычном мире включите проблемный набор. Если ошибка исчезла, возвращайте ресурспаки и моды по одному. Если осталась, попробуйте другой поддерживаемый набор. Два таких сравнения отделяют конфликт сборки от ошибки одного шейдерпака.
Проверьте используемую видеокарту
На ноутбуке Minecraft может запускаться на встроенной графике, хотя дискретная карта установлена. Посмотрите информацию рендера в F3 и сопоставьте её с системными настройками графики. Назначать производительную карту нужно фактически используемому Java-процессу; разные профили лаунчера способны запускать разные runtime.
Обновление ищите на NVIDIA Drivers, AMD Support или Intel Download Center, выбрав фактическую модель. На ноутбуке сначала проверьте драйверы производителя устройства. Для macOS используйте Системные настройки → Основные → Обновление ПО, поскольку графический драйвер приходит с системой. Ограничения рендера также перечислены в документе Iris.
Если мир виден, но изображение неправильное
Фиолетовые поверхности, пропавшие блоки, неверное освещение и мерцание проверяйте отдельно от низкого FPS. Отключите активные ресурспаки и повторите сцену. Iris не поддерживает одновременное использование набора шейдеров с ресурспаками, которые заменяют внутренние core shaders. Обычные текстуры и такие программы — разные части пакета.
Для Distant Horizons или Voxy требуется явная поддержка со стороны конкретного набора. Установка обоих модов и загрузка любого шейдерпака не гарантируют корректное дальнее изображение. Начните со сцены без дополнительного дальнего рендера, затем сверяйте совместимость по страницам проектов.
Если изображение корректно, а проблема только в частоте кадров, уменьшайте нагрузку измеряемыми шагами. Настройка лёгких шейдеров.
Что искать в журнале и как закончить проверку
В игровой папке откройте logs/latest.log текстовым редактором и ищите Iris, shader, compile, ERROR, затем сохраните ближайшие строки с именем программы. На Windows можно использовать поиск Ctrl+F в Блокноте; на macOS — Cmd+F в редакторе. Диагностика Iris для авторов объясняет дополнительные отчёты: они нужны после воспроизводимого сбоя, а не как первый случайный тумблер.
После изменения одного компонента проверяйте то же место, освещение и настройки. Если рабочий результат получен, сохраните сочетание выпусков и конфигурацию. Возвращайте дополнительные моды постепенно, чтобы обнаружить момент появления дефекта. Проверка в меню недостаточна: пройдите по миру, загрузите соседние чанки и повторно откройте сохранение с включённым набором.
