![Need for Speed Underground](docs/images/title.png)

**Русский** · [English](README.en.md)

# NFSU Android

Предварительная версия нативного Android-порта Need for Speed Underground для ARM64 на основе статической рекомпиляции Xbox-версии.

**[Подробное руководство: управление, настройки, сохранения и перенос прогресса](docs/GUIDE-RU.md)**

**[Файлы версии v0.2.0-preview.9](https://github.com/Wannamingo/NFSU-Android/releases/tag/v0.2.0-preview.9)** — APK ARM64, руководство для скачивания и SHA256SUMS.

## Возможности

- Индивидуальный размер 40–160% и непрозрачность 20–100% экранных элементов, с сохранением прежней раскладки и отдельным сбросом.
- Полное отключение динамических отражений автомобиля через настройки лаунчера и игры; прежний выбор и отражения дороги сохраняются.


- Самостоятельный Vulkan-рендерер, отдельный поток подготовки графики, арены геометрии и подготовленные ключи состояний.
- Системный Vulkan, встроенный MaliSX2, Purple Turnip T30 для совместимых Adreno и импорт своего ZIP.
- Классическая и гоночная раскладки, стрелки или неоновый стик, общая пауза, перетаскивание элементов и размер гоночных кнопок 40–100%.
- Геймпады, отдельные назначения экранных и физических кнопок, перестановка A/B и X/Y.
- Форматы изображения 4:3, 16:9 и 20:9 с сохранением пропорций HUD и меню, внутренний масштаб 1×/2×/3×, предел 60 или 120 FPS.
- Русский и английский интерфейсы.
- Выбор звука Авто / OpenSL ES · 512 для всех CPU; автоматический поворот по датчику в обе горизонтальные стороны.
- Исправленный вывод звука на RG477M: OpenSL ES с буфером 512 кадров включается автоматически, включая GammaOS.
- Автоматические копии игровых профилей в `Download/NFSU/Saves`, хранение последних 10 собственных поколений и восстановление через системный выбор папки.
- Ускоренное точное преобразование swizzled-текстур и переиспользование Vulkan pipeline cache на системном драйвере. Проверки изменений текстур сохранены.

## Статус версии

Текущая версия: **0.2.0-preview.9**, versionCode **12**. Добавлены индивидуальные размер/непрозрачность кнопок и отключение отражений автомобиля. Сохранены звук, автоповорот, 20:9, драйверы, русский/английский и сохранения из preview.8. На RG477M пройдены 54 графические группы; проверены OFF/обратное включение и сохранение параметров кнопок в установленном приложении. Нового замера FPS в движении или полного прохождения карьеры не заявляется.

Устанавливайте поверх прежнего приложения без удаления и очистки данных. Сохраните внешнюю копию прогресса.

## Игровые данные

Для запуска нужен собственный совместимый образ **NFS Underground для оригинальной Xbox, USA**. Игра импортируется через лаунчер из ISO или ZIP. PC-версия и Underground 2 не подходят. Образ игры, сохранения пользователей и личные журналы не поставляются в репозитории.

## Происхождение

Работа опирается на проекты [nfsu1-sw](https://github.com/antoxa2584x/nfsu1-sw), [nfsu1-android](https://github.com/cherepavel/nfsu1-android) и [xboxrecomp](https://github.com/sp00nznet/xboxrecomp), а также используемые графические и Android-библиотеки. [Состав, известные ревизии и границы исходного набора](docs/COMPONENTS.md), [уведомления о сторонних компонентах](licenses/README.md).

Need for Speed и Underground — обозначения их правообладателей. Это неофициальный проект.