Color Triggers
Color triggers detect specific pixel colors on your screen. When used with Conditional Events, they can automatically start or stop patterns based on what's happening on screen.
What is a Color Trigger?
A color trigger monitors a specific pixel location on your screen and checks if the color at that location matches a target color. This is useful for:
- •Detecting when a button becomes active (color change)
- •Waiting for a loading screen to finish
- •Reacting to game events (health bars, cooldowns, notifications)
- •Automating based on UI state changes
Creating a Trigger
- 1. Go to the Triggers Tab
Click "Triggers" in the sidebar to open the triggers page.
- 2. Start Polling
Click "Start Polling" to begin monitoring your mouse position and the pixel color under it.
- 3. Position Your Mouse
Move your mouse to the exact pixel you want to monitor. The current color (RGB values) will be displayed.
- 4. Capture the Point
Press A (or your configured hotkey) to capture the position and color.
- 5. Set Tolerance
Adjust the tolerance slider if needed (see below).
- 6. Save the Trigger
Enter a descriptive name and click "Save Trigger".
Tolerance Settings
Colors on screen can vary slightly due to anti-aliasing, compression, or lighting effects. The tolerance setting allows for approximate color matching.
How Tolerance Works
Tolerance is the maximum allowed difference for each RGB component. A tolerance of 10 means each color channel (R, G, B) can differ by up to 10 from the target.
Recommended Values
- • 0-5: Exact match (use for solid colors)
- • 10-20: Slight variation (recommended default)
- • 30-50: Moderate variation (for gradient areas)
- • 50+: Loose matching (may cause false positives)
Tip: Start with a low tolerance and increase it if the trigger isn't firing reliably. Too high a tolerance may cause false matches.
Testing Triggers
Before using a trigger in a Conditional Event, you should test it:
- 1. Look at the trigger in your saved list
- 2. The trigger shows its target color as a colored square
- 3. When polling is active, it also shows the current color at that position
- 4. Compare the colors to verify the trigger will match when expected
Testing Tips
- • Make sure the target window/application is visible and in the same position
- • Check that nothing is overlapping the trigger pixel (tooltips, notifications)
- • Some applications scale differently - test at the actual resolution you'll use
Using Triggers in Sessions
Triggers become powerful when combined with Conditional Events. You can set up rules like:
- ✓"Run Pattern A when the button turns green"
- ✓"Run Pattern B when the loading bar disappears"
- ✓"Run Pattern C when the notification is NOT showing"
Learn more in the Conditional Events documentation.