- Windows 10/11 x64 и GPU-драйвер с поддержкой Vulkan (графический API, на котором держится рендер в проекте)
- Git
- Компилятор C++ и система сборки — точный список зависимостей смотрите в README репозитория ryderclanky/BotW-Native, он может отличаться от типового
- Vulkan SDK — ради утилиты vulkaninfo для проверки драйвера
- Ваша собственная копия The Legend of Zelda: Breath of the Wild для Wii U версии 1.5.0: игровых ассетов в поставке нет, файлы игры подкладывает пользователь

vulkaninfo.Пример: до начала работ проверьте, что Git вообще доступен в PowerShell:
git --version
Ожидаемый вывод — строка вида git version 2.xx.x.windows.1. Если команда не найдена, установите Git и перезапустите терминал (новый PATH подхватывается только в новом процессе).
Почему это работает: BotW-Native — это статическая рекомпиляция, то есть машинный код Wii U-версии один раз переведён в нативное приложение под Windows. Эмулятор не запускается, поэтому критичны не «настройки эмуляции», а корректная сборка бинарника и наличие файлов игры.
Что сделать: убедиться, что драйвер поддерживает Vulkan, и склонировать репозиторий.
Зачем: без рабочего Vulkan-драйвера приложение не сможет инициализировать рендер, а сборка без исходников невозможна.
Как проверить: обе команды ниже должны отработать без ошибок.
Проверка Vulkan (утилита ставится вместе с Vulkan SDK):
vulkaninfo --summary
Ожидаемый результат: блок с именем вашего GPU и версией Vulkan API. Если команда не найдена — SDK не установлен или не добавлен в PATH; если утилита падает с сообщением об отсутствии ICD, проблема в драйвере.
Резервная проверка железа, если vulkaninfo недоступен:
Get-CimInstance Win32_VideoController | Select-Object Name, DriverVersion
Пример: вывод вида Name: NVIDIA GeForce RTX ..., DriverVersion: 5xx.xx — драйвер определяется. Дальше сравните DriverVersion с версией на сайте производителя; если она старше — обновите.
Клонирование:
cd C:\dev
git clone https://github.com/ryderclanky/BotW-Native.git
cd BotW-Native
Get-ChildItem
Ожидаемый результат: в каталоге появились файлы проекта (README, исходники, файлы сборки). Имя владельца и репозитория — ryderclanky/BotW-Native, как указано в посте канала.
Почему это работает: git clone забирает полный набор исходников и истории; сборка идёт локально, поэтому никаких сетевых зависимостей на этапе компиляции, кроме уже скачанных библиотек, не остаётся.

Что сделать: собрать нативный бинарник и положить в нужный каталог файлы игры v1.5.0.
Зачем: репозиторий содержит код, но не ассеты; приложение без файлов игры запустится и упадёт на этапе загрузки контента.
Как проверить: сборка завершается без ошибок, рядом с бинарником появляется ожидаемая структура каталогов, а при запуске нет сообщения об отсутствии игровых данных.
Сначала прочитайте README репозитория — там указаны точные зависимости и команды сборки. Типовой цикл для C++/Vulkan-проекта выглядит так (флаги сверьте с документацией):
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
Пример: при успехе последний вывод содержит строки вида -- Build files have been written to: C:/dev/BotW-Native/build, а в build появляется исполняемый файл. Точное имя .exe и путь к нему зависят от настроек проекта — сверьтесь с документацией.
Далее — ассеты. Копируйте файлы из своей копии игры в каталог, который описан в README (обычно рядом с .exe или в отдельной папке content/data; конкретное имя в посте не приводится — сверьтесь с документацией).
Чек-лист перед первым запуском:
vulkaninfo --summary показывает ваш GPU и версию VulkanПочему это работает: рекомпилированный код обращается к тем же данным, что и оригинальная Wii U-версия, поэтому версия контента должна совпадать — подмена файлов от другой версии ломает загрузку ресурсов.

Что сделать: запустить собранное приложение и убедиться, что игра стартует на Vulkan.
Зачем: это финальная проверка всей цепочки: драйвер → сборка → ассеты.
Как проверить: появляется окно игры, а не консоль с ошибкой; в Диспетчере задач процесс потребляет GPU.
cd C:\dev\BotW-Native\build
.\BotW-Native.exe
Пример: на экране появляется окно с игровым рендером (заставка/меню Breath of the Wild), в Диспетчере задач на вкладке «Производительность» загрузка GPU выше нуля. Если окно мгновенно закрывается — смотрите раздел с проблемами ниже.
Дополнительно проверьте, что рендер идёт именно через Vulkan-драйвер, а не через программный fallback: повторный vulkaninfo --summary должен показывать тот же дискретный GPU, к которому подключён монитор.
Почему это работает: приложение — обычный Windows-процесс, поэтому все симптомы (нет окна, чёрный экран, падение на старте) диагностируются стандартными средствами: консольным выводом и мониторингом GPU.
Проблема. Приложение падает сразу при старте, окно не появляется
ошибка вида "Failed to create Vulkan instance" / vkCreateInstance failedvulkaninfo --summary. Если утилита показывает только программный рендерер (lavapipe/llvmpipe), переключите монитор на дискретный GPU или задайте его основным в настройках графики Windows.Проблема. Игра стартует, но сразу завершается с сообщением об отсутствии данных
ошибка вида "Game files not found" / сообщение о ненайденных ресурсах в логеGet-ChildItem -Recurse -Depth 2 | Select-Object FullName
Команда покажет фактическую структуру каталогов — сравните её с описанной в документации. Убедитесь, что используете Wii U-версию 1.5.0.
Проблема. Сборка не находит компилятор C++
ошибка вида "CMake Error: Could not find any instance of Visual Studio" или No CMAKE_CXX_COMPILER could be foundcmake -S . -B build -DCMAKE_BUILD_TYPE=Release
Каталог build при повторной конфигурации можно не удалять, но при смене toolchain его лучше очистить.
Проект ryderclanky/BotW-Native превращает Wii U-код Breath of the Wild 1.5.0 в нативное Windows-приложение на Vulkan, но файлы игры вы готовите сами. Если хочется посмотреть, как аналогично устроены другие порты и рекомпиляции, разбор есть в гайде Как запустить Metal Gear Solid 2 HD и другие порты NVIDIA SHIELD на Android: установка и настройка.
BotW-Native — это эмулятор?
Нет. Это статическая рекомпиляция: код Wii U-версии Breath of the Wild 1.5.0 переведён в нативное приложение Windows, эмулятор не запускается.
Нужен ли Vulkan SDK для запуска готового бинарника?
SDK нужен прежде всего для утилиты vulkaninfo и диагностики. Для самого запуска критичен драйвер GPU с поддержкой Vulkan, на котором держится рендер.
Почему в репозитории нет файлов игры?
Ассетов в поставке нет по определению проекта — их подкладывает пользователь из собственной копии игры. Без файлов версии 1.5.0 приложение не загрузит контент.
Можно ли взять файлы от другой версии игры?
Ориентируйтесь на версию, указанную в описании проекта, — 1.5.0. С другими версиями поведение не гарантируется; если после подмены появляются ошибки загрузки ресурсов, вернитесь к 1.5.0 и сверьтесь с документацией репозитория.