Vulkan PostFX

Vulkan PostFX (VPFX) представляет собой экспериментальный загрузчик и среду для обработки пост-эффектов, работающую через современный путь рендеринга Vulkan в Minecraft.

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

Проект ориентирован на создание нового рабочего процесса VPFX для Vulkan-рендеринга, начиная с надежной загрузки внешних паков и постепенно переходя к более мощной среде выполнения шейдеров.

Vulkan PostFX реализует полноценный конвейер выполнения внешних VPFX-паков, а не просто парсит ZIP-файлы. Ключевые функции включают:

• Загрузку внешних ZIP-паков VPFX
• Конфигурацию пост-обработки на основе графов
• Материализацию ресурсов во время работы
• Инъекцию ресурсов в систему Minecraft
• Внешнее выполнение пост-цепочек
• Сэмплирование цвета сцены
• Захват глубины сцены
• Экспериментальные входные данные глубины теней
• Диагностику ошибок для сломанных паков
• Эксперименты с нативным рантаймом

external ZIP shader pack
  -> VPFX manifest / graph validation
  -> runtime resource pack materialization
  -> Minecraft resource system injection
  -> external post-chain execution

Мод поддерживает ZIP-паки, содержащие файлы pack.json, post_effect/main.json, а также шейдеры .vsh и .fsh. Ссылки на шейдеры используют формат <pack_id>:<path>, например vpfx_minimal_showcase:composite/final.

Внешние паки переписываются в изолированные пространства имен во время работы, что предотвращает конфликты с встроенными ресурсами и другими сборками. Содержимое ZIP-файлов материализуется и внедряется в клиентскую систему ресурсов во время запуска или перезагрузки.

Текущие входные данные для VPFX-рантайма включают:

minecraft:scene_color
vulkanpostfx:scene_depth
vulkanpostfx:shadow_depth
minecraft:main

При сбое загрузки или выполнения пака система генерирует диагностическую информацию по таким проблемам, как отсутствующие файлы, неверные цели графа, несоответствие сэмплеров, ошибки путей шейдеров или сбои создания конвейеров.

Проект постепенно переходит от стандартного бэкенда minecraft_postchain к собственному нативному выполнению. На данный момент это экспериментальный путь, который включает проверку поддержки нативного рантайма, обнаружение опасностей на одних и тех же целях и планирование переходных цветовых целей.

minecraft:main
  -> transientColor
  -> builtin native fullscreen passthrough
  -> minecraft:main

Пользовательские VPFX-шейдеры пока не выполняются полностью нативно. Этот путь является опциональным и предназначен для тестирования.

1. Поместите ZIP-пак с VPFX-шейдерами в папку shaderpacks вашего экземпляра Minecraft.
2. Выберите активный пак, отредактировав файл конфигурации config/vulkanpostfx.json. Пример: {"active_pack_id": "vpfx_minimal_showcase"}.
3. Запустите игру. Мод просканирует паки, валидирует граф и внедрит ресурсы.
4. Переключайте эффекты клавишами F8 (основной эффект) и F9 (отладка глубины теней).

Vulkan PostFX находится в стадии альфа-тестирования и не является полноценной заменой Iris или OptiFine. Большинство традиционных шейдерпаков не будут работать напрямую без портирования.

На текущий момент не поддерживаются:

• gbuffers_*
• полная совместимость shadow.* и composite.*
• отражения в пространстве экрана
• объемный туман
• естественное рендеринг облаков
• освещение с учетом материалов
• маршрутизация шейдеров по измерениям (world1/ и т.д.)

• отсутствие нативного выполнения пользовательских шейдеров
• отсутствие многопроходного нативного выполнения
• отсутствие кастомных нативных целей рендеринга
• отсутствие нативных входных данных глубины сцены и теней
• отсутствие вычислительных шейдеров (compute shaders)
• отсутствие трассировки пути (RT / path tracing)

Требования проверенного файла

• По манифесту для файла vulkanpostfx-1.15.11+mc26.2-2026-07-10.jar (Minecraft 26.2; Fabric) требуется fabric-api. Встроенных JAR-библиотек в проверенном файле нет.