kuraeow/ultratears

项目介绍

UltraTears 是非官方的《塞尔达传说：王国之泪》1.4.3 原生移植版，面向 Windows、Linux 和 Steam Deck。它并非模拟器：游戏代码会被提前翻译为原生代码，着色器和纹理在构建阶段而非游玩过程中准备（项目说明）。

仓库不包含任何游戏内容。使用者需要自备 1.4.3 版本的游戏，并从自己的主机导出 exefs 和 romfs 目录。项目不提供游戏文件、密钥、固件或导出工具，也不做任何解密。

快速使用（Windows）

环境要求：Windows 10/11 或 Linux（内核 6.7+、glibc 2.34+，SteamOS 3 均满足），支持 Vulkan 1.3 的显卡驱动，16 GB 内存、4 GB 显存、约 40 GB 可用空间，以及按如下结构摆放的导出数据：

dump\
├── exefs\   main, subsdk0, sdk, main.npdm, ...
└── romfs\   about 304,000 files, 16 GB

1. 从 Releases 下载 Windows 压缩包，解压到独立文件夹。
2. 运行 UltraTears Launcher.exe；如遇 SmartScreen 提示，选择 More info → Run anyway。
3. 在启动器中选择包含 exefs 和 romfs 的目录，点击 Prepare the game，构建约需 30 分钟。
4. 点击 Play 开始游戏。

Linux 和 Steam Deck 改用 UltraTears.AppImage：在文件属性中勾选 Allow executing file as program，完成准备后把 AppImage 作为非 Steam 游戏添加；在启动选项中加入 --play 可跳过启动器直接进入游戏（安装步骤）。在 Deck 上游玩时，准备阶段选择 For Linux (Steam Deck) 或 Both platforms 以生成可拷贝到 Deck 的游戏目录。

中文与韩文字体

简中、繁中和韩文依赖 Switch 的系统字体，这些字体既不在游戏内，也不在导出数据中。需在准备游戏前把主机中的六个 *.bfttf 文件放入 sysdata\fonts\（也可稍后放入游戏目录的 data\fonts\）；缺少这些字体时，以对应语言启动会直接退出。

模组与操作

为 Switch 模拟器制作的模组可直接使用：把每个模组解压到启动器模组目录下的独立文件夹，使其 romfs、exefs 或 cheats 目录直接位于其中，然后在 Mods 页启用或调整顺序；RomFS 模组和数据类作弊无需重新构建，代码补丁和 Atmosphere 作弊会在点击 Play 时应用。键鼠与手柄映射、摇杆死区和陀螺仪在 Controls 页配置，场景缩放、FSR 1/3.1 和 FXAA/SMAA 抗锯齿在 General 页设置。

从源码构建

安装 Git 和 Python 3 后执行：

git clone https://github.com/kuraeow/ultratears.git
cd ultratears
python tools/setup.py --dump D:\path\to\dump

脚本会下载缺少的工具，并在 build\ 下生成含启动器的完整游戏目录；不带 --dump 时读取仓库内的 dump\。Linux 支持和实现细节见 BUILDING.md，参与贡献见 CONTRIBUTING.md。

使用约束与许可

项目采用 GPL-3.0，但名称、徽标、图标和封面不在此许可范围内，详见品牌说明。源码仅包含运行游戏所需的地址、哈希和短指令替换，不含任天堂 SDK 代码或游戏资源。由自备导出数据生成的一切仅供本人使用，不应分享。遇到问题可附上游戏目录中的 ultratears.log 到 Issues 反馈。

HotRepo 点评

该仓库目前没有 GitHub 日榜记录或趋势快照，可参考的站内信号只有 Star 总数。真正值得关注的是静态重编译方案与「用户自备导出数据」的组合，因此可信度更多取决于 BUILDING.md 所描述的源码树和构建流程，而非随附的二进制。由于主要交付物是需要下载运行的启动器程序，运行前应核对二进制与源码的对应关系及 Release 来源。