GFX-Debuggers (NSight and Renderdoc Injector)

模组

· 作者 xirreal

帮助你向 Minecraft 注入图形调试器(NSight 和 Renderdoc),无需折腾启动器或 JVM 参数。

0 本站下载 0 关注 更新于 7 个月前

最新 3.2.0 · 26.3 · Fabric

一键开服(送7天)

GFX Debuggers

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

用法

  1. 安装 Fabric。
  2. 将模组放入你的 mods 文件夹
  3. 启动游戏,选择你要使用的调试器
  4. 通过你选择的调试器附加到游戏进程
  5. 获利?

高级用法

你可以通过设置 debugger 系统属性来跳过对话框(对开发环境很有用)。 允许的选项如下:

-Ddebugger=nsight-frame   # 使用 NSight Frame Debugger 启动
-Ddebugger=nsight-gpu     # 使用 NSight GPU Trace Profiler 启动
-Ddebugger=renderdoc      # 使用 RenderDoc 启动
-Ddebugger=last           # 重用上次选择的调试器和选项
-Ddebugger=skip           # 完全跳过注入,正常启动游戏

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,它将退出并不会进行注入。如果出现问题,所有内容都会被记录,因此如有问题请检查日志。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源