Project Clickable
документация

Шаги сценария

Описание всех типов блоков визуального редактора: параметры, значения по умолчанию и выходы.

Общие параметры. У каждого шага есть поле Описание (комментарий для себя) и опция Продолжить при ошибке — сценарий не остановится, если шаг завершится неудачей.
изображения

Поиск на экране

Ждать

WaitImage основной

Ожидает появления изображения на экране. Программа периодически делает скриншот и сравнивает его с шаблоном. Когда изображение найдено — сохраняет координаты центра для последующего клика.

ИзображениеКартинка для поиска из реестра проекта
Порог (0–1)Минимальный процент совпадения0.8
Таймаут (сек)Максимальное время ожидания30
ПодтвержденийСколько раз подряд нужно найти3
Сохранить XY вПеременная для координат найденного
trueизображение найдено falseтаймаут

Исчезновение

WaitDisappear

Ожидает исчезновения изображения с экрана. Полезно для ожидания закрытия окон и завершения загрузки. Исчезновение подтверждается несколькими проверками подряд.

ИзображениеКартинка для отслеживания
Порог (0–1)Минимальный процент совпадения0.8
Таймаут (сек)Максимальное время ожидания30
ПодтвержденийСколько раз подряд не найти3

Ждать любую

WaitAny

Ожидает появления любого изображения из списка. Полезно, когда экран может оказаться в разных состояниях. Сохраняет номер найденной картинки.

ИзображенияСписок картинок для поиска
Порог (0–1)Минимальный процент совпадения0.8
Таймаут (сек)Максимальное время ожидания30
Сохранить вПеременная для номера найденной картинки (1, 2, 3…)
LastFoundPointкоординаты LastFoundKeyключ картинки Переменнаяномер в списке

Найти все

FindAllImages

Находит все вхождения изображения на экране и возвращает список координат. Полезно для подсчёта объектов или перебора их по очереди (вместе с шагом «Перебор точек»).

ИзображениеКартинка для поиска
Порог (0–1)Минимальный процент совпадения0.8
СортировкаСортировать найденное сверху внизвыкл
Сохранить вПеременная для количества найденных
Переменнаяколичество найденных Переменная[0], [1]…координаты каждого

Прокрутка до

ScrollUntilFound

Прокручивает экран, пока не найдёт изображение. После каждой прокрутки делает паузу и проверяет снова. Полезно для поиска в длинных списках.

ИзображениеКартинка для поиска
НаправлениеВверх или внизвниз
ЩелчковКоличество щелчков колеса за одну прокрутку3
Макс. попытокСколько раз прокрутить, прежде чем сдаться10
Задержка (мс)Пауза между прокрутками500
Foundизображение найдено NotFoundлимит попыток исчерпан

Пока не найдёт

RepeatUntilFound

Периодически проверяет наличие изображения с заданным интервалом. Между проверками выполняет действия из ветки NotFound и автоматически возвращается к началу — стрелку возврата рисовать не нужно.

ИзображениеКартинка для поиска
Макс. попытокМаксимум итераций; 0 — без ограничения10
Интервал (мс)Пауза между проверками1000
Foundизображение найдено NotFoundпопытки исчерпаны
действия

Мышь, клавиатура, паузы

Клик

Click основной

Клик мышью по последней найденной позиции. Обычно ставится после «Ждать», «Ждать любую» или «Если найдено».

Сохранить позициюЗапомнить координаты клика
В переменнуюИмя переменной для координат

Клик XY

ClickCoords

Клик по заданным координатам. Координаты можно указать вручную или взять из переменной. Есть режим «только переместить» — курсор двигается без клика.

X, YКоординаты для клика
Из переменнойИли переменная с координатами вида «X,Y»

Текст

Text

Вводит текст с клавиатуры. Текст задаётся напрямую или берётся из переменной.

Текст для вводаСтрока, которую нужно ввести
Из переменнойИли взять текст из переменной

Клавиша

KeyPress

Нажимает клавишу: Enter, Space, Tab, Escape, стрелки, F1–F12 и другие.

КлавишаEnter, Space, Tab, Escape, Up, Down, F1–F12…
ПроцессАктивировать окно перед нажатием (опционально)

Прокрутка

Scroll

Прокручивает колесо мыши вверх или вниз на указанное количество щелчков.

НаправлениеВверх или внизвниз
ЩелчковКоличество щелчков колеса3
Задержка (мс)Пауза между щелчками10
ПозицияТекущее место курсора, координаты вручную или из переменной

Пауза

Delay

Простая пауза на указанное время — для ожидания анимаций и загрузки.

Задержка (мс)Время паузы в миллисекундах1000
логика и циклы

Ветвления и повторы

Если найдено

IfFound ветвление

Проверяет, есть ли изображение на экране прямо сейчас, без ожидания. При нахождении сохраняет координаты — можно сразу кликнуть.

ИзображениеКартинка для проверки
Порог (0–1)Минимальный процент совпадения0.8
Foundизображение найдено NotFoundне найдено

Условие ==

IfVariableEquals ветвление

Сравнивает переменную со значением на равенство. Можно указать несколько значений через точку с запятой — сработает, если совпадёт любое (например «1;6»).

ПеременнаяИмя проверяемой переменной
Сравнить сЗначение, список значений через «;» или имя другой переменной
Trueравны Falseне равны

Условие >

IfVariableGreater ветвление

Проверяет, больше ли числовая переменная указанного значения. Дробные числа можно вводить и с точкой, и с запятой.

ПеременнаяИмя переменной (число)
Сравнить сЧисло для сравнения
Trueпеременная больше Falseменьше или равна

Условие <

IfVariableLess ветвление

Проверяет, меньше ли числовая переменная указанного значения.

ПеременнаяИмя переменной (число)
Сравнить сЧисло для сравнения
Trueпеременная меньше Falseбольше или равна

Повтор

Repeat цикл

Цикл, который выполняется указанное количество раз. Счётчик сбрасывается при выходе.

ПовторитьКоличество повторений1
Loopочередная итерация Exitвыход из цикла
Как соединять: выход «Loop» → первый шаг тела цикла → … → обратно к «Повтору». Выход «Exit» → следующий шаг после цикла.

Для каждого

ForEachSequence цикл

Перебирает значения последовательности (например «1,2,3,4») и выполняет действия для каждого элемента. После тела цикла автоматически возвращается к началу — стрелку возврата рисовать не нужно.

ПоследовательностьИмя параметра или переменной с последовательностью
Текущий элементПеременная, куда записывается текущее значение
Loopдействия для текущего элемента Exitвсе элементы обработаны
Пример: параметр action_sequence = «1,2,3,4». На каждой итерации переменная current_action получает «1», «2», «3», «4» — внутри цикла ветвимся условием «если current_action == 1 → …».
переменные

Счётчики и значения

Установить

SetVariable

Устанавливает значение переменной. Тип определяется автоматически: число, логическое значение или строка.

ДействиеУстановить значение / Прибавить 1 / Убавить 1
ИмяИмя переменной — новое или из списка
ЗначениеЧисло, текст или true/false
Примеры: counter = 0 → число · name = "player1" → строка · enabled = true → логическое

Увеличить

IncrementVariable

Увеличивает числовую переменную на 1. Тот же редактор, что и у «Установить», с действием «Прибавить 1».

ИмяИмя переменной

Уменьшить

DecrementVariable

Уменьшает числовую переменную на 1. Тот же редактор, что и у «Установить», с действием «Убавить 1».

ИмяИмя переменной
окна

Работа с окнами

Активировать

BringWindowToFront

Выводит окно целевого процесса на передний план; свёрнутое окно автоматически восстанавливается из панели задач. Процесс берётся из настроек сценария.

trueокно активировано falseокно не найдено

Клик в центр

ClickWindowCenter

Клик по центру окна целевого процесса. Если процесс не указан — кликает по центру экрана.