Conditional Events
Conditional Events (Sessions) let you create smart automation that responds to screen changes. Combine patterns with triggers to build powerful workflows.
What is a Session?
A session is a collection of conditional events that run together. Each event consists of:
- 1A Pattern
The click/keyboard sequence to execute
- 2A Condition
When to execute the pattern
- 3A Trigger (optional)
The color trigger to check for color-based conditions
Condition Types
Each event can have one of four conditions:
Disabled
The event is skipped. Useful for temporarily disabling an event without deleting it.
Always Run
The pattern runs continuously regardless of any trigger. Use this for patterns that should always execute.
Color Trigger Match
The pattern runs only when the selected trigger's color matches. Use this to react when something appears or changes to a specific color.
Color Trigger Not Matched
The pattern runs only when the trigger's color does NOT match. Use this to react when something disappears or changes away from a color.
Creating a Session
- 1. Go to Sessions Tab
Click "Sessions" in the sidebar.
- 2. Create a New Session
Enter a name and click "Create Session".
- 3. Add Events
Click "Add Event" to add conditional events to your session.
- 4. Configure Each Event
For each event, select:
- • The pattern to run
- • The condition type
- • The trigger (if using color conditions)
- 5. Save the Session
Click "Save Session" to store your configuration.
Running Sessions
When you start a session:
- 1. All events in the session are evaluated continuously
- 2. When a condition is met, the associated pattern runs once
- 3. The session continues checking and executing until stopped
Visual Feedback
When a session is running, you'll see:
- • A flicker animation when events execute
- • The currently active event highlighted
- • Real-time color values for triggers being monitored
Stopping Sessions
Press F10 (default) or click the "Stop" button to stop the session.
Example Workflows
🎮 Game Automation
Automatically use abilities when they come off cooldown:
- • Trigger: Monitors the ability icon color
- • Condition: "Color Trigger Match" (when ability is ready)
- • Pattern: Presses the ability hotkey
📊 Data Entry
Process items when a "Ready" indicator appears:
- • Trigger: Monitors a status indicator
- • Condition: "Color Trigger Match"
- • Pattern: Clicks buttons to process the item
🔄 Background Tasks
Continuously perform an action:
- • Condition: "Always Run"
- • Pattern: Performs the repeated action
- • Add delays in the pattern to control speed