ultratears/README.ru.md

English · Русский

UltraTears

UltraTears собирает нативную версию The Legend of Zelda: Tears of the Kingdom (версия 1.4.3) для Windows, Linux и Steam Deck из вашей собственной копии игры. Это не эмулятор: код игры заранее переводится в нативный, а шейдеры и текстуры готовятся при сборке игры, а не во время игры.

Important

Файлов игры здесь нет. Нужна ваша собственная копия игры с обновлением 1.4.3, снятая с вашей консоли в виде обычных папок exefs и romfs. Проект не даёт файлов игры, ключей, прошивки и инструментов для дампа, а UltraTears ничего не расшифровывает. Всё, что делается из игры, делается на вашем ПК и только для вас: не распространяйте это.

UltraTears не связан с Nintendo и не одобрен ею. The Legend of Zelda и Tears of the Kingdom — товарные знаки Nintendo.

О проблемах пишите в Issues и прикладывайте ultratears.log из папки игры.

Установка

Нужно: Windows 10/11 или Linux (ядро 6.7 и новее, glibc 2.34 и новее; в SteamOS 3 есть оба), видеокарта со свежим драйвером Vulkan 1.3, 16 ГБ ОЗУ, 4 ГБ видеопамяти, около 40 ГБ свободного места и ваш дамп:

dump\
├── exefs\   main, subsdk0, sdk, main.npdm, ...
└── romfs\   около 304 000 файлов, 16 ГБ

Windows

1. Скачайте UltraTears-<версия>-windows-x86_64.zip со страницы Releases и распакуйте в отдельную папку.
2. Запустите UltraTears Launcher.exe. Если SmartScreen предупреждает, нажмите Подробнее → Выполнить в любом случае.
3. Выберите папку с exefs и romfs и нажмите Подготовить игру. Игра соберётся один раз, примерно за 30 минут.
4. Нажмите Играть.

Чтобы играть на Steam Deck, рядом с Подготовить игру выберите Для Linux (Steam Deck) или Обе платформы: получится UltraTears-SteamDeck.tar (около 28 ГБ). Распакуйте его на Deck и запускайте, как ниже, с шага 4.

Linux и Steam Deck

1. Скачайте UltraTears.AppImage со страницы Releases. На Steam Deck — в режиме рабочего стола.
2. В свойствах файла на вкладке Права включите Разрешить выполнение файла как программы и запустите его.
3. Выберите папку с exefs и romfs и нажмите Подготовить игру.
4. Когда подготовка закончится, добавьте UltraTears.AppImage из папки игры в Steam как стороннюю игру. Если вписать --play в параметры запуска, сразу будет запускаться игра, без лаунчера. Запускайте игру из игрового режима.

Новые версии лаунчер находит сам и пересобирает только изменённое; сохранения в userdata остаются. На Linux можно и просто положить новый UltraTears.AppImage в папку игры с заменой: лаунчер предложит обновить игру.

Управление

Кнопки геймпада расположены как на Switch (A — правая кнопка).

Клавиатура: WASD — движение, стрелки — камера, J = A, K / пробел = B, I = X, U = Y, Q / E = L / R, Alt / Shift = ZL / ZR, Enter = +, Tab / Esc = − (карта), T F G H = крестовина, Z / C = нажатие стиков, F11 или Alt+Enter — полный экран. Поддержка мыши в планах.

Сборка из исходников

Установите Git и Python 3, затем:

git clone https://github.com/kuraeow/ultratears.git
cd ultratears
python tools/setup.py --dump D:\путь\к\дампу

Сборщик сам скачает недостающие инструменты и соберёт в папке build\ готовую игру с лаунчером, как в релизе. Запускайте build\UltraTears Launcher.exe. Без --dump дамп берётся из папки dump\ в репозитории. Параметры, Linux и устройство сборки: BUILDING.md. Как предложить изменения: CONTRIBUTING.md.

Правовое

• В репозитории и в релизах нет ничего из игры: ни кода (в том числе переведённого из неё), ни ресурсов, шейдеров, текстур, шрифтов, ключей или прошивки. Всё это делается из вашего дампа на вашем ПК.
• Код и заголовки Nintendo SDK не используются: системный и графический слои — собственные.
• В исходниках только факты, нужные для запуска: адреса, хеши, короткие замены инструкций.
• Название, эмблема, иконка и обложка — собственные работы автора и не под GPL: assets/BRANDING.md. Сторонний код: third_party/README.md.