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 - однократный снимок экрана с визуализацией найденных шкалы/зоны/курсора, для отладки.