Automation Runtime
Automation Runtime executes a separately prepared GUI script based on the Screph project. It looks for visual or textual states, waits for the condition, and sends commands to the selected input method.
What you need to start
- The saved project GUI Automation with the necessary elements and visual features.
- A separate Python script that explicitly opens the project and specifies the sequence of actions.
- Prepared dependencies for script, image search and optional OCR.
- Tested input method: Arduino HID or FakerInput Virtual HID.
Check before execution
Before running, Screph checks that the project is readable and contains the required data. This does not guarantee that the correct window is open, has the correct scale and theme, or is on the expected monitor. These conditions must be checked by the script immediately before the action.
Search for targets
| Method | When it suits |
|---|---|
| Image matching | For a stable visual pattern with a known scale and interface state. |
| OCR | For text that can change position but remains readable. |
| Coordinates and area | For a limited search in a known part of the selected monitor or window. |
Templates depend on scale, theme, window state, and source image quality. After searching, the script must check for the expected state before sending the input.
Input methods
- FakerInput Virtual HID uses a system driver that is installed separately with confirmation Windows.
- Arduino USB HID uses a compatible external device with prepared firmware.
If the selected input method is not available, Automation Runtime displays an error and does not automatically switch to another method.
Start and stop
- Open the project and script in Automation Manager.
- Check the target window, monitor, scale, and input method.
- Run the script under supervision and keep an emergency stop available.
- After each important action, check the expected state of the interface.
Security
- The script runs with the rights of the running program and can read or modify files available to it.
- Do not run an untested script and keep the working folder in version control or a backup.
- Do not use the Alpha version for unobserved management of critical systems.
Typical problems
- Template not found: check the scale, theme, window state, search area and quality of the template.
- Text not found: check Tesseract, language OCR and area quality.
- Coordinates are shifted: check the monitor, Windows scale and window position.
- Input does not start: re-check the selected input method and the target window's permission level.