Skip to content

README-CN.md

Latest commit

 

History

History
111 lines (63 loc) · 6.33 KB

README-CN.md

File metadata and controls

111 lines (63 loc) · 6.33 KB

| English | 简体中文 |

这里是Radiance mod的Java部分。C++部分请访问Minecraft Vulkan Renderer (MCVR)

Radiance

Radiance是一个Minecraft Mod，旨在将原版的OpenGL渲染器完全替换成我们的高性能Vulkan C++渲染器，并且支持硬件加速光线追踪。 由于现代工业界广泛在渲染管线中使用C++，所以我们的Vulkan C++渲染器能够将一个现代工业级的渲染模块（例如DLSS和FSR）无缝集成进来。

演示视频 (B站)

关于PBR材质包

从0.1.4开始，不需要任何预处理了，直接加载！

尽管有内置的发光贴图，依旧推荐使用一个PBR材质包来获得更好的体验。

安装指南

我们默认Minecraft本体安装在.minecraft文件夹下。如若安装路径不同，请自行替代。

正常下载和安装模组.jar文件

正常下载和安装模组 jar 文件到.minecraft/mods文件夹。

(Windows修复) 调整JDK的运行库

因为一个已知的MSVC问题，有些JDK自带的运行库会导致模组报错，游戏崩溃。

这种情况下，一种可能的解决方案为：

首先，尝试改动（重命名，删除，等）JDK bin目录（${PATH_TO_JDK}/bin）下的msvcp140.dll，vcruntime140.dll和vcruntime140_1.dll文件。最终要让这些文件不存在在JDK bin目录下。这一步的目的是移除JDK对于它自带的运行库的依赖。

然后，安装最新的Microsoft Visual C++ Redistributable，使用Latest supported v14 (for Visual Studio 2017–2026)版本。这一步的目的是让JDK重新使用最新的系统运行库。

下载和安装DLSS运行库

为尊重并遵守 NVIDIA DLSS SDK 的许可条款，本项目仓库与发行物（Release）不包含、也不提供任何 NVIDIA DLSS 的二进制文件或 SDK 组件（例如 nvngx_dlss.dll），亦不会在运行时为你自动下载这些文件。 若你希望启用本模组中的 DLSS 去噪 & 超分 模块，请你自行按照下文的下载步骤从 NVIDIA 官方渠道获取对应版本的 DLSS 运行库，并将其放置到.minecraft/radiance文件夹。

下载、安装或使用 NVIDIA DLSS 运行库（例如 nvngx_dlss.dll）即表示你已阅读并同意遵守 NVIDIA DLSS/RTX SDK 的许可协议（License Agreement）。若你不同意该许可协议，请勿下载、安装或使用该运行库，并请改用本模组提供的其他替代方案（第一个alpha版本后）。

目前，如果未检测到 DLSS 运行库，本模组会使游戏崩溃。第一个alpha版本后，如果检测不到 DLSS 运行库，DLSS 功能会被自动禁用并回退到替代方案（我们到时候应该能够支持 FSR 3 以及自定义 Denoiser 模块）。

下载步骤

针对 AMD 用户的提示： 若遇到 “DLSS runtime libraries not found” 错误，可以选择下载 DLSS 运行库，或者直接在相应目录下创建对应的同名空白文件 来绕过启动检查。这一强制依赖将在下个版本中移除。

Windows

从这个路径中下载如下列表中的文件到.minecraft/radiance文件夹（如果文件夹不存在，请创建一个）。

  • nvngx_dlss.dll
  • nvngx_dlssd.dll

Linux

从这个路径中下载如下列表中的文件到.minecraft/radiance文件夹（如果文件夹不存在，请创建一个）。

  • libnvidia-ngx-dlss.so.310.5.3
  • libnvidia-ngx-dlssd.so.310.5.3

构建

首先，用gradle编译Java来生成JNI头文件。

./gradlew compileJava

然后，克隆Minecraft Vulkan Renderer (MCVR)仓库。

git clone https://github.com/Minecraft-Radiance/MCVR.git

使用cmake编译和安装。详细信息请参考这里。

最后，用./gradlew build构建。

Todo列表

  • 移植到更多版本和mod加载器（WIP，最高优先级)
  • XESS支持
  • 帧生成
  • HDR

以及更多...

致谢

这个项目使用了 Vulkan。获取更多信息请访问这个页面。

这个项目同时也使用了 Nvidia 的 DLSS (Deep Learning Super Sampling) 技术。获取更多信息请访问这个和这个页面。

这个项目也使用了FSR3。更多信息请访问这个页面。

这个项目也使用了XeSS SR。更多信息请访问这个页面。

特别感谢所有这个项目使用的开源库的制作者，包括NRD、GLFW、GLM、STB Image和VMA。 如果有应该致谢但是没有被提及的，请通知本项目作者。我们会把致谢添加在需要添加的位置。

免责声明

  • 本项目为社区开发的第三方模组（Mod），不隶属于、亦未获得 Mojang Studios / Microsoft 的授权附属、赞助或支持。参考常见模组分发平台的表述：“NOT AN OFFICIAL MINECRAFT SERVICE. NOT APPROVED BY OR ASSOCIATED WITH MOJANG OR MICROSOFT.”
  • Minecraft 以及相关名称、标识与资源为 Mojang Studios / Microsoft 的商标或知识产权。
  • 本项目同样不隶属于、亦未获得 NVIDIA 的授权附属、赞助或支持；NVIDIA / GeForce / RTX / DLSS 等名称与标识为 NVIDIA Corporation 的商标，归其各自权利人所有。
  • 本项目按“AS IS”提供。使用本模组产生的任何风险（包括但不限于崩溃、画面问题、数据丢失、与其他模组冲突等）由使用者自行承担；请在安装前备份存档与配置。