NotRexed/SkyboundTotk

选用指南

AI 根据 README 整理 · 2026/10/28 13:16:42

使用方式

通过命令行运行build.bat构建，然后运行dist/SkyboundTOTK/SkyboundTOTK.exe启动游戏。

查看 README 依据

1. Put the extracted files in the project's `game` folder. The paths must look like this, not `game/exefs/exefs/main` or `game/romfs/romfs/Event`: ```text SkyboundTOTK/ build.bat game/ exefs/ main main.npdm rtld sdk ... romfs/ ActorSystem/ Event/ ... ``` 2. Open an **x64 Native Tools Command Prompt**, change to the SkyboundTOTK directory and run `build.bat`. The launcher pauses at the end so you can read any errors.

3. The script checks the `main` and `sdk` module build IDs and a few RomFS directories, lifts the game code, compiles the native executable and copies the runtime and RomFS into `dist/SkyboundTOTK/`. The checks do **not** verify the entire RomFS or guarantee that a dump is complete. 4. Open `dist/SkyboundTOTK/SkyboundTOTK.exe` to run it. No command-line arguments are needed. Keep `image.bin`, `image.json`, `romfs/`, `wgpu_native.dll` and `SDL2.dll` alongside the executable. The standalone folder can be moved as a unit and does not need the original `game/` folder to launch.

部署要求

需要Windows 10/11 x64，支持wgpu-native的GPU和驱动，至少45GB额外磁盘空间，Python 3.10+，Visual Studio 2022 Build Tools，Clang/LLVM工具。

查看 README 依据

Keep your game files, generated code, executable package and saves private. The `game/`, `build/` and `dist/` directories are Git-ignored, but check what you are publishing rather than relying on ignore rules alone. The generated standalone package contains copyrighted game-derived data and must not be shared or committed. ## Build on Windows ### Requirements - Windows 10/11 x64 and a GPU and driver supported by wgpu-native. Allow **at least 45 GB free in addition to the original game dump** for intermediate files and the separate packaged RomFS; the build is CPU- and memory-intensive.

- Python 3.10 or newer on PATH, with `lz4` installed: `python -m pip install lz4`. - Visual Studio 2022 Build Tools with the MSVC C++ tools and Windows SDK. Use an **x64 Native Tools Command Prompt** so the compiler can find the Windows headers and libraries. - Clang, clang++ and lld. The build previously used emsdk 6.0.9: install it separately and set `EMSDK` to its directory (the lookup defaults to `C:\emsdk`), or put these LLVM tools on PATH. The build script does not download compilers or Python packages. ### Prepare and build

已知限制

仅支持1.0.0基础版本，存在图形问题和兼容性问题，不保证完整通关。

查看 README 依据

# SkyboundTOTK SkyboundTOTK is an experimental Windows x64 static recompilation project for *The Legend of Zelda: Tears of the Kingdom*, **base game version 1.0.0**. It is not affiliated with Nintendo. Expect graphical problems and incomplete compatibility; a successful build does not guarantee a complete playthrough.

You must supply your own legally obtained, already-extracted, **unmodified 1.0.0 base-game ExeFS and RomFS**. No game files, generated game code, keys, firmware or saves are included in this source project. The build does not extract NSP or XCI files, and other versions or updates are not supported by the game-specific hooks.