MWH-FSR

MHW-FSR：适用于《怪物猎人：世界》的 AMD FidelityFX FSR 3.1 与 4.1

**MHW-FSR** 是一个面向 [Stracker's Loader](https://www.nexusmods.com/monsterhunterworld/mods/1982) 的开源 DirectX 12 插件，为 *Monster Hunter: World*（v15.23）带来原生 **AMD FidelityFX FSR 3.1** 以及下一代 **FSR 4.1**（ML 超分辨率）支持。

通过拦截 MT Framework 在 DirectX 12 中的内部 TAA 通道和相机投影矩阵，本模组以现代 AMD FidelityFX 超分辨率取代了旧版 DLSS 1.0 实现。

---

## 亮点

- **全 GPU 支持**：可在 AMD Radeon（RDNA 1/2/3/4）、Intel Arc 和 NVIDIA GeForce GPU 上原生运行。
- **RDNA 3 与 4 的 FSR 4 ML 升级**：在 RDNA 3（例如 RX 7000 系列，如 RX 7700 XT）和 RDNA 4 GPU 上自动使用 AMD 的机器学习超分辨率（`FSR 4.1.1`），同时在更早的架构上提供高质量 **FSR 3.1.5** 时域超分辨率。
- **NativeAA（原生分辨率抗锯齿）**：以 100% 原生分辨率、清晰的 FSR 时域抗锯齿取代 MT Framework 模糊的旧版 TAA。
- **质量预设**：NativeAA、Quality（约 1.5 倍缩放）、Balanced（约 1.7 倍）、Performance（约 2.0 倍）以及自定义缩放。
- **内置 RCAS 锐化**：FidelityFX Robust Contrast-Adaptive Sharpening 直接集成到调度通道中。
- **零 NVIDIA 冗余**：100% 干净实现，不包含 NVNGX SDK 头文件或静态库。

---

## 要求

1. **Monster Hunter: World**（v15.23），以 **DirectX 12** 模式运行。 2. [Stracker's Loader](https://www.nexusmods.com/monsterhunterworld/mods/1982)（或任何支持 `nativePC\plugins\` 的加载器）。 3. Windows 10/11 64 位，并安装最新的显卡驱动。

---

## 安装

1. 下载或解压发行压缩包（`MHW-FSR-<version>.zip`）到你的游戏目录（`Monster Hunter World`）：
```
nativePC\plugins\MHW-FSR.dll
nativePC\plugins\MHW-FSR.ini
nativePC\plugins\MHW-FSR\amd_fidelityfx_loader_dx12.dll
nativePC\plugins\MHW-FSR\amd_fidelityfx_upscaler_dx12.dll
```
> **注意：** FSR 运行时二进制文件必须保留在 `nativePC\plugins\MHW-FSR\` 内。不要将它们直接放在 `plugins\` 中，因为 Stracker's Loader 会尝试将它们当作游戏模组处理。

2. 启动游戏。 3. 在 **Options -> Title Menu -> Display -> Advanced Graphics Settings** 中：
- 将 **DirectX 12 API** 设置为 **On**。
- 将 **NVIDIA DLSS** 设置为 **On**（插件会修补 UI 检查，以在 AMD/Intel 显卡上解锁此设置）。
- 将 **Image Quality** 设置为 **High**。

---

## 配置（`MHW-FSR.ini`）

`nativePC\plugins\MHW-FSR.ini` 文件在游戏运行时会自动热重载。

```ini
[General]
Enabled=1 ; 1 = 启用插件，0 = 完全禁用
LogLevel=Info ; Debug、Info、Warn 或 Error

[FSR]
; 预设：NativeAA、Quality、Balanced、Performance、UltraPerformance、Custom
QualityPreset=Quality

; 当 QualityPreset=Custom 时使用的自定义缩放（0.50 至 1.00）
RenderScale=1.0

; 超分后的 RCAS 锐度（0.0 至 1.0）。"Game" 表示跟随游戏内滑块
Sharpness=0.33

; 让 FSR 自动估算曝光（0 = 关闭，1 = 开启）
AutoExposure=0

; 超分器版本：Auto（检测最佳超分器，例如 RDNA 3/4 上的 FSR 4）、FSR 4、FSR 3.1 或十六进制 ID
Version=Auto

; FSR DLL 的自定义路径（留空则使用 nativePC\plugins\MHW-FSR\）
DLLPath=

; 仅限 NativeAA：绕过 FSR，以查看原版游戏 TAA 进行对比
Bypass=0
```

---

## 日志与诊断

详细日志写入：
```
nativePC\plugins\MHW-FSR.log
```
日志会显示检测到的 GPU、活动的 D3D12 设备、查询到的 FSR 版本、选择的超分器模型以及每帧的调度分辨率。