Vual
Запуск Cheat Engine для Steam-игр через Proton
## О проекте
Vual — приложение для запуска Cheat Engine в Steam-играх, работающих через Proton.
Показывает библиотеку Steam, управляет protonhax и launch options, скачивает и
распаковывает CE автоматически, запускает его в нужном Wine-префиксе — всё из одного
окна.
## Возможности
- **Сетка игр** — обложки из Steam CDN, поиск в реальном времени, сортировка по имени или статусу
- **Запуск одним кликом** — игра стартует через Steam, CE подключается к нужному Proton-префиксу
- **Таблицы CE** — привязка .CT-файла к игре, автоматическое открытие вместе с CE
- **protonhax** — автоматическая установка, переключатель launch options для каждой игры, массовое вкл/выкл
- **Установка CE** — скачивание с cheatengine.org, распаковка через Wine из Proton
- **Тема Wine** — тёмная или светлая тема для всех Proton-префиксов разом
- **Локализация** — интерфейс EN/RU, язык CE, установка русской локализации из офиц. репозитория CE
- **Прозрачность окна** — полупрозрачный фон в стиле frosted glass
- **Гайд** — встроенная страница быстрого старта при первом запуске и из меню
## Установка
### Stapler
```
stplr repo add lumenara https://github.com/Cheviiot/Lumenara.git
stplr refresh && stplr install vual
```
### Из исходников
```
git clone https://github.com/Cheviiot/vual.git
cd vual
./vual
```
Зависимости
| Дистрибутив | Команда |
|---|---|
| ALT Linux | `apt-get install python3-module-pygobject3 libgtk4 libadwaita python3-module-requests` |
| Fedora | `dnf install python3-gobject gtk4 libadwaita python3-requests` |
| Arch | `pacman -S python-gobject gtk4 libadwaita python-requests` |
| Debian / Ubuntu | `apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1 python3-requests` |
Также нужен **Proton** (через Steam) — для распаковки CE и работы protonhax.
## Использование
```
./vual
```
1. При первом запуске откроется встроенный гайд
2. Перейди в **Настройки → Cheat Engine** — скачай и распакуй CE
3. Установи **protonhax** там же
4. Включи переключатель у нужной игры — Vual пропишет launch options
5. Нажми ▶ — игра запустится, CE откроется автоматически
## Управление
| | |
|---|---|
| Запуск CE | Клик по кнопке ▶ на плитке игры |
| Поиск | Клик по полю поиска в заголовке |
| Привязать таблицу | Правая кнопка мыши → Assign Table |
| Вкл/выкл protonhax | Переключатель на плитке игры |
| Массовое вкл/выкл | Кнопки Enable All / Disable All |
| Сортировка | Меню сортировки в заголовке |
| Настройки | Главное меню → Preferences |
| Гайд | Главное меню → Guide |
## Настройки
| | | По умолчанию |
|---|---|---|
| Тема | Системная / Светлая / Тёмная | Системная |
| Язык | Авто / English / Русский | Авто |
| Размер плиток | Small / Medium / Large | Medium |
| Сортировка | По имени / По статусу | По имени |
| Прозрачность окна | вкл / выкл | выкл |
| Тема Wine | Тёмная / Светлая | — |
| Язык CE | EN / RU | — |
## Данные
`~/.config/vual/`
| | |
|---|---|
| config.json | Настройки |
`~/.local/share/vual/`
| | |
|---|---|
| cheatengine/ | Cheat Engine |
| bin/protonhax | protonhax |
| tables/ | .CT-таблицы и привязки |
| wine_prefix/ | Wine-префикс для тестового запуска CE |
`~/.cache/vual/`
| | |
|---|---|
| covers/ | Кэш обложек Steam |
## Участие в разработке
> Это личный проект. Vual создаётся одним человеком для собственного использования при помощи ИИ.
Код полностью открыт. Если хотите помочь — Pull Request и Issue приветствуются:
исправление ошибок, новые функции, переводы.
## Лицензия
[GPL-3.0-or-later](LICENSE)