# Vulkan PostFX<\/p>\n
**Vulkan PostFX is a lightweight post-processing shader pack loader for Minecraft’s Vulkan renderer.**<\/p>\n
It allows external **VPFX shader packs** to add screen-space visual effects such as color grading, vignette, tone mapping, highlight compression, and cinematic look adjustments.<\/p>\n
## Start here<\/p>\n
For the best first experience, install:<\/p>\n
– **Vulkan PostFX** \u2014 the loader
\n– **VerdantVK** \u2014 the official example shader pack<\/p>\n
Vulkan PostFX is still experimental, but it can already load external ZIP-based VPFX packs through Minecraft’s resource pipeline.<\/p>\n
The current goal is not to fully replicate Iris \/ OptiFine pipeline compatibility in one step.<\/p>\n
—<\/p>\n
## Current Progress<\/p>\n
The project already supports the following core features:<\/p>\n
– scanning external ZIP shader packs under `run\/shaderpacks\/`
\n– reading and parsing `pack.json` inside shader packs
\n– explicitly selecting the active pack via `active_pack_id`
\n– materializing external ZIP packs into runtime resource packs
\n– injecting external `post_effect\/main.json` into the game resource pipeline
\n– actually loading external post chains through `ShaderManager`
\n– an **initial translated wrapper** of **Verdant Light 1.3.0**<\/p>\n
This means the project is no longer at the stage of merely \u201creading ZIP files\u201d or \u201cpretending to load them.\u201d It already implements:<\/p>\n
**external ZIP shader pack -> runtime resource pack -> external post chain execution**<\/p>\n
—<\/p>\n
## Project Positioning<\/p>\n
### What this is
\nThis is an experimental shader pack loader for the **modern Minecraft Vulkan backend**.<\/p>\n
### What this is not
\nThis is **not** yet a mature drop-in replacement for Iris \/ OptiFine with full shader semantic compatibility.<\/p>\n
A more accurate description of the current state would be:<\/p>\n
– a **ZIP shader pack loader prototype**
\n– a **post-effect-driven shader translator**
\n– a **working proof of concept for the Vulkan path**<\/p>\n
—<\/p>\n
## Implemented Features<\/p>\n
### 1. External Pack Loading
\nSupports loading the following from ZIP shader packs:<\/p>\n
– `pack.json`
\n– `post_effect\/main.json`
\n– `shaders\/post\/*.vsh`
\n– `shaders\/post\/*.fsh`<\/p>\n
### 2. Runtime Namespace Rewriting
\nExternal packs are rewritten into isolated runtime namespaces to avoid conflicts with built-in resources.<\/p>\n
### 3. Runtime Resource Pack Injection
\nExternal ZIP contents are materialized into runtime resource packs during startup \/ resource reload and injected into the client resource system.<\/p>\n
### 4. External Post Chain Execution
\nThe project can now confirm that external post chains are actually found and executed, rather than simply falling back to built-in debug effects.<\/p>\n
### 5. Initial Shader Porting
\nIt is already possible to extract and translate the **final look layer** from traditional shader packs into a runnable Vulkan post-effect version.<\/p>\n
—<\/p>\n
## Current Limitations<\/p>\n
The current version still has clear boundaries. Please keep them in mind before use.<\/p>\n
### Not fully supported yet
\nThe following traditional shader pipeline components are not fully supported at this stage:<\/p>\n
– `gbuffers_*`
\n– `shadow.*`
\n– `composite.*`
\n– screen-space reflections (SSR)
\n– volumetric fog
\n– depth-driven material separation
\n– full dimension-specific shader routing (such as `world1\/`, `world-1\/`)<\/p>\n
### Currently suitable for porting
\nThe most suitable parts to port right now are:<\/p>\n
– `final.fsh`
\n– final grading
\n– vignette
\n– highlight compression
\n– tonemapping
\n– screen-space look layers<\/p>\n
### Known Issues
\n– Some translated packs still have **brightness mismatch**
\n– Some color tones may still deviate from the original pack\u2019s intended style
\n– runtime resource pack metadata is still being refined and standardized
\n– not every original shader pack can simply be used as-is<\/p>\n
—<\/p>\n
## Current Available Sample<\/p>\n
### Verdant Light 1.3.0 Vulkan Wrapper
\nThe repository already includes an **initial Vulkan-translated version** based on **Verdant Light 1.3.0**.<\/p>\n
This is not a full lossless recreation of the original shader pack. Instead, it:<\/p>\n
– keeps the original pack resources as reference material
\n– extracts the most portable final look layer
\n– runs the external ZIP pack through the current loader\u2019s real post-effect pipeline<\/p>\n
—<\/p>\n
## Usage<\/p>\n
### 1. Place a shader pack
\nPut the ZIP shader pack into:<\/p>\n
`run\/shaderpacks\/`<\/p>\n
**_I have uploaded the template pack on the detail page._**<\/p>\n
### 2. Select the active pack
\nEdit the config file:<\/p>\n
`run\/config\/vulkanpostfx.json`<\/p>\n
Example:<\/p>\n
“`json
\n{
\n “active_pack_id”: “verdantlight130vulkan”
\n}
\n““<\/p>\n
### 3. Launch the game<\/p>\n
When the client starts, the loader will:<\/p>\n
* scan ZIP files
\n* parse the active pack
\n* materialize runtime resources
\n* inject them into the client resource system
\n* attempt to load the corresponding external post chain<\/p>\n
### 4. Toggle the debug \/ external effect<\/p>\n
By default, press `F8` to toggle the current debug \/ external post-effect.<\/p>\n
—<\/p>\n
## Architecture Overview<\/p>\n
“`text
\n[shaderpacks\/*.zip]
\n |
\n v
\n[Manifest Parse]
\n |
\n v
\n[Active Pack Selection]
\n |
\n v
\n[Runtime Materialization]
\n |
\n v
\n[Runtime Resource Pack Injection]
\n |
\n v
\n[post_effect\/main.json]
\n |
\n v
\n[ShaderManager Post Chain Loading]
\n |
\n v
\n[External ZIP Shader Execution]
\n“`<\/p>\n
—<\/p>\n
## Most Suitable Development Direction Right Now<\/p>\n
The recommended next steps are not to keep stuffing more traditional shader files into the project, but to:<\/p>\n
1. continue improving `final`-path translation quality
\n2. correct brightness \/ exposure mismatches
\n3. improve fidelity for sky, water, and highlights
\n4. gradually introduce more complex `composite` semantics
\n5. eventually explore a more complete Vulkan shader compatibility layer<\/p>\n
—<\/p>\n
## Design Philosophy<\/p>\n
The core idea of this project is not to force all traditional shader semantics into Vulkan at once, but rather:<\/p>\n
**first establish a truly executable chain, then gradually bring back the visual logic that matters**<\/p>\n
In other words:<\/p>\n
* first make external packs actually run
\n* then gradually make the visuals resemble the original shader pack
\n* only after that pursue larger-scale compatibility<\/p>\n
—<\/p>\n
## Notes<\/p>\n
This is still a fast-evolving experimental project.
\nIf you are looking for a ready-made, fully compatible replacement for Iris \/ OptiFine, the current version is not there yet.
\nBut if you care about:<\/p>\n
* Vulkan shader workflows
\n* external ZIP shader pack loading
\n* an experimental translation framework for modern Minecraft
\n* gradually migrating traditional shader semantics into a new rendering path<\/p>\n
then this project is built exactly for that.<\/p>\n
—
\n## **_This mod updates weekly, maybe one time or more._**<\/p>\n","protected":false},"excerpt":{"rendered":"
A lightweight post-processing shader pack loader for Minecraft’s Vulkan renderer.<\/p>\n","protected":false},"featured_media":168057,"template":"","meta":{"_minecraft_slug":"vulkan-postfx","_minecraft_project_id":"TsmOcOBN","_minecraft_author":"Player9753193","_minecraft_license":"LicenseRef-Vulkan-PostFX-License-v1.2","_minecraft_downloads":742,"_minecraft_follows":7,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"vulkan-postfx.zip","_minecraft_size_bytes":3065924,"_minecraft_version_count":15,"_minecraft_updated_at":"2026-05-15T22:36:52.594440Z","_minecraft_date_created":"2026-04-12T01:54:48.871103Z","_minecraft_date_modified":"2026-05-15T12:04:45.834701Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vulkan-postfx","_minecraft_icon_attachment_id":168057,"_minecraft_imported_at":"2026-06-09T19:24:39+00:00","_minecraft_import_hash":"f5648c3bbfc03ec77734331d66903d59","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,97,89,90],"mod_loader":[99],"minecraft_version":[837,842],"class_list":["post-168056","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-fabric","mod_category-game-mechanics","mod_category-optimization","mod_loader-fabric","minecraft_version-26-2-snapshot-2","minecraft_version-26-2-snapshot-7"],"yoast_head":"\n