Troubleshooting
When things go wrong, start here. Each page walks through diagnostics for a specific symptom.
By symptom
- Gamepad Not Detected — virtual gamepad doesn’t appear in games, ViGEm/HidHide issues
- Model Won’t Load — ONNX errors, missing classes, “model failed to load”
- Low FPS — AI loop running below 60 FPS, lag, input feels heavy
- OCR Not Working — Tesseract data, region setup, garbage results
- Controller Aim Has No Effect — virtual right-stick doesn’t move the in-game camera
General first-aid
Before diving into a specific page, try these:
- Toggle Global Active off and back on. Resets the AI loop, capture, and senders.
- Reload the config. Cogwheel → Open Quick Config. Clears any in-memory state divergence.
- Restart PowerAim. Especially useful after driver installs (ViGEm, HidHide).
- Restart as admin. Title bar → “Restart as admin” button. Some operations (Device Disable, HidHide management) require elevation.
- Check the in-app log. Sidebar → Logs. PowerAim writes diagnostic output there.
- Run the Performance Benchmark. Models tab → Run Benchmark. Confirms inference path is healthy.
If none of those help, find the relevant troubleshooting page below — most include checklists you can walk through.
Reporting bugs
Found something the docs don’t cover? Open an issue at github.com/fgilde/AI-Ming/issues. Include:
- PowerAim version (visible on the About page)
- Build flavor (DirectML / CUDA)
- Windows version
- GPU + driver version
- A short repro
- Bonus: a replay buffer export of the moment things went wrong