rrtt217’s HDR Mod

Minecraft HDR Mod

一款适用于 Minecraft 的模组，可在 Windows / macOS / Linux 上通过 Iris 光影实现原生 HDR。

（Photon 已通过 Patrix 修改以支持 HDR；由模组的截图功能拍摄。）

模组已实现的功能

• 支持 scRGB 和 HDR10/PQ 的原生 HDR。
• 通过新的渲染通道校正 UI 颜色。
• 可在游戏内使用 Cloth Config API 配置。
• 支持在游戏内截取 HDR 截图。
• Replay Mod HDR 视频导出（需要自定义 FFmpeg 命令行，可在配置菜单中找到）。
• 完整修复 Wayland 输入法问题（需要 IMBlocker）。

面向用户

[!IMPORTANT]

需要使用支持模组的光影包！https://github.com/rrtt217/Minecraft-HDR-Mod/wiki/HDR-Shaderpacks

• 通过配置菜单调整 HDR 亮度值（纸白亮度、UI 亮度、峰值亮度）。（默认按键：F9）
• 在游戏中截取 HDR 屏幕截图。（默认按键：F10）
• 支持的平台：
• Windows：Nvidia/AMD GPU 通常运行流畅。自 v2.1.0 起支持 Intel GPU，但需使用 DXGI 回退路径，且性能会有所下降（更多信息请参阅v2.1.0 发布说明）。
• Linux Wayland：AMD/Intel GPU 通常运行流畅。使用 Nvidia GPU 的用户可能会遇到一些问题或崩溃，可查看故障排除部分了解可能的解决方法。
• macOS：支持，但仍需进一步测试，预计会存在一些错误。此外，macOS 上的 shaderpack 支持有限。
• Android/iOS：不支持。如果移动端启动器开发者有兴趣参与此项目，我的 glfw 分支可以作为未来实现 HDR 支持的起点。
• 故障排除：
• 在默认设置下，ReShade 目前不兼容，会导致加载失败并破坏天空显示。
• 在 config/advanced 中启用“强制激活 OpenGL-DirectX 互操作”可提高与 SpecialK 和 ReShade 的兼容性。请确保它们只注入 DirectX 11 层。
• 会修改 GLFW 的模组也可能不兼容。（例如：Ixeris）
• 如果游戏画面太亮或太暗，请尝试自行调整自定义亮度值。
• 如果你使用的是 Windows，别忘了安装最新的 Visual C++ 可再发行组件。
• 如果游戏在 NeoForge/Forge 上崩溃，请在 <game folder>/config/fml.toml 中禁用 earlyWindowControl
• 如果启用光影后 HDR 异常，请将 Iris/Oculus 中的“Colorspace”设置重置为“sRGB”。
• 如果游戏无法启动或部分功能异常，请清理临时文件（路径可在日志中找到；Windows 上为 %TEMP%/glfw，Linux 上为 /tmp/glfw）。
• 对于 Linux Nvidia 用户，如果游戏无法启动，或游戏画面出现明显色带，可尝试以下解决方法（使用 Zink，因此性能预计会有所下降）：
• 使用以下环境变量：

        export __GLX_VENDOR_LIBRARY_NAME=mesa
        export __EGL_VENDOR_LIBRARY_FILENAMES=/run/opengl-driver/share/glvnd/egl_vendor.d/50_mesa.json
        export MESA_LOADER_DRIVER_OVERRIDE=zink
        export GALLIUM_DRIVER=zink

• 仅适用于 Mesa >= 26.0.0。较低版本会因缺少此 PR而导致游戏崩溃。

适用于光影包

Wiki 教程

• 面向光影包开发者

宏

• HDR_MOD_INSTALLED
• HDR_ENABLED

Uniform 变量

• float HdrGameMinimumBrightness；
• float HdrGamePeakBrightness；
• float HdrGamePaperWhiteBrightness；
• float HdrUIBrightness；

请在 #if HDR_MOD_INSTALLED 代码块中使用这些 uniform 变量。

输出

shader 的输出（即最终渲染阶段写入主渲染目标的内容）应采用 scRGB-nl 编码（Rec.709 原色、sRGB 传递函数；负数使用 −f(−x)），并且场景颜色不应使用 RGBA8F。

• Wiki 章节

鸣谢

• Tom94，提供了带色彩管理功能的 GLFW 分支；
• IMS212，提供了Iris 光影和最初的 GLFW 补丁构想；
• XgarhontX 和其他几位伙伴，参与了 RenoDX Minecraft HDR 和光影补丁的开发，并帮助我确保色彩转换正确。

版权

HDR 模组主仓库采用 MIT 许可证。随附的、来自 Tom94/我的分支的 GLFW 采用 zlib/libpng 许可证。

星标历史