77 lines
4.7 KiB
Markdown
77 lines
4.7 KiB
Markdown
# PerfectKachalka
|
||
|
||
Бот для мини-игры со шкалой навыка (skill-check): синяя полупрозрачная шкала
|
||
с движущимся курсором и двумя цветными зонами. Бот распознаёт шкалу, зону и
|
||
курсор по экрану и нажимает `E` в нужный момент.
|
||
|
||
## Требования
|
||
|
||
- Игра запущена в режиме **Exclusive Fullscreen** (не оконный безрамочный) -
|
||
это нужно для `bettercam`, который умеет захватывать такой режим.
|
||
- Зависимости уже установлены в `.venv` (`opencv-python`, `numpy`,
|
||
`bettercam`, `pydirectinput`, `keyboard`, `mss`). При необходимости
|
||
переустановить: `.venv\Scripts\python.exe -m pip install -r requirements.txt`.
|
||
|
||
## Проверка детекции (опционально, но рекомендуется)
|
||
|
||
```
|
||
.venv\Scripts\python.exe debug_snapshot.py
|
||
```
|
||
|
||
- Скрипт ждёт 5 секунд - успейте переключиться в игру так, чтобы шкала
|
||
мини-игры была видна на экране.
|
||
- После снимка он напечатает найденные координаты шкалы/зоны/курсора и
|
||
сохранит `debug_snapshot.png` с нарисованными рамками: синяя рамка - шкала,
|
||
красная - узкая (целевая) зона, пурпурная линия - курсор.
|
||
- Если что-то не нашлось, скрипт сохранит `debug_full.png` (полный кадр без
|
||
рамок) - по нему можно подправить пороги в `config.py`.
|
||
|
||
## Запуск бота
|
||
|
||
```
|
||
.venv\Scripts\python.exe bot.py
|
||
```
|
||
|
||
- В консоли появится строка `Захват экрана: bettercam` (или `mss`, если
|
||
bettercam не сработал - тогда эксклюзивный фуллскрин может не
|
||
захватываться).
|
||
- Переключитесь в игру.
|
||
- **F6** - включить/выключить бота. При включении он один раз сканирует
|
||
экран на наличие шкалы (повторяет попытку раз в секунду, если шкала пока
|
||
не видна).
|
||
- **Ctrl+C** в консоли - полностью завершить программу.
|
||
|
||
## Если игра запущена с правами администратора
|
||
|
||
`pydirectinput` может не достучаться до окна игры из-за защиты Windows
|
||
(UIPI), если игра имеет более высокие привилегии, чем консоль. В этом случае
|
||
запускайте терминал/`bot.py` от имени администратора.
|
||
|
||
## Подстройка таймингов
|
||
|
||
При каждом нажатии E в консоли печатается строка вида:
|
||
|
||
```
|
||
[Bot] E нажата | cursor_x=... predicted_x=... zone=(...,...) | задержка цикла=... мс
|
||
```
|
||
|
||
- Если E срабатывает **позже**, чем курсор визуально входит в узкую зону -
|
||
увеличьте `CURSOR_LEAD_TIME` в `config.py`, шаг ~0.02-0.03.
|
||
- Если E срабатывает **раньше** входа в зону - уменьшите его.
|
||
- Если "задержка цикла" заметно больше ~16 мс - система не успевает за
|
||
60 FPS, это тоже добавляет задержку.
|
||
- Если в одном проходе курсора через зону E срабатывает несколько раз -
|
||
потребуется сглаживание скорости курсора (сообщите, чтобы добавить).
|
||
|
||
Изменения в `config.py` применяются после перезапуска `bot.py`.
|
||
|
||
## Структура проекта
|
||
|
||
- `bot.py` - основной цикл: поиск шкалы, отслеживание курсора, нажатие `E`,
|
||
переключение по F6.
|
||
- `vision.py` - распознавание шкалы/зон/курсора по кадру (OpenCV/HSV).
|
||
- `capture.py` - захват экрана (`bettercam`, с откатом на `mss`).
|
||
- `input_sender.py` - отправка нажатия клавиши (`pydirectinput`).
|
||
- `config.py` - все настраиваемые пороги и параметры.
|
||
- `debug_snapshot.py` - однократный снимок экрана с визуализацией найденных
|
||
шкалы/зоны/курсора, для отладки.
|