Vulkan PostFX

模组

· 作者 IonHex975

Minecraft 现代基于 Vulkan 渲染路径的实验性 VPFX 光影包加载器与后处理框架。

0 本站下载 0 关注 更新于 4 个月前

最新 1.15.11+mc26.2-2026-07-10 · 26.2 · Fabric

一键开服(送7天)

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 运行时里程碑需要时更频繁地更新。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源