Awareness Engine Guide

Overview

The Awareness Engine monitors your screen and keyboard in real time, looking for specific keywords. When it detects a match, it fires a configurable mix of actions — audio cues, visual effects, haptic feedback, avatar comments, XP rewards, and more.

Key features:

• Two signal sources — Screen OCR scans what's visible on your display; Keyboard Capture reads what you type
• Preset packs — 4 built-in themed presets you can install with one click
• Composable actions — Each trigger keyword can fire any combination of 8 action types
• Word highlighting — Matched words get colored overlay boxes on screen
• Anti-loop protection — Multiple layers prevent triggers from re-triggering themselves

Signal Sources

Screen OCR

Periodically takes a screenshot and runs optical character recognition to find keywords visible on your display. Best for catching words in web pages, chat apps, documents, and games.

• Scans every few seconds (configurable, default 3 seconds)
• Tracks word positions — each word instance fires exactly once while visible on screen
• Position bucketing prevents re-firing when text shifts slightly from typing or scrolling
• CCP's own windows are filtered out by default to prevent self-triggering

Keyboard Capture

Maintains a rolling text buffer of what you type. Fires instantly when a keyword is completed — no waiting for the next OCR scan.

• 200-character rolling buffer
• Buffer resets after 3 seconds of inactivity (configurable)
• Supports whole-word matching — typing "sit" won't trigger from "intensity"
• Multi-word keywords match consecutive words in order

Built-in Presets

Four themed preset packs ship with CCP. Install any of them with one click from the Awareness tab.

Action Types

Each trigger keyword can fire any combination of these actions. When multiple triggers match the same OCR scan, their actions are merged and deduplicated.

Word Highlighting

When a keyword is detected via OCR, a colored overlay box appears at the word's position on screen.

• Color — Default neon pink (#FF69B4), customizable in settings
• Duration — 1.5 seconds by default (300ms–5000ms range)
• Modes — Highlight all new instances, or a random subset per scan
• Capture visibility — Hidden from screen capture by default, so highlights don't appear in the next OCR scan and cause loops

Preset Editor

Installing Presets

1. Open the Awareness tab
2. Browse available presets
3. Click Install to add a preset's triggers to your active list
4. Toggle presets on/off with the master switch

Managing Presets

• Uninstall — Removes the preset's triggers from your active list
• Clone — Creates a copy you can customize without affecting the original
• Updates — Built-in presets auto-update when a newer version ships with CCP

Custom Triggers

Add your own keywords and actions:

1. Click Add Trigger in the Awareness tab
2. Enter a keyword (plain text or regex pattern)
3. Add one or more actions (audio, visual, haptic, etc.)
4. Set a per-trigger cooldown (how long before it can fire again)
5. Save and enable

Safety Features

Multiple layers of protection prevent runaway loops and accidental spam.

Settings Reference