RenoDX 安装配置教程：从克隆仓库到出 addon 文件，4 步完成
【免费下载链接】renodxRenovation Engine for DirectX Games项目地址: https://gitcode.com/GitHub_Trending/re/renodx
RenoDX（Renovation Engine for DirectX Games）是一套 DirectX 游戏 mod 工具集：替换着色器、注入缓冲区、叠加 overlay、升级 swapchain（游戏每帧画面输出用的显存缓冲）和纹理资源、把你的设置写回磁盘。它基于 Reshade 的插件系统工作，所以兼容性随 Reshade 走，不用自己折腾 DirectX hook（挂钩进游戏调用）。这篇 RenoDX 安装教程带你走完克隆、配工具链、CMake 构建，最后确认手里有可用的renodx-*.addon64文件。
装好 RenoDX 后你能改什么
- 换画面：把游戏的色调映射（tonemap）等后处理换成自己的实现，仓库里几百个游戏目录（
src/games/）就是现成的例子。 - 叠东西上去：往游戏画面上加 overlay、调试图层，不用动游戏代码。
- 升规格：把 32 位或老 API 的 swapchain、纹理资源升到更现代的状态，为 HDR 改造铺路。
- 写设置：把用户的 mod 选项落盘保存，下次启动自动生效。
环境检查清单：动手前 2 分钟确认一遍
| 项目 | 要求 | 确认方式 |
|---|---|---|
| 系统 | Windows | 在 PowerShell 里跑winver |
| Windows SDK | ≥ 10.0.26100.0 | winget list --id Microsoft.WindowsSDK |
| MSVC | VS 2022 Build Tools（v143 工具集） | where cl（在开发者终端里执行） |
| CMake | ≥ 3.23 | cmake --version |
| 构建后端 | Ninja + LLVM/Clang（clang-x64 预设用） | ninja --version、clang --version |
| Reshade | 任意可用版本，核心依赖 | 目标游戏目录里已有 reshade 文件 |
着色器编译工具（DXC ≥ 1.9.2602、Slang ≥ 2026.14.1、glslang ≥ 16.5.0、3Dmigoto ≥ 1.3.16）不用自己盯版本：下一步的环境脚本会自动装到仓库根目录的.\bin，版本单一来源在 cmake/tool-versions.cmake。
第 1 步：克隆仓库并补全子模块
做什么：拿到源码和全部第三方依赖。
git clone https://gitcode.com/gh_mirrors/re/renodx && cd renodx && git submodule update --init --recursiveexternal/下的 Reshade、Detours 等都是子模块，漏掉--init --recursive后面配置会直接失败。确认成功：external/reshade/里有内容。
第 2 步：一键拉齐工具链
做什么：让着色器编译器、Slang、glslang 都进.\bin。
powershell -ExecutionPolicy Bypass -File .\scripts\setup-dev-env.ps1 -Install不带-Install的默认运行只是预览，会报告找到的 Windows SDK 版本和工具链现状；加-Install才真正安装。确认成功：.\bin下出现dxc.exe、slangc.exe、glslang.exe等文件。
第 3 步：配置与构建出 addon
做什么：CMake 配置并编译 release 版本。
cmake --preset clang-x64 cmake --build --preset clang-x64-release配置阶段会自动扫描src/games/下每个游戏 mod 的.hlsl着色器和addon.cpp，把它们关联成各自的renodx-{游戏名}.addon64目标。确认成功：终端里打出 DXC/Slang/glslang 的实际版本号，且构建无 error。
装完怎么验证
- 打开
build输出目录，找到你要的那个renodx-{游戏名}.addon64（32 位游戏则是.addon32）。 - 用
cmake -P .\cmake\tool-versions.cmake对照一遍各工具最低版本，确认没有低于要求。 - 把 addon 文件放进游戏目录的 reshade 文件夹启动游戏：能加载、画面按 mod 效果变化，即通过。想先快速试水，也可以跑仓库附带的 FPS 限制器 addon。
常见问题速查
- CMake 报找不到 Clang 或 Ninja：
clang-x64预设依赖 clang-cl + Ninja Multi-Config，两个都要在 PATH 里；只装了 MSVC 就改用cmake --preset ninja-x64再构建ninja-x64-release。 - 提示工具版本过旧：直接跑
.\scripts\setup-dev-env.ps1 -Update升到配置版本，不用手动下包。 - 32 位游戏：改用
clang-x86预设并指定 target（如generic），产物是.addon32。 - 配置阶段只有 warning、没报版本：说明工具在
.\bin里没被找到，回到第 2 步确认-Install真的跑过了。
延伸阅读
- docs/CONTRIBUTING.md：完整环境要求与 devkit、MCP bridge（实时检查工具）构建说明
- src/shaders/：共享 HLSL 着色器库，理解 mod 如何改写画面从这里入手
- src/utils/：C++ 工具层，含 swapchain 代理、着色器注入等核心实现
现在你就有了一台随时能产出renodx-*.addon64的构建线，挑个src/games/里你正在玩的游戏开始改造吧。
【免费下载链接】renodxRenovation Engine for DirectX Games项目地址: https://gitcode.com/GitHub_Trending/re/renodx
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
