totk-pc-recomp README

README проекта с github.com/valentderah/totk-pc-recomp. Одним файлом markdown: README.md.

TotK Recomp

TotK Recomp is a static recompilation of The Legend of Zelda: Tears of the Kingdom (Nintendo Switch, 2023) into a native x86-64 application for Windows and Linux (docs/architecture.md).

[!IMPORTANT] No game files are included. You need your own legally obtained copy of Tears of the Kingdom, dumped from your own console: the base game and the 1.1.0, 1.2.1 or 1.4.3 update. 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

Early development. The game is playable on Windows and Linux; visual bugs and crashes are still expected.

Report problems as issues, following CONTRIBUTING.md.

Features

Planned

Installing

Windows

Requirements: Windows 10 or later, an x86-64 CPU with SSE4.2 (AVX2/FMA machines get a faster build), a GPU with Vulkan 1.3 and VK_EXT_external_memory_host, about 36 GiB free during setup (20 GiB after).

  1. Download TotK-Setup-<version>-windows.zip from Releases and unpack it.
  2. Start TotK-Setup.exe. If SmartScreen warns about an unsigned app, choose More info, then Run anyway.
  3. Pick your game files, the language and an install folder, and press Start. The setup builds the game once. With an NVIDIA RTX GPU it also downloads NVIDIA DLSS, unless you untick Download NVIDIA DLSS; turn DLSS on in the menu (F1).
  4. Play totk.exe from the install folder.

Linux

Requirements: as on Windows, plus Linux 6.7 or later and glibc 2.34 or later (Ubuntu 22.04, Debian 12, Fedora 35, SteamOS 3).

  1. Download TotK-Setup-x86_64.AppImage from Releases, or build it (docs/installer.md, "Linux release").
  2. Make it executable (chmod +x TotK-Setup-x86_64.AppImage) and start it. On a Steam Deck, do this in Desktop Mode.
  3. Pick your game files, the language and an install folder, and press Start.
  4. Play totk from the install folder.

To update, run a newer setup on the same folder; saves and settings are kept. Settings are in the in-game menu and in totk.ini (totk.ini.example lists every key). Controls: docs/controls.md.

Credits

TotK Recomp builds on the projects below. What was taken from each, with its license, is listed in THIRD_PARTY_NOTICES.md.

License

The project's own code is under the MIT License; third-party code keeps its own license (THIRD_PARTY_NOTICES.md). The license grants nothing for Nintendo's game.

TotK Recomp is an independent, non-commercial fan project, not affiliated with or endorsed by Nintendo. The Legend of Zelda, Tears of the Kingdom and Nintendo Switch are trademarks of Nintendo.

Building from source

docs/building.md lists the toolchain and the steps. Everything the build writes stays under build\ and generated\, which git ignores; run tools/check_content.py before a commit. Testers: docs/tester-guide.md.

Most of the code and documentation is written by AI coding agents (Claude Code) under the maintainer's direction; the maintainer plays every build and decides what is merged. AGENTS.md holds the rules they work under.

totk-pc-recomp (valentderah/totk-pc-recomp)

Ищем в базе…

Что это такое?Это статическая рекомпиляция The Legend of Zelda: Tears of the Kingdom (изначально игра для Nintendo Switch) в нативное приложение для Windows x86-64 со своим рендерером на Vulkan. Сама игра в комплект не входит: нужна ваша законно снятая копия (дамп).
Это эмулятор или что-то другое?Это не эмулятор. Код игры статически рекомпилирован в нативный машинный код x86-64, который работает прямо в Windows, а не интерпретируется и не переводится на лету, как это делает эмулятор.
Как установить и запустить игру?Скачайте TotK-Setup- -windows.zip со страницы Releases, запустите TotK-Setup.exe, укажите путь к вашим файлам игры (дампу), выберите язык и папку установки. Программа один раз соберёт игру. После этого запускайте totk.exe из папки установки.
Какое железо и какие файлы нужны перед запуском?Нужны Windows 10+, процессор x86-64 с поддержкой AVX2, видеокарта с поддержкой Vulkan 1.3 и VK_EXT_external_memory_host, около 36 GiB свободного места на диске во время установки, а также ваш законно полученный дамп базовой игры и обновления 1.2.1 или 1.4.3.
Игра входит в комплект, и всё ли в ней стабильно?Файлы игры не поставляются: дамп нужно законно снять самостоятельно со своей консоли. Проект находится на ранней стадии разработки, поэтому визуальные баги и вылеты пока ожидаемы.
Работает ли это и на Linux?Пока работает только на Windows x86-64. Поддержка Linux и Steam Deck, а также модов и ультрашироких соотношений сторон запланирована в дорожной карте, но пока недоступна.
Какой FPS ожидать по сравнению с оригиналом?По умолчанию проект нацелен на 60 fps, есть возможность поднять частоту до 144 fps или до частоты обновления вашего монитора (экспериментально). Также доступны пользовательские разрешения, суперсэмплинг и апскейлинг AMD FSR 1.
Можно ли использовать моды, сделанные для эмуляторных версий игры?Пока нет. Распаковка модов, созданных для эмуляторов, в папку mods указана как запланированная функция, а не как то, что доступно сейчас.
Кто на самом деле написал код этого проекта?Большую часть кода и документации написали ИИ-агенты для программирования (Claude Code) под руководством сопровождающего. Он лично проходит каждую сборку и решает, что войдёт в основную ветку.
Какое управление поддерживается?Поддерживаются клавиатура, мышь и геймпад, включая переназначение клавиш, вибрацию и управление гироскопом. Подробности в docs/controls.md.
Какие есть похожие проекты?bbhost, xcx-recomp, SavageWindRecomp, ocarina-recomp, Yakumo, NX2navi, bloodborne_pc, ShadowRecomp
Автор
valentderah
Размер
4.6 MB
Звёзды
7.6K
Возраст
20 д
Коммиты · 90 дней