Setup

Before You Begin

Most apps work with GPS JoyStick out of the box. The in-app Setup Wizard handles basic configuration (permissions, Developer Options, mock location app) on first launch. If you need to re-run it, open the navigation drawer and tap Setup & Help.

If you just installed the app and have not tried it yet, start with the User Guide. You may not need anything on this page.

This page is for advanced setup when testing apps that actively check the mock-location flag. Your results will vary depending on your device, Android version, and the verification methods used by the app you are testing.

Before choosing a method below:

1. Download and install the unlocked version for your device.
2. Make sure the Setup Wizard has been completed, or manually ensure Developer Options and Mock Locations are enabled.

Overview

There are three setup approaches for apps that read the mock-location flag. Each has different requirements and tradeoffs.

• Smali Method: Patches the OS to hide mock locations from all apps. Most reliable when it works.
• Root Method: Roots the device and gives GPS JoyStick system-level GPS access.
• No Root Method: Uses GPS JoyStick's built-in features that handle apps with active mock-location checks. Limited to older devices.

Smali Method

The Smali method patches Android's location stack at the OS level so that mock-location flags are never exposed to apps. Many users find this the most reliable approach with the least location drift.

How it works: A modified services.jar (or equivalent module) removes the FLAG_MOCK_LOCATION bit from location objects before any app can read it. Once applied, apps reading the FLAG_MOCK_LOCATION bit on each fix do not see the bit set, and apps scanning for mock providers do not find one registered.

What you need to know:

• The original Smali Patcher tool (by fOmey) created Magisk modules that automated this patch. It only supports Android 9 through 11, and the developer has been inactive since 2022. If you find references to it online, be aware that it will not work on Android 12+.
• For Android 11 and later, the LSPosed/Xposed framework approach is the modern equivalent. It achieves the same result (hiding mock-location flags) through runtime hooking rather than static patching.
• If you are using Magisk alongside this method, set up Play Integrity & Magisk Module so that other apps on your device continue to function normally.

Caution

OS-level patches carry risk. A bad patch can cause boot loops. Always have a recovery method (TWRP, stock firmware image) before attempting this.

Root Method

Rooting gives GPS JoyStick direct access to the device's location stack, operating below the standard Android mock location API entirely.

How it works: On a rooted device, GPS JoyStick accesses Android's internal location manager service via reflection rather than using Android's setTestProviderLocation API, which is what triggers mock location detection in other apps.

Modern rooting:

The rooting landscape has changed significantly since 2018. One-click root tools (Kingroot, Towelroot) no longer work on modern Android. The three frameworks that work in 2026 are Magisk, KernelSU, and APatch, all systemless and actively maintained. See Rooting Android in 2026 for a full comparison and step-by-step instructions.

After rooting:

1. Set up Play Integrity & Magisk Module so apps that check device integrity (banking, payments) continue to work.
2. Enable System Mode in GPS JoyStick Settings.

Note

System Mode in GPS JoyStick requires the INSTALL_LOCATION_PROVIDER permission, which is only granted to system-level apps. This only works reliably on Android 9 and below. Android 10 introduced restrictions on hidden API access via reflection, which is the mechanism System Mode uses internally. The Smali method or LSPosed approach is recommended for modern Android versions.

No Root Method

The no-root approach uses GPS JoyStick's built-in features that handle apps with active mock-location checks. It does not require rooting or modifying the OS, but it is limited to older devices that have not received recent security updates.

What GPS JoyStick offers without root:

• Suspended Mocking: Broadcasts a mock location briefly, then pauses so the target app reads the last known location instead of detecting an active mock provider.
• Indirect Mocking: Routes mock locations through the Network provider only, rather than all location providers. Apps that check the GPS provider specifically for mock-location flags will not detect it. Most effective on devices with security patches before March 2017.
• Privacy Mode: Generates a cloned copy of GPS JoyStick under a name you choose, with a randomized package identifier and a recolored launcher icon, so apps scanning installed packages will not match it against the original GPS JoyStick package.

See Unlock Features for details on each of these options and how to enable them.

Regarding Google Play Services downgrade:

Older guides recommend downgrading Google Play Services to version 12.6.85 (from 2018). This is extremely unlikely to work on any device updated after 2019. Google Play Services enforces minimum version requirements, and modern Android will auto-update or refuse to function with a version that old. If you have an older device that has never been updated, it may still be possible, but this is not a viable approach for most users.

Security patch considerations:

Your device's Android security patch level (Settings > About Phone > Android Security Patch Level) determines which setup methods are available:

• Security patch after March 2017: Suspended Mocking is the primary no-root option.
• Security patch before March 2017: Indirect Mocking may also work on these older patches.