kuraeow/ultratears

选用指南

AI 根据 README 整理 · 2026/10/26 05:26:24

使用方式

通过 Releases 提供的构建器包或从 GitHub 源码构建，运行 setup.bat 或 python tools/setup.py 完成构建，然后运行生成的 UltraTears.exe 启动游戏。

查看 README 依据

You obtain these folders yourself from your own console and copy of the game with update 1.4.3 installed. This project does not provide or point to extraction tools. `.nsp`, `.xci`, `.nca` and other encrypted packages do not work: UltraTears decrypts nothing and reads no keys. ## Method 1 — builder package from Releases (recommended) ### 1. Download and extract the builder Download this file from the [**Releases**](https://github.com/kuraeow/ultratears/releases) page: ```text UltraTears-builder-<version>-windows-x86_64.zip ```

| `finish` | The launch configuration is written | seconds | Times depend on the CPU, disk and antivirus. The build is complete only after the `Done` message. If the PC shuts down or the window closes, run `setup.bat` again; completed work is reused. ### 4. Start the game Run: ```text D:\Games\UltraTears\UltraTears.exe ``` Do not move the EXE by itself. It needs `ultratears.cfg` and the `data` folder beside it. Saves are stored in `userdata`; keep that folder when moving or updating the game. ## Method 2 — build the current GitHub source

Use this method when changing the code or building the newest commit. Install Git and Python 3, open PowerShell, then run: ```powershell git clone https://github.com/kuraeow/ultratears.git cd ultratears ``` Put `exefs` and `romfs` in `ultratears\game` as shown above, then run: ```powershell python tools/setup.py ``` This **one command performs the entire process**: 1. Creates `dist` inside the repository. 2. Copies the current tracked source files there. 3. Downloads missing Python, Clang and the shader translator from the latest builder release.

部署要求

需要 Windows 10/11 x64、支持 AVX2 的处理器、支持 Vulkan 1.3 和 VK_EXT_shader_object 的显卡、16 GB 内存、约 32 GB 构建输出空间和约 16 GB 游戏转储空间，以及用户自己提取的《王国之泪》1.4.3 版本文件。

查看 README 依据

| **Builder package from Releases** | Almost every player. This is the recommended and easiest method | Nothing | | **Current GitHub source** | Developers and people testing their own changes | Git and any maintained Python 3; the remaining tools download automatically | Both methods produce the same playable folder. The Releases package already carries every build tool. The source build downloads the same tool bundle first, then performs the same game build. ## Requirements for either method - Windows 10/11 x64 and a processor with AVX2 (Intel Haswell / AMD Ryzen or newer).

- A graphics card with a current Vulkan 1.3 driver and `VK_EXT_shader_object` (recent NVIDIA, AMD and Intel drivers). - 16 GB of RAM. - About **32 GB free for the build output**, plus about 16 GB for the original game dump. The original dump in the working folder is no longer needed after a successful build. - **Your own extracted copy of Tears of the Kingdom version 1.4.3** as two ordinary folders: ```text game\ ├── exefs\ main, subsdk0, sdk, main.npdm, ... └── romfs\ Actor\, Pack\, Shader\, ... (about 304,000 files, 16 GB) ```

已知限制

目前仅支持 Windows，Steam Deck 和 Linux 尚未支持；首次遇到特效或场景时可能出现卡顿（着色器编译）；暂无设置菜单；控制器布局遵循 Switch 布局（A 键在右侧）。

查看 README 依据

Known issues: hitches the first time an effect or place is seen (shader compilation); the controller layout follows the Switch (A is the right face button); no settings menu yet (window size, resolution, upscaling come later). ## Choose how to build first There is no downloadable game-filled `UltraTears.exe`. You download a builder, and it translates and compiles the game on your PC from your own extracted dump. There are two ways to do that: | Method | Who it is for | What you install | |---|---|---|

To update a Releases build, extract the new builder package over the old folder and run `setup.bat` again. Keep `userdata` to preserve saves. For a Git build, run `git pull`, then repeat the same `python tools/setup.py` command and options. > **Steam Deck and Linux are not supported yet.** The Windows build does not work through Proton because its memory > access method is incompatible with `winevulkan`. A native Linux and Steam Deck version is planned and is one of the > project's high-priority tasks. ## If the build stops with an error