# GFX Debuggers<\/p>\n
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.
\nSupports both Linux and Windows, and should work with any version of Minecraft[citation needed], as long as Fabric was ported to it.
\nRequires Fabric Loader 0.14.0+ and Java 17+.<\/p>\n
### Usage<\/p>\n
1. Install Fabric.
\n2. Drop the mod into your mods folder
\n3. Launch the game, pick the debugger you want to use
\n4. Attach to the game process via your debugger of choice
\n5. Profit?<\/p>\n
### Advanced usage<\/p>\n
You can skip the dialog (useful for dev environments) by setting the `debugger` system property.
\nAllowed options are:
\n“`shell
\n-Ddebugger=nsight-frame # Launch with NSight Frame Debugger
\n-Ddebugger=nsight-gpu # Launch with NSight GPU Trace Profiler
\n-Ddebugger=renderdoc # Launch with RenderDoc
\n-Ddebugger=last # Re-use the last picked debugger and options
\n-Ddebugger=skip # Skip injection entirely, launch the game normally
\n“`<\/p>\n
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.<\/p>\n
### NSight Graphics configuration<\/p>\n
If the mod can’t find your NSight installation, you can tell it where `ngfx` is:<\/p>\n
Use **either** a JVM system property or an environment variable (the system property takes priority):<\/p>\n
| Method | Example |
\n|—|—|
\n| **System property** | `-Dngfx.path=C:Program FilesNVIDIA CorporationNsight Graphics 2025.5hostwindows-desktop-nomad-x64ngfx.exe` |
\n| **Environment variable** | `NGFX_PATH=C:Program FilesNVIDIA CorporationNsight Graphics 2025.5` |<\/p>\n
Both accept a direct path to the `ngfx` executable, an NSight Graphics installation root directory, or a directory containing the executable directly.<\/p>\n
#### Search paths<\/p>\n
**Windows:**
\n– `%ProgramFiles%NVIDIA CorporationNsight Graphics *hostwindows-desktop-nomad-x64ngfx.exe`
\n– `%ProgramFiles(x86)%NVIDIA CorporationNsight Graphics *hostwindows-desktop-nomad-x64ngfx.exe`<\/p>\n
**Linux:**
\n– `~\/nvidia\/NVIDIA-Nsight-Graphics-*\/host\/linux-desktop-nomad-x64\/ngfx`<\/p>\n
> 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.<\/p>\n
### RenderDoc configuration<\/p>\n
If the mod can’t find your RenderDoc installation, you can tell it where the library is:<\/p>\n
Use **either** a JVM system property or an environment variable (the system property takes priority):<\/p>\n
| Method | Example |
\n|—|—|
\n| **System property** | `-Drenderdoc.path=C:Program FilesRenderDoc` |
\n| **Environment variable** | `RENDERDOC_PATH=C:Program FilesRenderDoc` |<\/p>\n
Both accept either a direct path to the library file (`renderdoc.dll` \/ `librenderdoc.so`) **or** the directory containing it.<\/p>\n
On Linux, the legacy environment variable `RENDERDOC_LIB_PATH` (expects a direct path to `librenderdoc.so`) is still supported.<\/p>\n
#### Search paths<\/p>\n
**Windows**<\/p>\n
1. `-Drenderdoc.path` system property
\n2. `RENDERDOC_PATH` environment variable
\n3. `%ProgramFiles%RenderDocrenderdoc.dll`
\n4. Versioned folders in `%ProgramFiles%` (e.g. `RenderDoc v1.32`)
\n5. Same searches under `%ProgramFiles(x86)%`
\n6. `%USERPROFILE%RenderDocrenderdoc.dll`<\/p>\n
**Linux**<\/p>\n
1. `-Drenderdoc.path` system property
\n2. `RENDERDOC_PATH` environment variable
\n3. `RENDERDOC_LIB_PATH` environment variable (legacy)
\n4. Common system library paths (`\/usr\/lib64\/renderdoc\/`, `\/usr\/lib\/`, `\/usr\/lib\/x86_64-linux-gnu\/`, `\/usr\/local\/lib\/`, etc.)
\n5. `~\/.local\/lib\/librenderdoc.so`<\/p>\n
> 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.<\/p>\n","protected":false},"excerpt":{"rendered":"
Helps you inject graphics debuggers (NSight and Renderdoc) into Minecraft, without fiddling with launchers or JVM arguments.<\/p>\n","protected":false},"featured_media":75481,"template":"","meta":{"_minecraft_slug":"gfx-debuggers","_minecraft_project_id":"7eo1rzX8","_minecraft_author":"xirreal","_minecraft_license":"MIT","_minecraft_downloads":2066,"_minecraft_follows":25,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"gfx-debuggers.zip","_minecraft_size_bytes":30363813,"_minecraft_version_count":15,"_minecraft_updated_at":"2026-05-16T00:29:34.397647Z","_minecraft_date_created":"2024-05-06T04:05:10.625141Z","_minecraft_date_modified":"2026-03-26T10:14:39.535734Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gfx-debuggers","_minecraft_icon_attachment_id":75481,"_minecraft_imported_at":"2026-06-04T09:00:41+00:00","_minecraft_import_hash":"3377b6fcf3425a9081d925f73791f670","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,92],"mod_loader":[99],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83],"class_list":["post-75480","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-utility","mod_loader-fabric","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1"],"yoast_head":"\n