Diagnostic Central

Mockery Troubleshooting Hub

Encountering unexpected behavior? Whether you're dealing with an unconfigured mock provider, aggressive OEM battery management, WebSocket handshake rejections, or location rubberbanding, our diagnostic guides help you isolate and fix the root cause quickly.

Diagnostic Guides by Symptom

Select the issue you are experiencing for a targeted walkthrough.

📱

Mock Location Not Working

Spoofer says "Not configured", location fails to inject, or the background service terminates when the screen is locked. Fix OEM task killer issues on Samsung, Xiaomi, and Pixel devices.

Fix Mock Provider Issues →

🔌

Connection & WSS Diagnostics

WebSocket connection failed, TLS certificate rejection, port 443 firewall block, or "Authentication requires secure WSS" errors. Step-by-step handshake diagnostics.

Diagnose Connection Errors →

🔄

Simulated Location Jumping

Why does the blue dot snap back to your real physical location for a split second? Learn how to disable Android Wi-Fi location scanning and understand Route Anchor physics.

Prevent Location Rubberbanding →

Use the Spoofer Diagnostic Monitor First

Before diving into manual troubleshooting, open the Monitor tab inside the Mockery Android app. It isolates failures instantly into one of three buckets:

Transport Failure WebSocket state is DISCONNECTED. The problem is network connectivity, DNS, or firewall.

Auth / Provider Failure WebSocket is CONNECTED, but Provider state is AUTH_FAILED. The credentials or device ID are invalid.

Android Injection Failure Coordinates arrive, but Test Provider says UNCONFIGURED. Developer Options was reset.

Still Need Assistance?

Check our master FAQ or review our step-by-step onboarding walkthrough.

Frequently Asked Questions → Getting Started Guide