Skip to content
BranchesTags

Latest commit

 

History

40 Commits

Folders and files

NameName
Last commit message
Last commit date
docs
docs
 
 
examples
examples
 
 
licenses
licenses
 
 
release
release
 
 
src
src
 
 
tools
tools
 
 
.gitignore
.gitignore
 
 
NOTICE
NOTICE
 
 
README.md
README.md
 
 

Repository files navigation

原神 DLSS5 一键包

目录

  1. 务必下载完整文件夹包，并将其放到任意 英文路径下。不要放在带有中文路径或者空格的路径下
  2. 只双击 启动_DLSS5.bat。
  3. 第一次选择 YuanShen.exe 或 GenshinImpact.exe，以后再次双击即可。
  4. 如果不成功，请看失败排查！！！一定要看！一定要看！一定要看！！！

两个完整包都已经包含各自运行所需组件，不需要提前安装 GIMI、ReShade、OptiScaler、DLSS DLL 或 FPS Unlocker。v1.1 包含原来的 DLSS5 bridge/RenoDX 后置 NR 链路；v1.3 使用前置 NR 插件与经过后端兼容修改的 OptiScaler，并保留输出分辨率后置 NR 模式。只需运行批处理文件，不需要打开 .ps1，也不需要改名 dxgi.dll/d3d12.dll。

HDR 也已包含并默认启用：启动器会设置原神的 HDR 开关，包内带有 RenoDX/HDR 相关处理和 shader。要看到真实 HDR 输出，还需要在 Windows 和显示器上开启 HDR；ReShade shader 只是随包提供，不会自动启用每一个效果。

v1.1 与 v1.3（按需选择）

v1.1 和 v1.3 是当前并列提供的两个正式版本，请按需要选择并放在相互独立的文件夹内，不要把两个版本的 payload 或 Add-ons 相互覆盖。v1.2、v1.0 作为历史版本保留在本文末尾。

如果v1.3用不了请换兼容性更强的v1.1, 新版bug太多

版本 DLSS5 NR 的位置 适合人群 当前显卡范围
v1.1 后置 NR 版 原始 DLSS 已经得到输出帧后，再在输出分辨率执行 NR；NR 本身不承担低分辨率超分 希望保留原来效果，或不需要“低分辨率 NR 后再超分”的用户 RTX 50；RTX 40、30 按下文替换专用 NR 模型
v1.3 后端 NR 兼容双模式版 默认先在低渲染分辨率执行 DLSS5 NR，再由原始 DLSS SR 放大；也可切回原插件的“DLSS SR 后在输出分辨率 NR” 希望使用前置超分，或在同一包中比较/使用恢复后的后置 NR RTX 30 / RTX 50 独立 Profile，一键自动选择；RTX 40 尚待实机验证

v1.1：后置 NR 版（有问题进q 1107530312 联系）

v1.1 已修复此前 RenoDX DLSS5 插件的显存泄漏问题，并更新 DLSS5/NR 模型组件。支持 50 系显卡。这一版继续保留给不需要 v1.3 前置 NR 超分的用户。

失败排查！！！一定要看！一定要看！一定要看！！！

百度网盘提取码：y95x；7z 解压密码：yuanshenqidong。

v1.3：后端 NR 兼容双模式正式版

v1.3 是此前 v1.2 前置 NR 实验版完成 RTX30 后端兼容修复、双模式恢复和一键启动整合后的正式版本。默认把 DLSS5 Neural Rendering 放到低分辨率阶段，然后把 NR 结果交给原始 DLSS Super Resolution 放大；同时恢复插件原有的 Mode 1：低分辨率输入 -> DLSS SR -> 输出分辨率 NR。

本版不是只替换 RTX30 的 NR DLL：修改版 OptiScaler 按驱动要求使用原生 D3D12 NGX 参数对象，修复私有参数 ABI 与初始化顺序；补齐 queue-affinity、command-list/fence 生命周期、typed/untyped 资源槽和 FP16 carrier/write-back；创建私有 DX12 设备时避免 ReShade 二次包装。RTX30 Profile 同时使用已验证的稳定旧版前置 NR Add-on，避免新版生命周期门禁看不到私有 queue 提交而在 NR/原始 SR 之间持续闪烁。Feature 18 仍保持启用，并未退回普通 DLSS。

双 Profile 一键包只保留 启动_DLSS5.bat：脚本会自动识别 RTX 30/RTX 50，识别失败或检测到未验证的显卡时会直接提示选择 Profile。启动器不再重写 Enabled 或 Mode，因此插件界面的模式选择会跨重启保留。详细原因和源码审核见 docs/RTX30_DUAL_MODE_FIX.md。

  • Google Drive 下载（海外/不限速）

  • 夸克网盘下载

  • 文件大小：221,201,410 bytes（约 211 MiB）

  • SHA-256：95A87BC1B5C981A7AFA63E9E18BB68410B1697D3F20108418AC9B7A4050388CF

  • 7z 解压密码：yuanshenqidong；已启用 AES 内容与文件名加密

不要把 v1.1 的 dlss5-dx11-bridge、RenoDX 后置 NR Add-on 或 RTX 40 模型直接覆盖到 v1.3 目录。RTX 30 Profile 使用无数字签名的 RankFTW 310.8.SF-v2 runtime；RTX 50 Profile 使用 NVIDIA 签名 runtime，两套 nrchain/runtime 必须成套保留。

RTX 40，30 系列专用 DLSS NR 模型

以下替换方法用于 v1.1。如果显卡是 RTX 40 或30 系列，请额外下载 RHI 提供的 RTX40或30 专用 nvngx_dlssnr.dll，不要直接使用 v1.1 完整包内的默认 NR 模型：

解压后，用其中的 nvngx_dlssnr.dll 替换：

DLSS5_GI_Ready\payload\ReShade\reshade-shaders\Addons\nvngx_dlssnr.dll

只替换这个文件，其余插件均保持不变。v1.3 使用独立 Profile 和前置链路，不适用本节的单 DLL 替换方法；RTX30 已集成，RTX40 尚待实机验证。

报错闪退-进不去原神-进去了画面未生效可能原因

进群提问前请先看

如果启动时出现下图中的 The client is damaged, please reinstall the client. Error Code: (2,0,4)、Illegal tool detected, please restart the machine. Error Code: (6,4,2502)，或能够进入游戏但画面完全没有变化，请先不要反复覆盖安装。这些现象可能由旧注入组件残留、安全软件拦截、路径或权限问题、驱动/系统不符合要求，以及安装后尚未重启等因素引起，并不一定代表原神客户端本体损坏。

客户端损坏与非法工具典型报错

请优先完整使用本页提供的一键包。除非你已经理解各组件的加载关系，并阅读了一键包组件来源与替换说明，否则不要自行混装或替换 ReShade、NR、DLSS、Add-on、OptiScaler 等组件。安装新版本前，请彻底清理以前安装的第三方注入文件，确保游戏目录处于干净状态，再按顺序完成下面八项排查。

完成八项排查后仍有问题，再进群提问。提问时请一次性提供：使用的版本（v1.1 或 v1.3）、显卡型号、NVIDIA 驱动版本、Windows 版本、完整错误码、压缩包解压后的完整路径，以及启动窗口或相关日志截图。未提供这些信息时很难定位问题，重复的无信息报错可能无法得到回复。

  1. 请确保自己的系统是window11 24H及以上系统， 如不是请更新系统至最新（win10请升级至win11）。v1.1 按原说明选择 30/40/50 系模型；v1.3 双 Profile 一键包用于 NVIDIA RTX 30/50 系，RTX 40 暂未自动归类与验证。请确保你使用的压缩包来源与此处记录一致。请确保解压后放到任意 英文路径下，不要放在带有中文或者空格或者特殊字符的路径下*
  2. 请在第一次启动前删除或卸载除当前压缩包以外的所有你安装过的第三方内容（如第三方游戏目录注入式启动器，Reshade组件，RHI组件等等），保证游戏目录文件夹处于干净状态，防止与DLSS5启动冲突。
  3. 首先关闭你的所有杀毒软件，包括但不限于毒枭360，毒王电脑管家，毒霸金山... 其次检查是否插件被windows拦截了，具体按在win键，搜索安全，进入到windows安全中心，找到如下页面是否把UnlockerStub.dll给拦截了，需要允许其使用这个程序 alt text
  4. 检查驱动是否为新版，目前已验证版本610.88可以正常启动使用v1.1，RTX30 修复记录在 581.57 上验证 v1.3 链路，RTX50 实测使用 616.56；通常推荐更新到适用于当前显卡的稳定驱动
  5. 检查帧率限制是否已经被解除，如果没有，请务必在系统托盘中退出unlockfps_nc这个程序，然后重新双击启动DLSS5
  6. 尽量不要把原神安装在系统盘的Program Files 目录，启动可能会有权限问题，可尝试使用管理员权限启动DLSS5, 或者将原神本体安装在根盘或者其它数据盘内。
  7. 不要开启nvidai app里面的插帧功能！！！且原神内部的抗锯齿选项请使用FSR2！！！因为我们通过这个接口转成DLSS算法抗锯齿。进入游戏后可以试着调一下渲染倍率，其中倍率0.999相当于DLAA，0.2 就是超级性能档的DLSS. 关闭垂直同步，关闭动态模糊，关闭角色动态高精度。
  8. 最后，请尝试重启游戏，重启系统看看是否解决。

补充说明：如果解帧状态异常，请先在系统托盘退出 unlockfps_nc 后重新启动；仍然异常时重启系统。HDR 下插件内置截图可能呈灰色或色彩偏差，验证画面建议优先使用系统截图工具。

DLSS5刚进入时可能会有屏幕闪烁

刚进入场景时的短暂初始化闪烁可能是正常现象，可以自行调整参数；如果画面长期在 NR 与原始 SR 两种状态之间持续闪烁，则不是正常调参现象，应检查是否误用了带 lifecycle 门禁的新版 Add-on。v1.3 默认使用已验证的稳定 Add-on。 alt text

调参示例源于b站up主ZHFred

解压后的目录

解压完成后，根目录应类似下图：

解压后的文件结构

工作原理以及 v1.1/v1.3 的区别

原神本身是 DX11，而 DLSS5 插件需要 DX12 NGX 调用。两个版本都会通过启动器按固定顺序注入 ReShade、Dx11FsrBridge.dll 和 OptiScaler.dll，但 NR 插入点不同。

v1.1 后置 NR 链路

原神 DX11 低分辨率颜色 / 深度 / 运动向量
  -> Dx11FsrBridge 与 OptiScaler 提供 DLSS 兼容入口
  -> 原始 DLSS 得到游戏输出帧
  -> DLSS5 DX11 Bridge 转入私有 DX12 NGX 会话
  -> RenoDX / DLSS5 Add-on 在输出分辨率执行 Neural Rendering
  -> 结果复制回 DX11
  -> ReShade / UI

v1.1 的 NR 位于原始 DLSS 输出之后。它适合希望保留原方案，或者不需要把 NR 放到低渲染分辨率再超分的用户。旧桥接插件还处理了 ReShade 二次包装自建 D3D12 设备造成的启动冲突：创建内部设备时临时绕过 ReShade 的设备 hook、还原原生 adapter，随后恢复 hook；不修改系统 DLL。

v1.3 双模式链路

原神 DX11 低分辨率颜色 / 深度 / 运动向量
  -> Dx11FsrBridge 捕获 FSR2 输入
  -> OptiScaler dlss_12 创建私有 DX12 NGX 会话
  -> 前置 NR Add-on 以 Feature 18 在渲染分辨率执行 Neural Rendering
  -> 原始 DLSS Feature 1 从渲染分辨率放大到输出分辨率
  -> 结果复制回 DX11
  -> ReShade / UI

v1.3 不加载 v1.1 的 dlss5-dx11-bridge 与 RenoDX 后置 NR Add-on，并关闭 OptiScaler 内置 NR，避免与外部双模式 add-on 重复处理。

取消插件里的“使用渲染分辨率 NR -> SR”后，外部 add-on 改走：

原神 DX11 低分辨率颜色 / 深度 / 运动向量
  -> 原始 DLSS Feature 1 放大到输出分辨率
  -> DLSS5 Feature 18 在输出分辨率执行 Neural Rendering
  -> 结果复制回 DX11
  -> ReShade / UI

OptiScaler 内置 NR 仍保持关闭，但外部 add-on 会按 Mode 1 或 Mode 2 只执行选中的一条链路。兼容构建包括：

  1. 在 dlss_12 路径按驱动要求初始化原生 D3D11 NGX，并用原生 D3D12 NGX 参数对象交接资源，解决 RTX 30 上的私有参数 ABI/初始化顺序问题。
  2. 每帧维护 queue-affinity 标记和 typed/untyped D3D12 资源槽；原神输出属于 R8/R10/R11 packed/typeless 格式时使用 FP16 输出载体，整条链完成后再写回，从而恢复 Mode 1 的输出分辨率 NR。
  3. 创建私有 DLSS-on-DX12 设备时解包 ReShade adapter，并只在创建调用期间临时绕过 D3D12CreateDevice detour，完成后立即恢复；不修改系统 DLL。

脚本每次启动都会把 ReShade 的 AddonPath、Shader 路径和 OptiScaler 路径改为压缩包当前位置，但不会覆盖 add-on 的 Enabled/Mode。GitHub 只保存源码、补丁和小型 release 文件；完整运行包与大型 NVIDIA/RankFTW DLL 不放入 Git 历史。重建时先应用 OptiScaler-DLSSOn12-pre-NR.patch，再应用 OptiScaler-RTX30-dual-mode.delta.patch。

引用的开源项目

  • Genshin FSR Bridge：拦截原神 DX11 的 FSR2 调用，准备颜色、深度和运动向量，并把超分请求转交给 OptiScaler。这里使用它的 Dx11FsrBridge.dll 作为 DX11 输入桥接；本项目没有改写其核心 FSR 算法，只调整了组件目录和加载顺序。
  • DLSS5 DX11 Bridge：把 DX11 的 NGX 请求复制到自建 DX12 会话，使 DLSS5 Neural Rendering 插件能够接收到调用，再将结果复制回游戏输出。本项目基于其源码编译，并增加 ReShade 二次包装 D3D12 设备的兼容处理：创建内部设备时临时绕过 D3D12CreateDevice hook、还原原生 adapter，随后恢复 hook；具体见 LOCAL-CHANGES.md。
  • Genshin FPS Unlock：通过外部进程写入游戏帧率参数并启动游戏。本项目未改动其解锁算法，只将 unlockfps_nc.exe、UnlockerStub.dll 和配置写入流程整合进一键包。

三个项目的组合关系是：FSR Bridge 提供 DX11 的输入资源，OptiScaler 提供 DLSS4 兼容入口，DLSS5 DX11 Bridge 将请求转入 DLSS5，FPS Unlocker 负责按配置启动并解锁帧率。v1.3 不再加载最后一个 DLSS5 DX11 Bridge Add-on，而是在修改版 OptiScaler 的 DLSS-on-DX12 路径上接入前置 NR 插件。

一键包组件来源与替换说明

组件 使用版本 来源 本项目是否修改 能否自行替换
Dx11FsrBridge.dll v1.1、v1.3 Genshin FSR Bridge v1.3 沿用 v1.1 已验证二进制，本轮未修改 可以换成来源可信且接口/配置兼容的同用途构建
OptiScaler.dll v1.1 OptiScaler / OptiScaler DLSSNR fork v1.1 使用原有版本 可以，但必须匹配桥接接口和配置
OptiScaler.dll v1.3 OptiScaler DLSSNR fork；RTX 30 增量由修复包文档署名“华晓熊” 修改过源码：原生 DX12 NGX 参数交接、queue-affinity、FP16 双模式输出及 ReShade 私有 D3D12 修复 不要直接换成普通上游版；替换构建必须依次合入本仓库两个 patch
dlss5-dx11-bridge.addon64 仅 v1.1 DLSS5 DX11 Bridge 修改过源码：加入 ReShade/D3D12 兼容处理 不建议换成未包含本项目兼容修复的普通版
RenoDX DLSS5 Add-on 仅 v1.1 RenoDX 本项目没有改写其 NR 算法 可以换兼容版本；不要复制到 v1.3 造成双重 NR
nr-before-sr.zh-CN.addon64、RTX 50 nrchain_nvngx.dll 仅 v1.3 用户提供的 B站野生的装机宅 DLSS5-AI渲染超分版-RTX50.zip，署名 Bilibili UP 主“野生的装机宅” 二进制未修改；Mode 2 仅为初始默认值，Mode 1 已恢复；RTX30 使用同哈希稳定旧版 Add-on 避免 lifecycle 门禁闪烁 可以换兼容版本，但必须保留双模式资源契约、作者署名与声明
RTX 30 nrchain_nvngx.dll / Profile 仅 v1.3 DLSS5_GI_Ready_v1.2_PreNR_fixRTX30.zip，文档署名“华晓熊” 未修改所提供的 sidecar；本项目增加自动选择和不覆盖 Mode 的启动逻辑 必须与 RTX 30 RankFTW runtime 成套，不能和 RTX 50 sidecar 交叉
nvngx_dlss.dll、nvngx_dlssnr.dll v1.1、v1.3 NVIDIA NGX/DLSS 运行时；RTX 30 v1.3 兼容 runtime 来自 RankFTW SF-v2 二进制未修改；RTX 30 runtime 无数字签名且不提交 GitHub 可以从可信来源替换兼容版本，但必须匹配显卡代际、驱动、DLSS/NR 接口；不同 Profile 不要混用
ReShade64.dll v1.1、v1.3 ReShade Add-on 版本 二进制未修改，只调整搜索路径和加载配置 可以换兼容的 ReShade Add-on 版本；普通无 Add-on 构建不能代替
unlockfps_nc.exe、UnlockerStub.dll v1.1、v1.3 Genshin FPS Unlock 未修改解帧算法，只由一键脚本写入路径和 DLL 列表 可以从上游取得兼容版本替换，两个文件应成套并重新检查配置
HDR/ReShade shaders v1.1、v1.3 RenoDX、ReShade shader 上游及包内声明 本项目主要整合路径和预设 可以从上游更新；更新后自行确认 HDR 色彩空间与效果顺序

简单来说：表中标记为“二进制未修改”的 DLL，可以自行从官方、上游发布页或其他可信来源获取兼容版本替换，不必限定使用本仓库打包的同一份文件；替换前请核对 x64 架构、显卡代际、API/接口版本和 SHA-256，并保留旧文件以便回退。v1.3 的修改版 OptiScaler.dll、当前 add-on 与对应显卡 Profile 是一组兼容关键点；不能只覆盖其中一个文件后假定仍可用。

前置 NR 插件的完整署名、未修改文件哈希和第三方声明见 ATTRIBUTION.txt、THIRD_PARTY_NOTICES.txt 与 docs/REDISTRIBUTION.md。

历史版本：v1.2

v1.2 是前置 NR 超分实验版，现已由修复 RTX30 后端兼容、恢复双模式并改进一键启动的正式 v1.3 取代。以下链接仅用于历史回退，不作为当前推荐下载：

  • Google Drive 下载
  • 百度网盘下载（提取码：95ft）
  • 文件名：DLSS5_GI_Ready_v1.2_PreNR_RTX50_20260904.7z
  • SHA-256：BB0EF3E89BF37BC018DC6CA872590913AECE8FF37A672B84B76DC72EB4014F1F
  • 7z 解压密码：yuanshenqidong

旧版本：v1.0

如需兼容旧配置，可使用 v1.0。普通用户建议优先根据上方比较选择 v1.1 或 v1.3。

百度网盘提取码：ysqd；7z 解压密码：yuanshenqidong。

如果解压后缺少 UnlockerStub.dll，请从 GitHub 单独下载，放到解压包根目录，与 启动_DLSS5.bat、unlockfps_nc.exe 同级。只需补放这个文件，不要改名。

About

为原神提供一键 DLSS5 支持， 同时支持DLSS超分， unlockfps， reshade hdr组件

Topics

dlssdlss5genshingenshin-impacthdrreshadereshade-addonunlockfps

Resources

Readme
Activity

Stars

16 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages