GFX-Debuggers (NSight and Renderdoc Injector)

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   # Запуск с 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, либо переменную окружения (системное свойство имеет приоритет):

Оба принимают прямой путь к исполняемому файлу 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, либо переменную окружения (системное свойство имеет приоритет):

Оба принимают либо прямой путь к файлу библиотеки (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, процесс завершится и инъекция не произойдёт. Всё должно логироваться, если что-то пойдёт не так, поэтому проверяйте логи при возникновении проблем.