GFX-调试器（NSight 和 Renderdoc 注入器）

GFX-调试器（NSight 和 Renderdoc 注入器）

帮助你将图形调试器（NSight和Renderdoc）注入Minecraft，无需折腾启动器或JVM参数。

工具

GFX-调试器（NSight 和 Renderdoc 注入器）预览查看大图

GFX Debuggers

这个与版本无关的 Fabric 模组允许你将 NSight 或 Renderdoc 注入到 Minecraft 中，而无需折腾启动器、参数或环境变量。启动时，它会询问你想要附加哪个调试器，关闭对话框即可跳过注入。 支持 Linux 和 Windows，并且应该适用于任何版本的 Minecraft[citation needed]，只要 Fabric 已移植到该版本。 需要 Fabric Loader 0.14.0+ 和 Java 17+。

用法

  1. 安装 Fabric。
  2. 将模组放入你的 mods 文件夹
  3. 启动游戏，选择你想要使用的调试器
  4. 通过你选择的调试器附加到游戏进程
  5. 完事大吉？

高级用法

你可以通过设置 debugger 系统属性来跳过对话框（对开发环境很有用）。 允许的选项有：

-Ddebugger=nsight-frame   # Launch with NSight Frame Debugger
-Ddebugger=nsight-gpu     # Launch with NSight GPU Trace Profiler
-Ddebugger=renderdoc      # Launch with RenderDoc
-Ddebugger=last           # Re-use the last picked debugger and options
-Ddebugger=skip           # Skip injection entirely, launch the game normally

last 选项会从选择器对话框中读取已保存的配置（存储在 .minecraft/config/gfx-debuggers.properties），包括所选的调试器、平台以及任何 GPU Trace 选项。如果不存在已保存的配置，则会回退到显示选择器对话框。

NSight Graphics 配置

如果模组找不到你的 NSight 安装位置，你可以告诉它 ngfx 在哪里：

使用 JVM 系统属性或环境变量之一（系统属性优先）：

方式 示例
系统属性 -Dngfx.path=C:\Program Files\NVIDIA Corporation\Nsight Graphics 2025.5\host\windows-desktop-nomad-x64\ngfx.exe
环境变量 NGFX_PATH=C:\Program Files\NVIDIA Corporation\Nsight Graphics 2025.5

两者都接受 ngfx 可执行文件的直接路径、NSight Graphics 安装根目录，或直接包含该可执行文件的目录。

搜索路径

Windows：

  • %ProgramFiles%\NVIDIA Corporation\Nsight Graphics *\host\windows-desktop-nomad-x64\ngfx.exe
  • %ProgramFiles(x86)%\NVIDIA Corporation\Nsight Graphics *\host\windows-desktop-nomad-x64\ngfx.exe

Linux：

  • ~/nvidia/NVIDIA-Nsight-Graphics-*/host/linux-desktop-nomad-x64/ngfx

NSight 有点难找，因为很多人将它安装在不同的硬盘上，而且在 Linux 上，除了 ~/nvidia/ 之外它并没有真正标准的位置。当找到多个安装时，优先使用最新版本。如果你遇到问题，请查看日志以了解它在查找哪里，并在需要时手动添加路径。

RenderDoc 配置

如果模组找不到你的 RenderDoc 安装位置，你可以告诉它库在哪里：

使用 JVM 系统属性或环境变量之一（系统属性优先）：

方式 示例
系统属性 -Drenderdoc.path=C:\Program Files\RenderDoc
环境变量 RENDERDOC_PATH=C:\Program Files\RenderDoc

两者都接受库文件的直接路径（renderdoc.dll / librenderdoc.so）或包含它的目录。

在 Linux 上，仍然支持旧版环境变量 RENDERDOC_LIB_PATH（期望 librenderdoc.so 的直接路径）。

搜索路径

Windows

  1. -Drenderdoc.path 系统属性
  2. RENDERDOC_PATH 环境变量
  3. %ProgramFiles%\RenderDoc\renderdoc.dll
  4. %ProgramFiles% 中的带版本号的文件夹（例如 RenderDoc v1.32）
  5. 在 %ProgramFiles(x86)% 下进行相同的搜索
  6. %USERPROFILE%\RenderDoc\renderdoc.dll

Linux

  1. -Drenderdoc.path 系统属性
  2. RENDERDOC_PATH 环境变量
  3. RENDERDOC_LIB_PATH 环境变量（旧版）
  4. 常见的系统库路径（/usr/lib64/renderdoc/、/usr/lib/、/usr/lib/x86_64-linux-gnu/、/usr/local/lib/ 等）
  5. ~/.local/lib/librenderdoc.so

路径按列出的顺序搜索，并使用找到的第一个有效库。如果找不到有效的 .dll/.so，它将放弃并且不会注入。如果出现任何问题，一切都应该被记录到日志中，所以如果你遇到问题，请查看日志。