Files
airdef/docs/DLSS-TESTING.md
T
chexit 74baf8b4e2
build / mod (push) Failing after 29s
Document the libclang auto-install
The zero-step Windows+RTX toolchain now also covers libclang: LLVM is no
longer a build prerequisite, the detected or downloaded directory is
passed as LIBCLANG_PATH, and the cache layout gains
.horizon-cache/libclang/<version>/. Manual override (winget install
LLVM.LLVM + LIBCLANG_PATH) and the Unable to find libclang troubleshooting
note remain.

Co-Authored-By: Kimi Code <noreply@moonshot.ai>
2026-11-21 15:55:14 +03:00

11 KiB
Raw Blame History

Проверка DLSS SR на Windows / RTX

Это тестовая, а не релизная сборка #124. Она включает native DLSS Super Resolution через Vulkan и сохраняет обычный TAAU как fallback. Frame generation здесь нет; RTX 3060 его и не поддерживает.

Переключатель DLSS

В сборках с фичей dlss DLSS теперь включён по умолчанию, а не только через HORIZON_DLSS=1:

  • Меню мода: N → Огонь, ремонт, эффекты… → DLSS (NVIDIA). Строка показывает состояние; на устройстве без DLSS переключение — мягкий no-op («недоступен»), запрос сохраняется и применяется при следующем запуске, если устройство его поддерживает.
  • Команда контрольного сокета: dlss on|off|status (available — открыт ли DLSS-девайс, dlss — запрос игрока).
  • Настройка dlss:true|false в horizon-graphics.txt; HORIZON_DLSS=1|0 по-прежнему переопределяет её при старте.

Выключение переходит на native TAAU со следующего кадра: разделённые истории #137 делают переход чистым в обе стороны (NGX сбрасывается при возобновлении, первый native кадр не читает устаревшую историю). Включение после старта с выключенным DLSS применяется при следующем запуске — девайс открывается под DLSS только при старте. Разрешение рендера остаётся выбором игрока в настройках Horizon: масштаб 2/3 по умолчанию действует, только когда DLSS включён и реально доступен.

Для A/B ниже test-dlss.bat/test-native.bat работают как раньше; если старт был с DLSS, оба режима можно снять и одним прогоном через dlss off/dlss on без перезапуска.

Быстрый старт

  1. Один раз запусти обычный Horizon Launcher, чтобы он подготовил ресурсы Minecraft 26.3.

  2. Распакуй airdef-dlss-windows-x86_64.zip. Не удаляй nvngx_dlss.dll: он должен остаться рядом с horizon-client.exe. Если Windows сообщает об отсутствии MSVCP140.dll или VCRUNTIME140.dll, поставь Microsoft Visual C++ Redistributable 2015–2022 x64.

  3. Запусти **test-dlss.bat --world "Имя мира"**. Скрипт сам включит мод, HORIZON_DLSS=1` и GPU pass timing.

  4. В игре выполни одну и ту же последовательность:

    /airdef shader hd
    /airdef deploy radar_track
    /airdef deploy s400
    /airdef damage off
    /airdef wave shahed 8 300
    

    Подожди около 20 секунд, пока начнётся налёт. Для движущихся моделей подойдёт и /airdef move 2.

  5. Посмотри на ракеты/технику, сделай скриншот и запиши FPS/кадр. Не включай HORIZON_HD_DEBUG_MOTION при измерении качества или FPS.

  6. Выйди и запусти test-native.bat --world "Имя мира". Он использует TAAU с тем же масштабом 2/3 и тем же GPU timing. Повтори ту же сцену, ракурс и скриншоты.

Для честного A/B используй один мир и одну позицию камеры. Если налёт уже закончился, запусти следующий /airdef wave shahed 8 300. Не меняй разрешение окна или HD-настройки между прогонами.

Что подтверждает, что DLSS действительно включён

В %APPDATA%\horizon\logs\latest.log должна быть строка вроде:

DLSS Super Resolution: [1280, 720] -> [1920, 1080]

Не должно быть using native TAAU, FeatureNotSupported, no DLSS context или DLSS evaluation failed. Само наличие повышенного FPS не считается подтверждением backend.

Скрипты включают HORIZON_SHADER_PACK_TIMING=1, поэтому в лог попадают GPU pass timings. Сравнивай не только средний FPS, но и микрофризы, дым, вспышки и движущиеся ракеты.

Что прислать

  • %APPDATA%\horizon\logs\latest.log после DLSS-прогона.
  • Скриншоты одного ракурса с DLSS и native TAAU, желательно с движущейся техникой/ракетой и отдельно с дымом.
  • Скриншот FPS/debug overlay обоих режимов или текстовые значения FPS.
  • Если есть артефакты: кратко, что именно не так и меняется ли оно при движении камеры.
  • Сохранения миров присылать не нужно.

Если игра не запускается

  • Сначала проверь, что nvngx_dlss.dll лежит рядом с horizon-client.exe и ресурсы подготовлены лаунчером.
  • При ошибке про Vulkan/NGX пришли latest.log: там должна быть конкретная причина. Не подменяй её догадкой про драйвер.
  • При FeatureNotSupported или другом сбое игра должна продолжить работу через native TAAU; это будет видно в логе. Такой запуск не является успешным тестом DLSS.
  • test-native.bat нужен только для сравнения; он не включает DLSS.

Сборка самостоятельно вместо готового архива

Нужны только Rust (с x86_64-pc-windows-msvc и wasm32-unknown-unknown) и Visual Studio Build Tools с C++. Ветка — kimi-work.

NVIDIA DLSS SDK, Vulkan SDK и LLVM ставить вручную больше не нужно: на Windows с NVIDIA RTX airdef.py сам скачивает всё, что читает dlss_wgpu при сборке (включая libclang.dll для bindgen), и кладёт nvngx_dlss.dll рядом с horizon-client.exe.

git clone --branch kimi-work https://gitea.maoniao.team/chexit/airdef.git
cd airdef
rustup target add x86_64-pc-windows-msvc wasm32-unknown-unknown
py tools\airdef.py all

all делает fork, game, mod, install. На Windows + RTX шаг game:

  1. Определяет новейший стабильный тег v310.9.x в NVIDIA/DLSS через GitHub API; при недоступности API берёт закреплённый v310.9.1.
  2. Скачивает выборочно (не весь репозиторий): include/*.h, lib/Windows_x86_64/x64/nvsdk_ngx_d.lib и nvsdk_ngx_s.lib, lib/Windows_x86_64/rel/nvngx_dlss.dll (~59 МБ). Итог — около 67 МБ один раз.
  3. Скачивает только заголовки KhronosGroup/Vulkan-Headers в Include/: полный LunarG SDK не нужен, build.rs линкует Vulkan сам.
  4. Ищет уже установленный libclang.dll (LIBCLANG_PATH, PATH, C:\Program Files\LLVM\bin, LLVM из Visual Studio). Если его нет — скачивает NuGet-пакет libclang.runtime.win-x64 (~34 МБ) и распаковывает из него только runtimes/win-x64/native/libclang.dll.
  5. Собирает с --features mods,dlss, передавая DLSS_SDK, VULKAN_SDK и LIBCLANG_PATH в окружение cargo, затем копирует свежий nvngx_dlss.dll рядом с собранным horizon-client.exe.

Кэш и повторные сборки:

.horizon-cache/dlss-sdk/<tag>/        include/ + lib/Windows_x86_64/{x64,rel} + airdef-install.json
.horizon-cache/vulkan-headers/<tag>/  Include/vulkan/ + Include/vk_video/ + airdef-install.json
.horizon-cache/libclang/<version>/    libclang.dll + airdef-install.json

Повторный запуск видит маркер и полный набор файлов и ничего не скачивает. Удалить кэш можно целиком — при следующей сборке он появится снова.

Ручное переопределение по-прежнему работает и имеет приоритет: если задать DLSS_SDK (корень с include/nvsdk_ngx*.h и lib/Windows_x86_64/x64/), VULKAN_SDK (с Include/vulkan/vulkan.h) и/или LIBCLANG_PATH (каталог с libclang.dll), автоскачивание для этого компонента не выполняется. Если явный путь неполный, airdef.py предупреждает и собирает mods; чтобы вернуть автоскачивание, убери переменную.

Ручная альтернатива для libclang: winget install LLVM.LLVM, затем задать LIBCLANG_PATH на каталог bin установленного LLVM (там лежит libclang.dll).

При любой сетевой ошибке, недоступном GitHub/nuget.org, неполном скачивании или если libclang так и не нашёлся, сборка не падает: печатается предупреждение, ставится --features mods, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу mods.

Если bindgen всё же пишет Unable to find libclang, проверь LIBCLANG_PATH: он должен указывать на каталог, в котором лежит libclang.dll (не на сам файл). Удобно один раз выполнить winget install LLVM.LLVM и указать C:\Program Files\LLVM\bin.

Если nvngx_dlss.dll нужен отдельно (например, для ручной раскладки), он лежит в кэше: .horizon-cache/dlss-sdk/<tag>/lib/Windows_x86_64/rel/nvngx_dlss.dll. Его версия совпадает с самым новым тегом, который нашёл airdef.py.