- Загрузчики
- Fabric
- Скачиваний на Modrinth
- 509
- Подписчиков на Modrinth
- 3
- версий
- 8
- Обновлён
- 3 октября 20263 окт.
- Опубликован
- в 2026
Коротко о моде
Работает на Fabric
Для Minecraft 26.1, 26.2–26.3
Ставится только в игру; на сервер ставить не нужно
Последняя версия — v2.1.4+26.3 от 3 октября 2026
Нужен Iris Shaders и Fabric API
Лицензия MIT — бесплатно
Где нуженВерсии игры26.1, 26.2–26.3
В игреобязателенНа серверене нужен
Ставится только в игру; на сервер ставить не нужно
Описание переведено автоматическиПоказать оригинал (EN)
Viewfinder
Мод для отладки шейдеров для Iris на Fabric, который предоставляет MCP-сервер и внутриигровые команды, позволяющие ИИ-агентам исследовать, тестировать и автоматизировать рабочие процессы разработки шейдеров.
Возможности
- Перезагрузка шейдеров и список ошибок — запуск перезагрузки шейдеров и захват ошибок компиляции
- Профилирование GPU по запросу — сбор иерархических таймингов по проходам за фиксированное окно кадров без постоянных накладных расходов на запросы
- Инспекция пайплайнов и программ — наблюдение за вложенными проходами Iris и отражение униформ, UBO и SSBO связанных программ
- Дамп текстур — инспекция или экспорт основных/альтернативных colortex, depth, shadow, noise и кастомных текстур
- Дамп SSBO-буферов — выгрузка shader storage buffer objects на диск для анализа
- Планирование скриншотов — планирование скриншотов с настраиваемой задержкой в кадрах (для PT)
- Список пропатченных шейдеров — программный поиск пропатченного шейдера с ошибкой путём перечисления всех и поиска "errored"
- Интерактивный вывод в чат — копирование путей, открытие дампов и вставка последующих команд из чата
- Снимок диагностики для агента — один JSON-набор с шейдерпаком, рендером, ошибками, метриками, текстурами, SSBO и предлагаемыми следующими действиями
- Ограниченные инспекционные пробы — инспекция статистики/пикселей текстур и превью байтов SSBO перед выгрузкой больших GPU-ресурсов
- Захват вывода прохода — экспорт вложений фреймбуфера в конце выбранного прохода Iris
- Мутация шейдеров — редактирование исходников или опций директорийного пака и перезагрузка со структурированной диагностикой
- Детерминированные сцены — позиционирование авторитетного игрока в одиночной игре, установка времени/погоды и заморозка или пошаговое продвижение тиков
Установка
- Установите Fabric Loader для Minecraft 26.1 или 26.2
- Установите Fabric API и Iris (который требует Sodium)
- Поместите
.jarфайл Viewfinder, соответствующий вашей версии Minecraft, в папкуmods/ - Для установки MCP проверьте репозиторий.
Использование
Внутриигровые команды
Все команды зарегистрированы под /viewfinder:
| Команда | Описание |
|---|---|
/viewfinder status | Показать текущее имя шейдерпака, количество ошибок и адрес MCP |
/viewfinder snapshot | Суммировать снимок диагностики для агента |
/viewfinder reload | Перезагрузить шейдеры и сообщить об ошибках компиляции |
/viewfinder errors | Перечислить все захваченные ошибки шейдеров |
/viewfinder errors all | Перечислить весь захваченный буфер ошибок |
/viewfinder errors clear | Очистить захваченные ошибки шейдеров |
/viewfinder screenshot [frames] | Сделать скриншот (опционально с задержкой в N кадров) |
/viewfinder screenshot result | Показать путь последнего скриншота |
/viewfinder metrics | Отобразить последние захваченные тайминги GPU |
/viewfinder metrics capture [frames] | Профилировать следующее фиксированное число кадров |
/viewfinder metrics reset | Очистить собранные образцы таймингов GPU |
/viewfinder ssbo list | Перечислить активные SSBO-буферы |
| `/viewfinder ssbo inspect [bytes]` | Показать превью байтов SSBO в виде hex, int, uint и float значений |
| `/viewfinder ssbo dump ` | Выгрузить SSBO-буфер в ssbo_dumps/ |
/viewfinder texture list | Перечислить доступные colortex и кастомные текстуры |
| `/viewfinder texture inspect name [samples]` | Исследовать метаданные, образцы и статистику каналов текстуры по имени |
| `/viewfinder texture inspect id [samples]` | Исследовать метаданные, образцы и статистику каналов текстуры по GL id |
| `/viewfinder texture sample name [z]` | Прочитать конкретный пиксель текстуры по имени |
| `/viewfinder texture sample id [z]` | Прочитать конкретный пиксель текстуры по GL id |
| `/viewfinder texture dump name [raw]` | Выгрузить текстуру по имени (PNG или raw) |
| `/viewfinder texture dump id [raw]` | Выгрузить текстуру по GL id (PNG или raw) |
/viewfinder patched_shaders | Перечислить пропатченные файлы шейдеров Iris |
Вывод в чате использует кликабельные элементы управления там, где Minecraft это поддерживает: пути к сохранённым файлам можно открыть или скопировать, вывод списка включает подсказки команд dump, а перехваченные ошибки содержат кнопки копирования полных сообщений и стек-трейсов.
MCP-сервер
При запуске клиента Minecraft Viewfinder автоматически запускает stateless Streamable HTTP MCP-сервер по адресу:
http://127.0.0.1:7150/mcpЧастые вопросы
Как установить Viewfinder?
Установите Fabric под свою версию Minecraft, скачайте Viewfinder под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.
Для каких версий Minecraft есть Viewfinder?
У Viewfinder есть сборки для Minecraft 26.1, 26.2–26.3.
Нужен ли Viewfinder на сервере?
Ставится только в игру; на сервер ставить не нужно
Лицензия и источник
MIT Licenseможно свободно использовать и распространять с указанием автора
Похожие моды
Все моды на утилиты →
Другие моды автора
GFX-Debuggers (NSight and Renderdoc Injector)↓ 3,1 тыс.Часто нужны вместе
Fabric API↓ 281 млн
Iris Shaders↓ 192 млн