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)

正在搜索数据库…

这是什么?这是对《塞尔达传说:王国之泪》(原为任天堂 Switch 游戏)进行的静态重编译,将其转换为使用自有 Vulkan 渲染器的原生 Windows x86-64 应用程序。本项目不包含游戏本体,你需要提供自己合法转储的游戏副本。
这是模拟器,还是别的东西?这不是模拟器。游戏代码经过静态重编译,变成可直接在 Windows 上运行的原生 x86-64 机器码,而不是像模拟器那样在运行时进行解释或翻译。
我该如何安装和游玩?从 Releases 下载 TotK-Setup- -windows.zip,运行 TotK-Setup.exe,指定你自己转储的游戏文件,选择语言和安装目录,程序会先构建一次游戏。之后,从安装目录启动 totk.exe 即可。
在尝试之前,我需要什么硬件和文件?你需要 Windows 10 或更高版本、支持 AVX2 的 x86-64 处理器,以及支持 Vulkan 1.3 和 VK_EXT_external_memory_host 的显卡;安装过程中大约需要 36 GiB 的可用磁盘空间;另外还需要你合法获取的基础游戏转储,以及 1.2.1 或 1.4.3 版本的更新转储。
这个项目是否附带游戏?它是否完全稳定?不附带任何游戏文件,你必须自行从自己的主机上合法转储游戏。此外,项目仍处于早期开发阶段,视觉故障和崩溃仍然可能出现。
它也能在 Linux 上运行吗?目前它仅支持 Windows x86-64。Linux 和 Steam Deck 的支持,以及模组支持和超宽屏幕纵横比,都已列入路线图,但目前尚不可用。
与原版相比,我能获得怎样的性能?默认目标为 60 fps,可选择提升至 144 fps 或显示器的刷新率(实验性功能),同时支持自定义分辨率、超采样以及 AMD FSR 1 升频。
我能使用为游戏模拟器版本制作的模组吗?暂时不能。将模拟器模组解包到 mods 文件夹的功能已列为计划功能,目前尚不可用。
这个项目的代码究竟是谁编写的?大部分代码和文档由 AI 编程代理(Claude Code)编写,并由维护者指导完成;维护者会亲自游玩每个版本,并决定哪些内容可以合并。
它支持哪些操作方式?支持键盘、鼠标和游戏手柄,包括按键重新映射、震动和陀螺仪控制;完整说明见 docs/controls.md。
大小
4.6 MB
星标
7.6K
时长
20天
提交 · 90 天