DLSS FSR 缩放

免责声明

在下定论之前：此模组并非“只是 OptiScaler”。
DLSS 实现、渲染挂钩、分辨率缩放逻辑、Unity 集成以及整体框架均属于此模组。OptiScaler 完全可选。如果您只想使用原生 NVIDIA DLSS，则完全不需要 OptiScaler。
支持 OptiScaler 仅仅是为了在不支持原生 DLSS 的硬件上提供与其他缩放器（如 FSR、XeSS 或其他特定供应商解决方案）的兼容性。它通过挂接此模组暴露的接口来工作，并不替代或实现核心功能。
没有此模组的渲染管线与挂钩，OptiScaler 在《英灵神殿》中便无从附着。它仅仅是通过将我开发的 DLSS 接口转译到其他缩放器来扩展兼容性。


# 安装指南 - 英灵神殿缩放器模组

本包中的模组 DLL 已按正确的文件夹结构排列好。你只需要下载 BepInEx、Streamline 和 OptiScaler。

## 下载

1. **BepInEx 5.4.x (x64)**
2. **Streamline v2.12.0**：[NVIDIA-RTX/Streamline 发布页面](https://github.com/NVIDIA-RTX/Streamline/releases) — 所有必需文件都在 `bin/x64/` 目录下：`sl.*` 插件、`nvngx_dlss.dll` 和 `nvngx_dlssg.dll`
3. **OptiScaler**：[最新版本](https://github.com/optiscaler/OptiScaler/releases) — 拦截模组的 DLSS 调用；后端（DLSS / FSR 3.1 / XeSS / FSR4）在其覆盖层中选择


## 安装

### 步骤 1：安装 BepInEx
1. 将 BepInEx zip 压缩包解压到《英灵神殿》安装文件夹中。
2. 运行游戏一次，然后关闭。

### 步骤 2：安装模组文件
将 `dlss-mod-rel` 文件夹中的内容拖拽到你的《英灵神殿》安装目录中，并在提示时允许 Windows 合并和覆盖文件。

### 步骤 3：Streamline 文件
来自 Streamline 发行版的 `bin/x64/` 目录：

1. 将 `nvngx_dlss.dll` 复制到 `valheim.exe` 旁边（作为缩放后端暴露 DLSS）。
2. 将 `nvngx_dlssg.dll` 复制到 `valheim.exe` 旁边。
3. 帧生成 & Reflex：将 `sl.common.dll`、`sl.pcl.dll`、`sl.reflex.dll`、`sl.dlss.dll`、`sl.dlss_g.dll`、`sl.interposer.dll` 复制到 `<英灵神殿安装目录>\sl_plugins\` 中。此路径仅限 NVIDIA；

警告：所有 Streamline 文件都是必需的，且必须来自同一个发行版本。混合版本或缺少文件可能导致模组无法初始化。

### 步骤 4：安装 OptiScaler
通过将 OptiScaler 放置在游戏目录中并运行 `setup_windows.bat` 来安装它。

### 步骤 5：Steam 启动选项
右键点击《英灵神殿》 -> 属性 -> 通用 -> 启动选项：`-force-d3d12`


## 首次启动与验证

1. 通过 Steam 启动《英灵神殿》并加载进入一个世界（模组在菜单中不活动）。
2. 设置 -> 图像 -> 将**渲染比例**设置为低于 100%（例如 75%）。在 100% 时，缩放器保持休眠状态。
3. 按 **Insert** 键打开 OptiScaler 覆盖层并选择一个后端（NVIDIA 默认使用 DLSS）。
4. **F7** 键切换缩放器的开/关；**F3** 键打开模组菜单。
5. 帧生成：在覆盖层中设置 **FG Input = DLSSG (via Streamline)**，**FG Output = FSR-FG / XeFG**，启用 **HUDfix**，使用 **End** 键切换。
6. AMD/Intel 上的帧生成：Streamline 路径仅限 NVIDIA，但 OptiScaler 自身的帧生成在任何供应商的硬件上都有效——将 **FG Input = OptiFG (Upscaler)** 代替，其他 FG Output/HUDfix 设置相同。
7. NVIDIA Reflex：你可以通过 F3 模组菜单动态地切换 Reflex。


模组使用游戏的 3D 分辨率限制

## 快捷键

| 按键 | 功能 |
|---|---|
| **F3** | 缩放器菜单 — 选择首选缩放器（下次启动时生效）或实时通过滑块选择，设置质量模式，切换帧生成，配置 NVIDIA Reflex，查看帧生成状态和完整的快捷键列表 |
| **F7** | 切换缩放器开/关（A/B 对比原生渲染） |
| **F11** | 切换 DLSS-G 帧生成（实验性，仅在 NVIDIA 上测试过；同时也需要在 OptiScaler 覆盖层中启用 **FrameGen Enabled** + **FG Input = DLSSG**） |
| **Insert** / **End** | OptiScaler 覆盖层 / OptiScaler 帧生成切换 |


## 最终文件放置

在你的《英灵神殿》安装目录中：

```
<英灵神殿安装目录>\
├── valheim.exe
├── dxgi.dll <-- OptiScaler
├── nvngx_dlss.dll <-- 来自 Streamline bin/x64
├── nvngx_dlssg.dll <-- 来自 Streamline bin/x64
├── sl_plugins\ <-- Streamline 插件，全部来自同一个构建版本
│ ├── sl.common.dll
│ ├── sl.pcl.dll
│ ├── sl.reflex.dll
│ ├── sl.interposer.dll
│ ├── sl.dlss.dll
│ └── sl.dlss_g.dll
│
├── BepInEx\
│ └── plugins\
│ └── ValheimUpscalerRecon\
│ └── ValheimUpscaler.Recon.dll
└── valheim_Data\
└── Plugins\
└── x86_64\
└── ValheimUpscalerNative.dll
```

Vulkan 支持

此模组可在无需任何启动参数的情况下在 Vulkan 下运行。
在 Vulkan 下，只有 FSR 和 XeSS 可用作缩放器。DLSS 不被支持，因为它依赖于 D3D12 NGX 管线。
设置（Vulkan）

在 Vulkan 模式下正常启动游戏
从游戏目录中移除以下文件：

nvngx_dlss.dll

nvngx_dlssg.dll


在 Vulkan 下保留真实的 DLSS DLL 会导致启动崩溃，因为 Vulkan 不使用 NGX DLSS 路径，模组期望这些文件不存在。
按照步骤 4 中的描述安装 OptiScaler
这充当了拦截层，转发 NGX 调用并暴露 FSR 和 XeSS。

游戏内使用

启动游戏并加载进入一个世界
将渲染比例设置在 100% 以下
按

Insert

键打开覆盖层
选择 FSR 或 XeSS

帧生成说明

在 Vulkan 下，帧生成仅限于 OptiFG（OptiScaler 帧生成）
Streamline / DLSS-G 管线仅限 D3D12，在 Vulkan 下不可用


常见问题

是否需要 OptiScaler？
不需要。如果你使用的是 NVIDIA RTX GPU，并且只需要原生 DLSS，那么不需要 OptiScaler。该模组包含自己的 DLSS 实现，可以独立运行。

那为什么要支持 OptiScaler？
OptiScaler 作为一个可选的兼容层得到支持。它允许使用非 NVIDIA 硬件、或偏好其他缩放器的用户，通过挂接此模组暴露的接口来使用 XeSS 或 FSR 等技术。

如果 Streamline 无法工作，我有哪些选择？
如果 NVIDIA Streamline 在你的系统上无法正常工作，你可以使用以下替代方案之一：

使用 Nukem 的桥接器配合 XeSS 或 FSR。
使用 OptiFG 配合 XeSS 或 FSR。

这些提供了替代的兼容性路径，同时仍然使用此模组暴露的渲染挂钩。

这个模组只是捆绑了 OptiScaler 吗？
不是。渲染挂钩、Unity 集成、动态分辨率逻辑、DLSS 实现以及渲染管线都由本模组实现。对外部兼容层的可选支持并不代表这些外部组件就是实现本身。

这个模组会使用游戏内置的 TAA 吗？
不会。此模组完全禁用了《英灵神殿》的内部 TAA。图像重建完全由选定的缩放器（如原生 DLSS、XeSS 或 FSR）处理，从而从渲染管线中移除了游戏的时间性抗锯齿。

我不喜欢这个模组 / 我不需要它。
如果这个模组不适合你，没有什么需要配置或争论的，不使用它即可。你可以关闭此页面，并以游戏的默认状态继续游玩。