Vulkan PostFX
Vulkan PostFX,又称 VPFX,是专为 Minecraft 现代基于 Vulkan 的渲染路径设计的实验性 VPFX 光影包加载器与后处理框架。
它允许外部 VPFX 光影包添加屏幕空间视觉效果,如颜色分级、暗角、色调映射、高光压缩、电影感调整、基于深度的效果以及早期的阴影深度实验。
该项目仍处于实验阶段,但已支持通过 Minecraft 的资源管线加载基于 ZIP 格式的 VPFX 光影包。
从这里开始
为了获得最佳的首次体验,请同时安装:
- Vulkan PostFX —— 加载器与运行时
- VPFX Minimal Showcase —— 官方最小示例包
Vulkan PostFX 并非 Iris / OptiFine 的完整替代品。
其目标是为 Minecraft 的 Vulkan 渲染路径构建一套新的 VPFX 工作流,从可靠的外部包加载起步,逐步迈向功能更强大的光影运行时。
Vulkan PostFX 的功能
Vulkan PostFX 目前专注于:
- 基于 ZIP 的外部 VPFX 光影包加载
- 基于图的(graph-based)后处理配置
- 运行时资源包的实例化(materialization)
- 运行时资源包的注入
- 外部后处理链的执行
- 场景颜色采样
- 场景深度捕获
- 实验性的阴影深度输入
- 针对损坏包的诊断信息
- 早期原生运行时实验
这意味着 Vulkan PostFX 已经在执行真实的外部 VPFX 包管线,而不仅仅是解析 ZIP 文件。
external ZIP shader pack
-> VPFX manifest / graph validation
-> runtime resource pack materialization
-> Minecraft resource system injection
-> external post-chain execution
当前特性
外部 VPFX 包加载
Vulkan PostFX 支持包含以下文件的基于 ZIP 格式的 VPFX 光影包:
pack.json
post_effect/main.json
shaders/<path>.vsh
shaders/<path>.fsh
着色器引用使用以下格式:
<pack_id>:<path>
例如:
vpfx_minimal_showcase:composite/final
将解析为:
shaders/composite/final.vsh
shaders/composite/final.fsh
着色器路径不限于固定的 post/ 目录布局。
运行时命名空间重写
外部包会被重写为隔离的运行时命名空间,以减少与内置资源及其他包的冲突。
这使得 VPFX 包的行为更像外部的视觉包,同时仍通过 Minecraft 的资源系统进行路由。
运行时资源包注入
外部 ZIP 内容会在启动或资源重载期间实例化为运行时资源包,并注入到 Minecraft 客户端资源系统中。
这是 VPFX 加载管线的核心部分之一。
外部后处理链执行
Vulkan PostFX 可以通过 Minecraft 的 ShaderManager 加载外部后处理链,并通过当前的 minecraft_postchain 后端执行它们。
当前稳定的执行路径仍基于 Minecraft 的后处理链系统。
场景、深度和阴影输入
当前 VPFX 运行时输入包括:
minecraft:scene_color
vulkanpostfx:scene_depth
vulkanpostfx:shadow_depth
minecraft:main
这些输入用于屏幕空间效果、基于深度的实验以及阴影深度调试。
故障诊断
当 VPFX 包加载或执行失败时,Vulkan PostFX 可以生成有关以下问题的诊断信息:
- 缺失的着色器文件
- 无效的图目标
- 采样器不匹配
- 着色器路径错误
- 外部目标问题
- 管线创建失败
如果包已损坏,目标是让失败变得易于理解,而不是静默失败。
实验性原生运行时
Vulkan PostFX 正逐渐超越 Minecraft 默认的后处理链后端。
当前实验性原生运行时的进展包括:
- 原生运行时支持检查
- 资源映射试运行(dry-runs)
- 同目标竞争检测
- 瞬态颜色目标规划
mainTarget -> transientColor复制验证- 内置原生全屏直通绘制
- 用于测试原生直通路径的可选诊断模式
当前实验性原生路径可概括为:
minecraft:main
-> transientColor
-> builtin native fullscreen passthrough
-> minecraft:main
这仍处于实验阶段且为可选开启。
用户 VPFX 着色器尚未完全在原生模式下执行。
当前示例包
VPFX Minimal Showcase
官方最小示例包展示了以下内容:
- VPFX
pack.json - 基于图的后处理效果配置
- 非
post/的着色器路径 minecraft:scene_color采样minecraft:main输出- 基本的屏幕空间外观调整
它是测试 Vulkan PostFX 的推荐起点。
使用方法
1. 放置 VPFX 光影包
将 VPFX 光影包 ZIP 文件放入 Minecraft 实例的 shaderpacks 文件夹中。
对于开发运行环境,通常位于:
run/shaderpacks/
2. 选择活动包
编辑配置文件:
config/vulkanpostfx.json
对于开发运行环境,通常位于:
run/config/vulkanpostfx.json
示例:
{
"active_pack_id": "vpfx_minimal_showcase"
}
3. 启动游戏
当客户端启动时,Vulkan PostFX 将:
- 扫描可用的 VPFX ZIP 包
- 解析
pack.json - 选择活动包
- 验证 VPFX 图结构
- 实例化运行时资源
- 将运行时资源注入客户端资源系统
- 尝试加载对应的外部后处理链
4. 切换效果
默认情况下:
F8
切换当前 VPFX 效果。
F9
切换实验性阴影深度调试视图。
架构概览
当前外部包路径:
[shaderpacks/*.zip]
|
v
[VPFX 清单/图解析]
|
v
[活动包选择]
|
v
[运行时实例化]
|
v
[运行时资源包注入]
|
v
[minecraft_postchain 后端]
|
v
[外部 VPFX 后处理链执行]
实验性原生运行时路径:
[VPFX 原生运行时]
|
v
[mainTarget -> transientColor]
|
v
[内置原生全屏直通]
|
v
[minecraft:main]
这是什么
Vulkan PostFX 目前可以最好地描述为:
- 一个可工作的 VPFX ZIP 光影包加载器
- 一种基于后处理的执行后端
- 一个实验性的 Vulkan 光影运行时基础
- 一个早期的原生运行时研究项目
它专为 Minecraft 的现代 Vulkan 渲染路径以及针对 VPFX 的光影包而设计。
这不是什么
Vulkan PostFX 尚未成为 Iris 或 OptiFine 成熟的即插即用替代品。
大多数 Iris / OptiFine 光影包在未经移植的情况下无法直接使用。
传统光影管道兼容性并非第一阶段开发的重点。
当前限制
Vulkan PostFX 仍处于 Alpha 软件阶段。
以下传统光影管道组件尚未完全支持:
gbuffers_*- 完整的
shadow.*兼容性 - 完整的
composite.*兼容性 - 屏幕空间反射 (SSR)
- 体积雾
- 自然云渲染
- 材质感知光照
- 特定维度的光影路由,例如
world1/和world-1/ - 直接兼容 Iris / OptiFine 光影包
原生运行时限制
原生运行时目前仅支持一个实验性的内置全屏直通路径。
它尚不支持:
- 用户自定义光影的原生执行
- 多通道原生执行
- 自定义原生渲染目标
- 原生场景深度输入
- 原生阴影深度输入
- 计算着色器 (Compute Shaders)
- 原生体积光照
- 原生云渲染
- 光线追踪 (RT) / 路径追踪 (Path Tracing)
设计理念
Vulkan PostFX 的核心思想并非试图一次性将所有传统光影包的语义强制融入 Vulkan。
相反,该项目遵循分阶段的策略:
使外部 VPFX 光影包真正运行
-> 提升视觉保真度
-> 稳定运行时
-> 扩展图的执行
-> 逐步恢复高级视觉效果
换句话说:
首先建立一个真正可执行的外部光影链,然后逐步恢复关键的视觉逻辑。
备注
这是一个快速演进的实验性项目。
如果您正在寻找一个现成的、完全兼容的 Iris / OptiFine 替代品,Vulkan PostFX 目前还达不到这个要求。
但如果您关注:
- Minecraft 的 Vulkan 渲染路径
- VPFX 光影包实验
- 外部 ZIP 光影包加载
- 现代运行时资源包注入
- 基于场景/深度/阴影的后处理效果
- 实验性原生渲染图运行时开发
那么这个项目正是为此而构建。
更新策略
预计 Vulkan PostFX 将紧跟 Minecraft 快照版本的更新步伐。
该项目可能会每周更新,或者在 Minecraft 快照或 VPFX 运行时里程碑需要时更频繁地更新。
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.
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:
pack.json
post_effect/main.json
shaders/<path>.vsh
shaders/<path>.fsh
Shader references use the following format:
<pack_id>:<path>
For example:
vpfx_minimal_showcase:composite/final
which resolves to:
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:
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 -> transientColorcopy 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:
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_colorsamplingminecraft:mainoutput- 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:
run/shaderpacks/
2. Select the active pack
Edit the config file:
config/vulkanpostfx.json
For development runs, this is usually:
run/config/vulkanpostfx.json
Example:
{
"active_pack_id": "vpfx_minimal_showcase"
}
3. Launch the game
When the client starts, Vulkan PostFX will:
- scan available VPFX ZIP packs
- parse
pack.json - select the active pack
- validate the VPFX graph
- materialize runtime resources
- inject runtime resources into the client resource system
- attempt to load the corresponding external post chain
4. Toggle effects
By default:
F8
toggles the current VPFX effect.
F9
toggles the experimental shadow depth debug view.
Architecture overview
Current external pack path:
[shaderpacks/*.zip]
|
v
[VPFX Manifest / Graph Parse]
|
v
[Active Pack Selection]
|
v
[Runtime Materialization]
|
v
[Runtime Resource Pack Injection]
|
v
[minecraft_postchain backend]
|
v
[External VPFX Post Chain Execution]
Experimental native runtime path:
[VPFX Native Runtime]
|
v
[mainTarget -> transientColor]
|
v
[builtin native fullscreen passthrough]
|
v
[minecraft:main]
What this is
Vulkan PostFX is currently best described as:
- a working VPFX ZIP shader pack loader
- a post-effect based execution backend
- an experimental Vulkan shader runtime foundation
- an early native runtime research project
It is designed for Minecraft’s modern Vulkan rendering path and for VPFX-specific shader packs.
What this is not
Vulkan PostFX is not yet a mature drop-in replacement for Iris or OptiFine.
Most Iris / OptiFine shader packs cannot be used directly without porting.
Traditional shader pipeline compatibility is not the current focus of the first development stages.
Current limitations
Vulkan PostFX is still alpha software.
The following traditional shader pipeline components are not fully supported yet:
gbuffers_*- full
shadow.*compatibility - full
composite.*compatibility - screen-space reflections
- volumetric fog
- natural cloud rendering
- material-aware lighting
- dimension-specific shader routing such as
world1/andworld-1/ - direct Iris / OptiFine shader pack compatibility
Native runtime limitations
The native runtime currently supports only an experimental builtin fullscreen passthrough path.
It does not yet support:
- user shader native execution
- multi-pass native execution
- custom native render targets
- native scene depth input
- native shadow depth input
- compute shaders
- native volumetric lighting
- native cloud rendering
- RT / path tracing
Design philosophy
The core idea of Vulkan PostFX is not to force every traditional shader-pack semantic into Vulkan at once.
Instead, the project follows a staged approach:
make external VPFX packs actually run
-> improve visual fidelity
-> stabilize the runtime
-> expand graph execution
-> gradually bring back advanced visual features
In other words:
first establish a truly executable external shader chain, then gradually bring back the visual logic that matters.
Notes
This is a fast-evolving experimental project.
If you are looking for a ready-made, fully compatible Iris / OptiFine replacement, Vulkan PostFX is not there yet.
But if you care about:
- Minecraft’s Vulkan rendering path
- VPFX shader pack experiments
- external ZIP shader pack loading
- modern runtime resource pack injection
- scene / depth / shadow based post effects
- experimental native render graph runtime development
then this project is built exactly for that.
Update policy
Vulkan PostFX is expected to follow Minecraft snapshot updates quickly.
The project may update weekly, or more often when Minecraft snapshots or VPFX runtime milestones require it.
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Vulkan PostFX
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
Vulkan PostFX 1.15.11
本次发布专注于原生 VPFX 渲染目标生命周期,提升了性能、资源安全性、时间效果的正确性以及后端回退的可靠性。
亮点
- 原生渲染目标现在跨帧复用,而不是每帧重新创建。
- 渲染目标资源现在由活动的 VPFX 会话拥有。
- 历史记录和目标在打包激活之间相互隔离。
- 历史缓冲区仅在其目标在帧内实际被写入时才会推进。
- 原生运行时失败继续安全地回退到 Minecraft PostChain。
新增
-
新增了会话作用域的原生渲染目标资源管理器。
-
新增了可复用的缓存机制,适用于:
- 场景颜色快照
- 瞬时渲染目标
- 持久化渲染目标
- 历史目标
- 跨帧乒乓目标
-
新增了包含以下内容的不可变原生目标描述符:
- 目标标识符
- 宽度和高度
- 纹理格式
- 深度用法
- 目标类型
-
新增了原生资源生命周期统计信息:
- 分配次数
- 复用次数
- 重建次数
- 销毁次数
- 分配失败次数
- 活动拥有的资源数
- 活动借用的资源数
- 资源代数
-
将原生目标统计信息添加到了 VPFX 调试 HUD。
-
新增了针对资源复用、调整大小、失败、历史状态、会话隔离和回退行为的生命周期验证测试。
更改
-
当原生渲染目标的描述符保持不变时,它们将在活动的 VPFX 会话期间保持分配状态。
-
明确了瞬时目标的含义:
- 其内容不会在会话之间保留。
- 其 GPU 分配仍可能在帧之间复用。
-
持久化、历史和乒乓资源现在是完全会话作用域的,而不是按运行时命名空间全局存储。
-
渲染目标重建现在遵循更安全的顺序:
创建替换资源
→ 替换缓存引用
→ 销毁前一个资源
-
原生回退现在立即释放由失败会话拥有的原生资源。
-
重新选择相同的着色器包仍会创建一个新会话并重试原生运行时。
-
帧渲染目标包装器现在明确为非拥有型。
- GPU 资源的销毁完全由会话资源管理器处理。
-
原生清除行为现在更加确定:
- 瞬时目标在每帧首次写入时会被清除。
- 同一帧内的后续写入保留现有内容。
- 持久化和历史缓冲区在创建或调整大小时进行初始化。
- 深度目标使用默认清除深度
1.0。
-
清除颜色值现在进行了防御性复制,以防止意外修改共享状态。
修复
- 修复了原生渲染目标每帧重复创建和销毁的问题。
- 修复了旧会话可能干扰同一打包的新激活所创建的资源的问题。
- 修复了当只能创建历史或乒乓目标对的一部分时导致的资源泄漏问题。
- 修复了失败的目标重建过早销毁前一个有效资源的问题。
- 修复了失败的分配留下不完整缓存条目的问题。
- 修复了已处置的原生会话无声地返回到每帧目标分配的问题。
- 修复了原生资源在当前会话回退到 PostChain 后仍保持分配的问题。
- 修复了历史缓冲区在第一帧采样未定义内存的问题。
- 修复了失败帧错误地推进历史状态的问题。
- 修复了历史目标和乒乓目标在不正确使之前历史失效的情况下被重新创建的问题。
- 修复了原生目标格式变化错误地重用不兼容的缓存目标的问题。
- 修复了持久化和历史目标被报告为外部借用资源的问题。
- 修复了因复用持久化目标而导致的每帧日志记录问题。
- 修复了可变默认清除颜色数组暴露给调用者的问题。
- 修复了即使在一帧内没有任何通道向其写入,历史目标仍会推进的问题。
历史缓冲区正确性
历史和跨帧乒乓目标现在仅在满足以下两个条件时才推进:
- 原生帧成功完成。
- 特定目标在该帧中实际被写入。
未被写入的目标保留其之前的:
- 读取缓冲区
- 写入缓冲区
- 历史有效性状态
这防止了时间效果意外采样已清除、过时或未写入的缓冲区。
资源所有权
VPFX 现在区分它拥有的资源和从 Minecraft 或其他系统借用的资源。
VPFX 拥有的资源
- 场景颜色快照
- 瞬时渲染目标
- 持久化渲染目标
- 历史缓冲区对
- 跨帧乒乓缓冲区对
- 诊断原生目标
借用资源
- Minecraft 主帧缓冲区
- 场景深度
- 阴影深度
- 外部运行时纹理
VPFX 永远不会销毁借用资源。
验证
原生目标生命周期验证套件现在包含 36 个通过的检查,涵盖:
- 资源复用
- 调整大小重建
- 格式更改
- 分配失败恢复
- 部分双缓冲创建回滚
- 会话处置
- 同命名空间会话隔离
- 延迟旧会话回退
- 历史初始化和提交行为
- 原生回退清理
- 打包切换
- 清除颜色隔离
- 历史提交门控
备注
- 乒乓目标目前使用跨帧双缓冲。
- 尚不支持同帧多通道乒乓交替。
- 本次发布没有添加新的内置视觉效果。
- VPFX 继续优先使用原生运行时,并且仅在当前激活失败时回退到 Minecraft PostChain。
- 再次选择该打包将重试原生后端。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
原版世界生成优化模组
模组
适用于 MC 1.18+ 的 Effekseer 加载器
模组
缓冲的原始输入和线程化的事件轮询
模组
让你能够在世界中的任何位置定位结构。
模组
一堆修复
评论 0
登录后参与评分
还没有评论,来抢沙发吧