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