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

> AI Release · @ai_release1 · https://ai-release.org/guides/kak-zapustit-the-legend-of-zelda-breath-of-the-wild-nat.html

## TL;DR

- Время выполнения: 30–60 минут (оценка: клонирование репозитория, установка зависимостей сборки и сама сборка; время компиляции зависит от вашего CPU)
- Уровень сложности: Advanced — нужно собрать C++-проект из исходников и самостоятельно подготовить файлы игры
- Понадобится:
  - 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**: игровых ассетов в поставке нет, файлы игры подкладывает пользователь

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/kak-zapustit-the-legend-of-zelda-breath-of-the-wild-nat-ru-1.jpg?v=1792874964)


- **ОС:** Windows 10 или Windows 11, 64-бит. Если система старая или «грязная», чистая установка снимает половину проблем с драйверами и runtime — пошагово это разобрано в гайде [Как установить Windows 11 26H2: пошаговая инструкция с официального ISO](https://ai-release.org/guides/kak-ustanovit-windows-11-26h2-poshagovaya-instruktsiya.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).
- **GPU:** любой адаптер, чей драйвер отдаёт Vulkan. Проверять будем на шаге 1.
- **Права:** администратор нужен только для установки драйверов и SDK; сама сборка и запуск идут от обычного пользователя.
- **Свободное место:** точный размер сборки и файлов игры в исходном посте не указан — сверьтесь с документацией репозитория и закладывайте место под саму игру плюс каталог сборки.
- **Git** — для клонирования исходников.
- **Vulkan SDK** — для `vulkaninfo`.
- **Файлы игры:** Wii U-версия Breath of the Wild v1.5.0 из вашей легально приобретённой копии. Проект лишь пересобирает код игры в нативное приложение Windows, контента он не содержит.

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

```powershell
git --version
```

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

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

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

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

**Зачем:** без рабочего Vulkan-драйвера приложение не сможет инициализировать рендер, а сборка без исходников невозможна.

**Как проверить:** обе команды ниже должны отработать без ошибок.

Проверка Vulkan (утилита ставится вместе с Vulkan SDK):

```powershell
vulkaninfo --summary
```

Ожидаемый результат: блок с именем вашего GPU и версией Vulkan API. Если команда не найдена — SDK не установлен или не добавлен в PATH; если утилита падает с сообщением об отсутствии ICD, проблема в драйвере.

Резервная проверка железа, если `vulkaninfo` недоступен:

```powershell
Get-CimInstance Win32_VideoController | Select-Object Name, DriverVersion
```

**Пример:** вывод вида `Name: NVIDIA GeForce RTX ...`, `DriverVersion: 5xx.xx` — драйвер определяется. Дальше сравните `DriverVersion` с версией на сайте производителя; если она старше — обновите.

Клонирование:

```powershell
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. Сборка приложения и подготовка файлов игры»](https://ai-release.org/guides/img/kak-zapustit-the-legend-of-zelda-breath-of-the-wild-nat-ru-2.jpg?v=1792874972)


**Что сделать:** собрать нативный бинарник и положить в нужный каталог файлы игры v1.5.0.

**Зачем:** репозиторий содержит код, но не ассеты; приложение без файлов игры запустится и упадёт на этапе загрузки контента.

**Как проверить:** сборка завершается без ошибок, рядом с бинарником появляется ожидаемая структура каталогов, а при запуске нет сообщения об отсутствии игровых данных.

Сначала прочитайте README репозитория — там указаны точные зависимости и команды сборки. Типовой цикл для C++/Vulkan-проекта выглядит так (флаги сверьте с документацией):

```powershell
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
- [ ] Сборка завершилась без ошибок, бинарник на месте
- [ ] Файлы игры — именно версия 1.5.0 (Wii U), как указано в описании проекта
- [ ] Каталог с ассетами совпадает с тем, что описан в README
- [ ] Драйвер GPU обновлён до актуальной версии с сайта производителя

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

## Шаг 3. Запуск и проверка результата
![Иллюстрация к разделу «Шаг 3. Запуск и проверка результата»](https://ai-release.org/guides/img/kak-zapustit-the-legend-of-zelda-breath-of-the-wild-nat-ru-3.jpg?v=1792874977)


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

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

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

```powershell
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 failed`
- Причина: драйвер GPU не предоставляет Vulkan (старая версия драйвера, установлен только OpenGL/D3D-компонент, либо вывод идёт на интегрированное видео).
- Решение: обновите драйвер с сайта производителя GPU, перезагрузитесь и проверьте `vulkaninfo --summary`. Если утилита показывает только программный рендерер (lavapipe/llvmpipe), переключите монитор на дискретный GPU или задайте его основным в настройках графики Windows.

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

- Ошибка: `ошибка вида "Game files not found"` / сообщение о ненайденных ресурсах в логе
- Причина: файлы игры не скопированы, лежат не в том каталоге или это другая версия (не 1.5.0).
- Решение: сверьте путь с README и перенесите ассеты:

```powershell
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 found`
- Причина: не установлен toolchain C++ (компилятор + Windows SDK) или CMake запущен в окружении, где он не виден.
- Решение: установите компонент «Разработка классических приложений на C++» в установщике Visual Studio, перезапустите терминал и повторите:

```powershell
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: установка и настройка](https://ai-release.org/guides/kak-zapustit-metal-gear-solid-2-hd-i-drugie-porty-nvidi.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

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