← Все гайды AI Release
EN Подписаться на @ai_release1

Как запустить The Legend of Zelda: Breath of the Wild нативно на Windows: установка BotW-Native

Обновлено: 24.10.2026 · AI Release · @ai_release1
Как запустить The Legend of Zelda: Breath of the Wild нативно на Windows: установка BotW-Native

TL;DR

- 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: игровых ассетов в поставке нет, файлы игры подкладывает пользователь

Требования и подготовка

Иллюстрация к разделу «Требования и подготовка»
Иллюстрация к разделу «Требования и подготовка»

Пример: до начала работ проверьте, что Git вообще доступен в PowerShell:

git --version

Ожидаемый вывод — строка вида git version 2.xx.x.windows.1. Если команда не найдена, установите Git и перезапустите терминал (новый PATH подхватывается только в новом процессе).

Почему это работает: BotW-Native — это статическая рекомпиляция, то есть машинный код Wii U-версии один раз переведён в нативное приложение под Windows. Эмулятор не запускается, поэтому критичны не «настройки эмуляции», а корректная сборка бинарника и наличие файлов игры.

Шаг 1. Проверка Vulkan и получение исходников

Что сделать: убедиться, что драйвер поддерживает 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 забирает полный набор исходников и истории; сборка идёт локально, поэтому никаких сетевых зависимостей на этапе компиляции, кроме уже скачанных библиотек, не остаётся.

Шаг 2. Сборка приложения и подготовка файлов игры

Иллюстрация к разделу «Шаг 2. Сборка приложения и подготовка файлов игры»
Иллюстрация к разделу «Шаг 2. Сборка приложения и подготовка файлов игры»

Что сделать: собрать нативный бинарник и положить в нужный каталог файлы игры 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; конкретное имя в посте не приводится — сверьтесь с документацией).

Чек-лист перед первым запуском:

Почему это работает: рекомпилированный код обращается к тем же данным, что и оригинальная Wii U-версия, поэтому версия контента должна совпадать — подмена файлов от другой версии ломает загрузку ресурсов.

Шаг 3. Запуск и проверка результата

Иллюстрация к разделу «Шаг 3. Запуск и проверка результата»
Иллюстрация к разделу «Шаг 3. Запуск и проверка результата»

Что сделать: запустить собранное приложение и убедиться, что игра стартует на Vulkan.

Зачем: это финальная проверка всей цепочки: драйвер → сборка → ассеты.

Как проверить: появляется окно игры, а не консоль с ошибкой; в Диспетчере задач процесс потребляет GPU.

cd C:\dev\BotW-Native\build
.\BotW-Native.exe

Пример: на экране появляется окно с игровым рендером (заставка/меню Breath of the Wild), в Диспетчере задач на вкладке «Производительность» загрузка GPU выше нуля. Если окно мгновенно закрывается — смотрите раздел с проблемами ниже.

Дополнительно проверьте, что рендер идёт именно через Vulkan-драйвер, а не через программный fallback: повторный vulkaninfo --summary должен показывать тот же дискретный GPU, к которому подключён монитор.

Почему это работает: приложение — обычный Windows-процесс, поэтому все симптомы (нет окна, чёрный экран, падение на старте) диагностируются стандартными средствами: консольным выводом и мониторингом GPU.

Возможные проблемы и решения

Проблема. Приложение падает сразу при старте, окно не появляется

Проблема. Игра стартует, но сразу завершается с сообщением об отсутствии данных

Get-ChildItem -Recurse -Depth 2 | Select-Object FullName

Команда покажет фактическую структуру каталогов — сравните её с описанной в документации. Убедитесь, что используете Wii U-версию 1.5.0.

Проблема. Сборка не находит компилятор C++

cmake -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: установка и настройка.

FAQ

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 и сверьтесь с документацией репозитория.

🤖 Кратко для ИИ