NX2navi README

README проекта с github.com/tangerineturtle1/NX2navi. Одним файлом markdown: README.md.

Triforce

NX2navi

[!IMPORTANT] NX2navi is no longer the current project. NX2navi and Triforce have merged and go on as Triforce. Get Triforce from https://triforceproject.com. Its source is at https://git.triforceproject.com/triforce/source.

This repository and its releases are kept as they are. Release 0.12.0 turns an installed NX2navi launcher into a window that starts Triforce Setup; Play NX2navi there still starts the game you have built, and your game, saves and settings stay where they are. Triforce's Convert saves page brings your NX2navi saves over.

Join the official Triforce update discord server: https://discord.com/invite/uf6gSrsPpq

NX2navi is a static recompilation of The Legend of Zelda: Ocarina of Time for Nintendo Switch 2 (game version 1.1.1) into a native x86-64 application for Windows, with a Vulkan renderer (docs/architecture.md).

[!IMPORTANT] No game files are included. You need your own legally obtained copy of the game, dumped from your own console. Instructions for obtaining those files will not be provided.

The game is built from your files on your machine, so the result contains the game. It is for your own use. Do not share it.

Status

New work goes into Triforce, not here (see the top of this page). What follows describes NX2navi as it was at the handover.

Playable. Kokiri Forest, Kakariko Village, Death Mountain Trail and its crater, the Temple of Time and the Great Fairy fountains play at 60 fps and above on current GPUs, from the title screen and from saves. Visual bugs and occasional crashes are still expected (Known issues).

Report problems as issues, following CONTRIBUTING.md.

Features

Installing

New here: get Triforce from https://triforceproject.com instead. Release 0.12.0 carries no setup, and a launcher installed from an earlier release updates itself into the window that starts Triforce Setup. The rest of this section describes NX2navi's own setup before 0.12.0.

Download NX2navi-Setup-<version>.exe from the releases and start it next to your .nup dump. It is the only file you need. The launcher it installs finds the dump, downloads the build tools, builds the game on your PC (20 to 45 minutes, once) and starts it; afterwards it keeps the port up to date and rebuilds only what changed (docs/launcher.md). docs/README-BuildKit.md describes the same build by hand, docs/building.md building from source. Settings are in the in-game menu and in nx2navi.ini (nx2navi.ini.example lists every key). Controls: docs/controls.md.

Requirements: Windows 10 or later; an x86-64 CPU with SSE4.2 (AVX2/FMA machines get a faster build); 16 GB of RAM; about 34 GB free for the game and 1.5 GB for the launcher and its tools; a GPU with Vulkan 1.3, VK_EXT_external_memory_host and VK_EXT_mesh_shader. The setup is not signed, so SmartScreen warns on its first start.

Known issues

License

The source is public to read. Its additions and changes are all rights reserved (LICENSE-ADDITIONS): no part of them may be copied or published without written permission. The base import stays under its MIT License, and third-party code keeps its own license (THIRD_PARTY_NOTICES.md). No license grants anything for Nintendo's game.

NX2navi is an independent, non-commercial fan project, not affiliated with or endorsed by Nintendo. The Legend of Zelda, Ocarina of Time and Nintendo Switch are trademarks of Nintendo.

Building from source

docs/building.md lists the toolchain and the steps. tools/make_game.py also builds the game natively on Linux (docs/README-BuildKit.md, "Linux"); the launcher and the setup are Windows only. Everything the build writes stays under build\ and generated\, which git ignores, as it does the runtime's shaders the build compiles (runtime\*_spv.h; the repository holds their source only); run tools/check_content.py before a commit.

NX2navi (tangerineturtle1/NX2navi)

Ищем в базе…

4.3K ·GitHub
Что это такое?Нативная версия The Legend of Zelda: Ocarina of Time для Windows на ПК, статически перекомпилированная из релиза для Nintendo Switch 2 (версия игры 1.1.1). Файлов игры в комплекте нет, поэтому игра собирается на вашем ПК из вашего собственного дампа.
Это эмулятор?Нет. Игра работает как нативный код x86-64, а не эмулирует консоль. Упакована она как приложение для Windows с рендерером на Vulkan.
Как это запустить?Скачайте установочный .exe со страницы релизов и запустите его рядом с вашим дампом .nup. Лаунчер найдёт дамп, загрузит инструменты сборки, один раз соберёт игру на вашем ПК (от 10 до 25 минут) и запустит её. Потом пересобираются только изменённые части.
Что нужно моему ПК?Windows 10 или новее, процессор x86-64 с поддержкой SSE4.2, 16 ГБ оперативной памяти, около 30 ГБ свободного места под игру и ещё 1,5 ГБ под лаунчер и его инструменты, а также видеокарта с поддержкой Vulkan 1.3.
Насколько это стабильно сейчас?Не полностью. Проект находится на ранней стадии разработки: только некоторые области, например Лесной край Кокири и Храм Времени, работают при 60 кадрах в секунду. Ожидаются визуальные баги, периодические вылеты и редкий вылет из-за частиц. Первый запуск после установки или обновления, а также первое посещение каждой области могут ненадолго зависнуть, пока драйвер строит шейдеры.
Можно ли запустить это на Mac или Linux?Нет, поддерживается только Windows 10 или новее. Кроме того, установщик не подписан, поэтому SmartScreen выдаст предупреждение при первом запуске.
Нужна ли мощная видеокарта?Нужна видеокарта с поддержкой Vulkan 1.3 и двух расширений. NVIDIA DLSS требует карту RTX, а апскейлинг AMD FSR 3.1 и генерация кадров работают на любой видеокарте.
Поддерживаются ли широкоэкранные режимы и высокая частота кадров?Да. Поддерживаются нативные соотношения сторон 21:9 и 32:9 с интерфейсом, сохранённым в 16:9. По умолчанию игра работает при 60 кадрах в секунду, можно выбрать ограничение от 30 до 240 кадров в секунду, частоту обновления экрана или без ограничений. Разрешение доступно до 5K или под размер окна.
Работает ли с геймпадом?Да. Поддерживаются клавиатура, мышь и геймпады с возможностью переназначения кнопок, раскладками Nintendo или Xbox, вибрацией и гироскопом. Игра реагирует на тот подключённый геймпад, которым вы нажимаете кнопку.
Поддерживается ли HDR?Да. На HDR-экранах доступен либо собственный HDR игры, либо улучшенный HDR, созданный из SDR-изображения игры.
Почему первый запуск занимает много времени?Сборка выполняется один раз на вашем ПК (от 10 до 25 минут). Потом первый запуск после установки или обновления может ненадолго зависнуть, пока драйвер видеокарты строит шейдеры, которые ещё не встречал.
Размер
12.9 MB
Звёзды
4.3K
Возраст
11 д
Коммиты · 90 дней