🎮 GPad2Xbox v1.0 [ROOT]

Transform ANY Cheap Gamepad into a Native Microsoft Xbox 360 Controller on Android (Kernel-Level).

Tired of competitive games not recognizing your generic gamepad? Afraid of getting your account banned for using overlay mapping apps like Mantis or Octopus?

GPad2Xbox is a lightweight, system-level Python driver that reads your generic gamepad inputs and translates them directly into a virtual Official Xbox 360 Controller at the Linux Kernel level (/dev/uinput).

---

🔥 WHY DO YOU NEED THIS? (The Magic)

Many modern Android games and emulators strictly require an official Xbox or PlayStation controller to enable Native Gamepad support. If you use a cheap generic gamepad (like the X3, T3, or a PS2 to USB converter), the game simply ignores it.

With GPad2Xbox, you get:

• 🛡️ Zero Overlay & Anti-Ban: The game thinks you plugged in a real $60 Microsoft Xbox 360 Controller. No accessibility services or floating apps running.
• ⚡ Zero Latency: Pure kernel-level injection.
• 🎯 Digital-to-Analog Trigger Conversion: Cheap gamepads often have "clicky" L2/R2 buttons instead of analog triggers. GPad2Xbox magically converts these digital clicks into full 255 Analog Axis signals!

🏆 SUPPORTED AAA GAMES & EMULATORS

Because your phone now detects a native Xbox Controller, you unlock full support for:

• BloodStrike (Crucial: This game strictly requires LT/RT Axis to Aim/Shoot. GPad2Xbox fixes this automatically!)
• Call of Duty: Mobile (CODM) & Warzone Mobile
• Genshin Impact (Switch from Touch to Controller in settings!)
• Racing Games: Grid Autosport, CarX Street, Real Racing 3.
• Heavy Emulators: AetherSX2 (PS2), Yuzu/Sudachi (Switch), Dolphin (Wii).

---

📱 TESTED ON DEVICES

GPad2Xbox has been rigorously tested and confirmed working on:

• Realme 8i (Android 11 - 64-bit / Magisk)
• STB HG680P (Android 6.0 - 32-bit / SuperSU)
• Samsung Galaxy Note 3 (HA3G) (Custom ROM Android 7.1.2 - 32-bit / Magisk)
• (Should work on almost all Rooted Android devices running Android 5.0 up to Android 14+).

---

🛠️ PREREQUISITES

1. Root Access: SuperSU, Magisk, KernelSU, or APatch.
2. Python Environment for 64-bit devices: You MUST install Py2Droid (Python for Magisk). 👉 Download Py2Droid Here
3. Python Environment for 32-bit devices: If you are using a non-Magisk device (SuperSU) or an old STB, please follow our Python Transplantation Guide here.

---

📂 FOLDER STRUCTURE

Inside the ZIP file, you will find this exact structure:

GPad2Xbox_v1.0.zip
├── GPad2Xbox/
│   ├── config.json
│   ├── mapper.py
│   └── gpad2xbox_v1.0.py
├── README.md
└── service.d/
    └── xbox_boot.sh

---

📦 INSTALLATION GUIDE

1. Install Python: You can use Py2Droid (Magisk Module) for 64-bit devices or use the Transplant Method for 32-bit devices.
2. Extract the ZIP: Extract the downloaded GPad2Xbox ZIP file to your internal storage.
3. Copy the Core Folder: Move the entire GPad2Xbox folder into your internal storage root: 👉 /sdcard/GPad2Xbox/
4. Copy the Boot Script: Move the xbox_boot.sh file into the Magisk service directory: 👉 /data/adb/service.d/
5. Set Permissions & Run: Open your Terminal App (e.g., Terminal Emulator), grant Root access, and run the boot script:

   su
   chmod +x /data/adb/service.d/xbox_boot.sh
   sh /data/adb/service.d/xbox_boot.sh

6. Wait & Play: Wait about 5-10 seconds. Connect your Gamepad. Open your favorite game and enjoy Native Xbox Support!

⚙️ FOR NON-MAGISK USERS (SuperSU / Legacy Root)

If you are not using Magisk, the xbox_boot.sh script will not run automatically on boot. You need to inject it into your system's recovery script.

Open your Terminal App, grant su, and run these commands exactly:

su
mount -o rw,remount /system
echo "sh /data/adb/service.d/xbox_boot.sh &" >> /system/etc/install-recovery.sh
chmod 755 /system/etc/install-recovery.sh

Now your GPad2Xbox engine will survive reboots even without Magisk!

---

🎥 INSTALLATION GUIDE VIDEO

(Click the image below to watch the full tutorial, including Python Transplantation on 32-bit devices and how to use the Mapper!)

(Note: The video below shows how to install GPad2Mouse, but you can still follow this video to install GPad2Xbox)

---

🛠️ TROUBLESHOOTING (THE MAPPER TOOL)

If you have run the script but your gamepad is not responding inside the game, your gamepad's Vendor/Product ID is probably not in our default database.

We included a Universal Configurator (Mapper) to fix this:

1. Connect your Gamepad to your device.
2. Open your Terminal App (su) and run:

   su
   python3 /data/adb/gpad2xbox/mapper.py

3. Follow the on-screen interactive instructions to map your buttons.
4. Once completed, the script will restart automatically. Your generic gamepad is now an Xbox Controller! 🎮

---

☕ SUPPORT THE DEVELOPER (OPTIONAL)

This project is 100% FREE and Open Source. However, I spent sleepless nights reverse-engineering Android kernel inputs to make this work. If this tool saved your gaming experience (and saved you $60 from buying an original Xbox controller), please consider buying me a cup of coffee! ☕

You can support me by downloading the exact same GPad2Xbox ZIP file through my sponsor link below. It only takes a quick verification step (Survey/App Install) and it helps me keep this project alive!

👉 SUPPORT ME & DOWNLOAD ZIP HERE

---

🙏 CREDITS & ACKNOWLEDGEMENTS

• Huge thanks to Mrakorez for creating Py2Droid.
• Script developed and optimized by ZHStore Tech-Lab © 2026.