GFX Debuggers
这个版本无关的 Fabric 模组允许你向 Minecraft 注入 NSight 或 Renderdoc,无需再摆弄启动器、参数或环境变量。在启动时,它会询问你要附加哪个调试器,关闭对话框即可跳过注入。 支持 Linux 和 Windows,并且只要 Fabric 已移植到该版本,应该适用于任何版本的 Minecraft[citation needed]。 需要 Fabric Loader 0.14.0+ 和 Java 17+。
用法
- 安装 Fabric。
- 将模组放入你的 mods 文件夹
- 启动游戏,选择你要使用的调试器
- 通过你选择的调试器附加到游戏进程
- 获利?
高级用法
你可以通过设置 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
-Drenderdoc.path系统属性RENDERDOC_PATH环境变量%ProgramFiles%\RenderDoc\renderdoc.dll%ProgramFiles%中的版本化文件夹(例如RenderDoc v1.32)- 在
%ProgramFiles(x86)%下执行相同的搜索 %USERPROFILE%\RenderDoc\renderdoc.dll
Linux
-Drenderdoc.path系统属性RENDERDOC_PATH环境变量RENDERDOC_LIB_PATH环境变量(遗留)- 常见的系统库路径(
/usr/lib64/renderdoc/、/usr/lib/、/usr/lib/x86_64-linux-gnu/、/usr/local/lib/等) ~/.local/lib/librenderdoc.so
按照列出的顺序搜索路径,并使用找到的第一个有效库。如果找不到有效的 .dll/.so,它将退出并不会进行注入。如果出现问题,所有内容都会被记录,因此如有问题请检查日志。
GFX Debuggers
This version-agnostic Fabric mod allows you to inject NSight or Renderdoc into Minecraft, without having to fiddle around with launchers, args or environment variables. At launch, it will ask you which debugger you want to attach, and injection can be skipped by closing the dialog. Supports both Linux and Windows, and should work with any version of Minecraft[citation needed], as long as Fabric was ported to it. Requires Fabric Loader 0.14.0+ and Java 17+.
Usage
- Install Fabric.
- Drop the mod into your mods folder
- Launch the game, pick the debugger you want to use
- Attach to the game process via your debugger of choice
- Profit?
Advanced usage
You can skip the dialog (useful for dev environments) by setting the debugger system property.
Allowed options are:
-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
The last option reads the saved configuration from the picker dialog (stored in .minecraft/config/gfx-debuggers.properties), including the selected debugger, platform, and any GPU Trace options. If no saved config exists, it falls back to showing the picker dialog.
NSight Graphics configuration
If the mod can't find your NSight installation, you can tell it where ngfx is:
Use either a JVM system property or an environment variable (the system property takes priority):
| Method | Example |
|---|---|
| System property | -Dngfx.path=C:\Program Files\NVIDIA Corporation\Nsight Graphics 2025.5\host\windows-desktop-nomad-x64\ngfx.exe |
| Environment variable | NGFX_PATH=C:\Program Files\NVIDIA Corporation\Nsight Graphics 2025.5 |
Both accept a direct path to the ngfx executable, an NSight Graphics installation root directory, or a directory containing the executable directly.
Search paths
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 is kind of a pain to find, as many people install it on different drives and on linux it doesn't really have a standard location outside
~/nvidia/. The newest version is preferred when multiple installations are found. If you have issues, check the logs to see where it's looking and add the path manually if needed.
RenderDoc configuration
If the mod can't find your RenderDoc installation, you can tell it where the library is:
Use either a JVM system property or an environment variable (the system property takes priority):
| Method | Example |
|---|---|
| System property | -Drenderdoc.path=C:\Program Files\RenderDoc |
| Environment variable | RENDERDOC_PATH=C:\Program Files\RenderDoc |
Both accept either a direct path to the library file (renderdoc.dll / librenderdoc.so) or the directory containing it.
On Linux, the legacy environment variable RENDERDOC_LIB_PATH (expects a direct path to librenderdoc.so) is still supported.
Search paths
Windows
-Drenderdoc.pathsystem propertyRENDERDOC_PATHenvironment variable%ProgramFiles%\RenderDoc\renderdoc.dll- Versioned folders in
%ProgramFiles%(e.g.RenderDoc v1.32) - Same searches under
%ProgramFiles(x86)% %USERPROFILE%\RenderDoc\renderdoc.dll
Linux
-Drenderdoc.pathsystem propertyRENDERDOC_PATHenvironment variableRENDERDOC_LIB_PATHenvironment variable (legacy)- Common system library paths (
/usr/lib64/renderdoc/,/usr/lib/,/usr/lib/x86_64-linux-gnu/,/usr/local/lib/, etc.) ~/.local/lib/librenderdoc.so
Paths are searched in the order listed, and the first valid library found is used. If it can't find a valid .dll/.so, it will bail out and won't inject. Everything should be logged if anything goes wrong, so check the logs if you have issues.
下载 GFX-Debuggers (NSight and Renderdoc Injector)
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 GFX-Debuggers (NSight and Renderdoc Injector)
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 支持 NSight 2026.1
- 新增标志,可完全跳过注入或无需询问直接使用上次选择的选项
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
AE2:一款流行的自动化与存储模组
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
评论 0
登录后参与评分
还没有评论,来抢沙发吧