74baf8b4e2
build / mod (push) Failing after 29s
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>
105 lines
11 KiB
Markdown
105 lines
11 KiB
Markdown
# Проверка 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. В игре выполни одну и ту же последовательность:
|
||
|
||
```text
|
||
/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` должна быть строка вроде:
|
||
|
||
```text
|
||
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`.
|
||
|
||
```powershell
|
||
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](https://github.com/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](https://github.com/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`](https://www.nuget.org/packages/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`.
|
||
|
||
Кэш и повторные сборки:
|
||
|
||
```text
|
||
.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`.
|