Debug Overlay

A topmost diagnostic panel that displays the AI pipeline’s live state — FPS, inference time, detection count, the active intent / profile / process, plus optional OCR readouts, an AutoPlay activity log, and a sent-input visualizer.

What it does

The Debug Overlay is a compact panel — small enough to fit in a corner of the screen — that updates every UI tick with:

  • FPS — instantaneous frames per second of the AI loop
  • Inference (ms) — how long the last ONNX forward pass took
  • Detections — number of detection boxes on the current frame
  • Shots — total triggers fired this session
  • Intent — AutoPlay’s current strategic intent ( when idle)
  • Profile — the active aim profile name
  • Process — the focused process PowerAim is acting on
  • OCR readings — a middle column with every enabled OCR region and its live recognised value (hidden when OCR is off)
  • AutoPlay activity log — a right-hand column: a rolling list of the last 8 strategic intents / tactical actions / OCR cues with timestamps (hidden when AutoPlay is off)

The OCR and AutoPlay columns appear only when their feature is enabled, so the panel stays compact when you’re just watching FPS.

The panel follows the capture source: it subscribes to ICapture.PropertyChanged and repositions live when you change the captured monitor or process window from the title bar — no more stranded overlays after picking a non-primary monitor.

How to enable

Settings → Overlays → Show Debug Overlay

You can also bind a global hotkey to flip it on/off via the keybind chip next to the toggle.

Sent-input visualizer

Settings → Overlays → Show sent-input visualizer adds a live input diagram inside the debug overlay, showing exactly what PowerAim is sending — useful for confirming that triggers, mapping, and gamepad aim are emitting the inputs you expect.

The visualizer draws:

  • A keyboard + mouse diagram — keys and mouse buttons glow as PowerAim presses them, and the mouse shows an arrow indicating the current aim-movement direction.
  • An Xbox controller diagram — face buttons / bumpers glow, the triggers fill as they’re pulled, and the sticks deflect as PowerAim moves them (e.g. the right stick during gamepad aim).

Turn this on while testing a controller mapping or a charge-mode trigger — it’s the fastest way to confirm the right button is firing at the right moment without alt-tabbing.

Tips

  • Run it once when setting up a new model. If “Detections” stays at 0 in a game where you can see enemies, the model isn’t recognizing the game’s art style — switch models or use the Models guide.
  • Watch the inference-time field. If it’s consistently > 16 ms you’re below 60 FPS — run the benchmark and consider a smaller image size.
  • Combine with the FOV Overlay. When the FOV ring is on AND the debug overlay shows detections, you can visually confirm whether targets are inside the ring or being clipped.

Troubleshooting

  • Debug Overlay is captured by my screen recorder — disable Hide UI from Capture on the Settings page if you want OBS to see it.
  • “FPS 0.0” forever — Global Active is off, or no model is loaded. The AI loop doesn’t run otherwise.
  • Inference time spikes during alt-tab — expected; capture pauses during foreground transitions.

See also: Session Stats for the same numbers in a non-overlay card on the Settings page.


PowerAim is source-available under PolyForm Noncommercial. Commercial use prohibited.

This site uses Just the Docs, a documentation theme for Jekyll.