Files
airdef/docs/DLSS-TESTING.md
T
chexit e85e7a18d0 DLSS on/off toggle in the mod settings, persisted per world
The More page (N → Огонь, ремонт, эффекты…) gains a DLSS row next to
Акустика. Default on: a world without a saved choice leaves the engine's
own default (on where supported). The row reads render.dlss-status (API
level 33): with a DLSS device it toggles live; without one it says
«недоступен», and an on-request is kept and applied at the next launch —
a graceful no-op, never an error. The request is saved in the world's
layout (`dlss true|false`, older saves load unchanged) and re-applied on
world load; the engine persists it in horizon-graphics.txt for the next
start's device opening. /airdef capabilities reports the DLSS state too.

Graphics-only: no resolution control (the player's own Horizon settings
stay in charge) and no sim changes. Engine gitlink → b2cc11c45
(agent/dlss-toggle): the dlss graphics setting, the live evaluation gate,
the dlss control command and the level-33 SDK imports.

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

7.5 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.

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

Нужны Visual Studio Build Tools с C++, Rust, clang, Vulkan SDK и NVIDIA DLSS SDK v310.9.1. Ветка — kimi-work.

python3 tools/airdef.py game сам добавляет dlss к features на Windows с NVIDIA RTX, если заданы DLSS_SDK и VULKAN_SDK; без них он предупреждает и собирает только mods. Ручная сборка ниже делает то же самое явно.

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
$env:DLSS_SDK = "C:\path\to\DLSS"
$env:VULKAN_SDK = "C:\path\to\VulkanSDK"
cargo build --manifest-path horizon/Cargo.toml -p horizon-client --target x86_64-pc-windows-msvc --features "mods,dlss"
py tools\airdef.py mod

Скопируй horizon/target/x86_64-pc-windows-msvc/debug/horizon-client.exe, airdef-mod/target/horizon-mod/airdef.hmod, dist/play.bat, dist/test-dlss.bat, dist/test-native.bat и $env:DLSS_SDK/lib/Windows_x86_64/rel/nvngx_dlss.dll в одну папку. Для реальной игры нужен и latest.log с фактическим backend/кадрами.