Vulkan PostFX

# Vulkan PostFX **Vulkan PostFX**, also known as **VPFX**, is an experimental VPFX shader pack loader and post-processing framework for Minecraft’s modern Vulkan-based rendering path. It allows external **VPFX shader packs** to add screen-space visual effects such as color grading, vignette, tone mapping, highlight compression, cinematic look adjustments, depth-based effects, and early shadow-depth experiments. This project is still experimental, but it already supports ZIP-based VPFX shader packs through Minecraft’s resource pipeline. --- ## Start here For the best first experience, install both: * **Vulkan PostFX** — the loader and runtime * **VPFX Minimal Showcase** — the official minimal example pack Vulkan PostFX is **not** a full Iris / OptiFine replacement. The goal is to build a new VPFX workflow for Minecraft’s Vulkan rendering path, starting from reliable external pack loading and gradually moving toward a more capable shader runtime. --- ## What Vulkan PostFX does Vulkan PostFX currently focuses on: * external ZIP-based VPFX shader pack loading * graph-based post-processing configuration * runtime resource pack materialization * runtime resource pack injection * external post-chain execution * scene color sampling * scene depth capture * experimental shadow depth input * diagnostics for broken packs * early native runtime experiments This means Vulkan PostFX is already executing a real external VPFX pack pipeline, not just parsing ZIP files. ```text external ZIP shader pack -> VPFX manifest / graph validation -> runtime resource pack materialization -> Minecraft resource system injection -> external post-chain execution ``` --- ## Current features ### External VPFX pack loading Vulkan PostFX supports ZIP-based VPFX shader packs containing files such as: ```text pack.json post_effect/main.json shaders/<path>.vsh shaders/<path>.fsh ``` Shader references use the following format: ```text <pack_id>:<path> ``` For example: ```text vpfx_minimal_showcase:composite/final ``` which resolves to: ```text shaders/composite/final.vsh shaders/composite/final.fsh ``` Shader paths are not limited to a fixed `post/` directory layout. --- ### Runtime namespace rewriting External packs are rewritten into isolated runtime namespaces to reduce conflicts with built-in resources and other packs. This allows VPFX packs to behave more like external visual packages while still being routed through Minecraft’s resource system. --- ### Runtime resource pack injection External ZIP contents are materialized into runtime resource packs during startup / resource reload and injected into Minecraft’s client resource system. This is one of the core parts of the VPFX loading pipeline. --- ### External post-chain execution Vulkan PostFX can load external post chains through Minecraft’s `ShaderManager` and execute them through the current `minecraft_postchain` backend. The current stable execution path is still based on Minecraft’s post-chain system. --- ### Scene, depth, and shadow inputs Current VPFX runtime inputs include: ```text minecraft:scene_color vulkanpostfx:scene_depth vulkanpostfx:shadow_depth minecraft:main ``` These inputs are used for screen-space effects, depth-based experiments, and shadow-depth debugging. --- ### Failure diagnostics When a VPFX pack fails to load or execute, Vulkan PostFX can generate diagnostic information for issues such as: * missing shader files * invalid graph targets * sampler mismatches * shader path errors * external target problems * pipeline creation failures If a pack is broken, the goal is to make the failure understandable instead of silently failing. --- ## Experimental native runtime Vulkan PostFX is gradually moving beyond Minecraft’s default post-chain backend. Current experimental native runtime progress includes: * native runtime support checks * resource mapping dry-runs * same-target hazard detection * transient color target planning * `mainTarget -> transientColor` copy validation * builtin native fullscreen passthrough draw * opt-in diagnostic mode for testing the native passthrough path The current experimental native path can be summarized as: ```text minecraft:main -> transientColor -> builtin native fullscreen passthrough -> minecraft:main ``` This is still experimental and opt-in. User VPFX shaders are **not** fully executed natively yet. --- ## Current sample pack ### VPFX Minimal Showcase The official minimal example pack demonstrates: * VPFX `pack.json` * graph-based post-effect configuration * non-`post/` shader paths * `minecraft:scene_color` sampling * `minecraft:main` output * basic screen-space look adjustment It is the recommended starting point for testing Vulkan PostFX. --- ## Usage ### 1. Place a VPFX shader pack Put the VPFX shader pack ZIP into the `shaderpacks` folder of your Minecraft instance. For development runs, this is usually: ```text run/shaderpacks/ ``` --- ### 2.