MerlionRock / RealAndroidBot

MIT License
116 stars 47 forks source link

RealAndroidBot

RAB Video Demo

Changelog

RAB 1.11.0

Note: There is no patch file for this version. You are required to download the full version.

RAB 1.9.0

BREAKING CHANGE From v1.7.1 onwards, PGSharp users using sniper or nearby feed, Joystick MUST be removed (from PGSharp option)

Note for Polygon# Enhancer users: Every enhancer feature can be now used with a free enhancer key with effect from Polygon# Version 0.8.4

You can follow the paid instructions for Polygon# if you want backend data support.

Known Issue

Samsung phones is confirmed not working for the features listed below

  1. Enchanced PGSharp Mode
  2. PGSharp 100IV Shiny Hunting Mode
  3. Fast identification of Pokemon caught status during encounter (Caught, Missed, Escaped, etc)

Changelog History

Discord

Join our Discord Channel

Donation

If you simply want to bless the team, feel free to donate through

Note: The above donation is purely to bless us in our work. There will be no added benefit by donating through the above method

Features

Enhanced Features (Donors Features)

Requires telegram account and donor status

Phone Requirements

  1. Rooted or PGSharp (non-rooted solution)
  2. For rooted phones, you are strongly advise to use Smali Patcher to take advantage of all the features of RAB
  3. Your phone must be able to run Pokemon Go if it's rooted
  4. USB Debugging Enabled (Under Developer Options)
  5. Phone with Screen Resolution 720 x 1280 and above
  6. Recommended 2GB RAM and above
  7. Recommended Snapdragon 625 and above
  8. Additional settings needed for Samsung, Xiaomi and Oppo phones (Refer to Additional Setup required by phone brand below)

System Requirements

64 bit system is required to run RAB (Windows 10 - 64bit)

Release Download

Setting up USB Debugging mode option

  1. Launch the Settings application on your phone.
  2. Tap the About Phone option generally near the bottom of the list.
  3. Then tap the Build Number option 7 times to enable Developer Mode. You will see a toast message when it is done.
  4. Now go back to the main Settings screen and you should see a new Developer Options menu you can access.
  5. Go in there and enable the USB Debugging mode option.

Additional Setup required by phone brand

  1. Xiaomi/Poco phone: Also Enable USB Debugging (Security settings).
  2. Realme/Oppo: Enable "Disable permission monitoring".
  3. Samsung: Settings -> Display -> Navigation bar -> select 'Full screen gesture' and turn-off 'gesture hints'
  4. Check your phone's color display. Make sure it's Natural instead of Vivid. For Samsung users, this setting can be found at Settings > Display > Screen Mode. Other brand and models you have to find this option yourself.

Additional Apps needed and their settings

  1. (Optional) Install Pokemod or HAL or Polygon# or PGSharp Please ensure their enabled/disabled Modules matches with the client settings of RAB
  2. (Pokemod, HAL and Polygon# Only) GPS Joystick, unlock version. Download from their official website You can also use GPS Joystick without any of those 3rd party apps.
    • (Pokemod, HAL, Polygon# Only) Create/download a GPX Route and run it in background. Make sure joystick are hidden from view. GPX Routes in public domain
    • (PGSharp Paid Only) Create/download a GPX Route and run it. Do not hide PGSharp. Move joystick away from location that will block text.
    • (Pokemod, HAL, Polygon# Only) Recommended Speed 7km per hour or less
  3. (Optional, if phone is rooted) Go to playstore and download Easy DPI Changer (or https://www.apkmirror.com/apk/chornerman_studio/easy-dpi-changer-root/). You can use this if your phone resized and you need to reset it immediately. Non-rooted users, you can use the tools tab in RAB to help you reset your phone resolution.
  4. Your Pokemon Go Game MUST BE in English.
  5. When running the scripts at your computer, the following app/services must be running on your phone
    • GPS Joystick (Not needed for PGSharp)
    • (optional) MAD Enhancer, Pokemod Espresso, Pokemod HAL, Polygon# or PGSharp
    • Pokemon Go

Pokemod/HAL Support

Settings

Enable Modules

Disable Modules

Optional Modules

Enable or disable the settings in RAB's GUI accordingly

Polygon# Enhancer Support

Important Note: From Polygon version Polygon# v0.8.4 onwards, all paid enhancer features are now free. Please follow the paid intructions if you want RAB use backend data that's send by Polygon#. Make sure you are using v0.8.4 if you want the paid feature.

Settings for Free version

Advanced

Settings for Paid version

Advanced

Enable or disable the settings in RAB's GUI accordingly

MAD Enhancer Support

Overlay Settings

App Settings

Location Settings

Additional Settings

Inventory Management Settings

Encounter Name Settings

Enable or disable the settings in RAB's GUI accordingly

PGSharp Support

Settings for Free Version

Settings for Paid Version

RAB PGSharp Enhance Mode

RAB PGSharp 100IV Shiny Tap (Donor Feature)

Enable or disable the settings in RAB's GUI accordingly

PC/MAC/LINUX Requirements

Windows users who downloaded the release version, you just need to configure RAB, configure your phone and plug in to your PC and run RAB.exe will do. You do not need to follow the steps below. Remember to ctrl+c when you want to exit from RAB.

Windows users who downloaded the release version, you do not need to read any further!

Install Tesseract

Mac User

  1. Install via Homebrew (https://brew.sh/)
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"
  2. Install Pyhton & Tesseract
    brew install python-tk tesseract
  3. Install ADB
    brew install --cask android-platform-tools
  4. Connect your device to your mac and run the following to see if it can detect your device
    adb devices

Linux

  1. Install tesseract and pyhton via apt by using the command
    sudo apt-get install python-tk
    sudo apt-get install tesseract-ocr
  2. Install adb via apt by using the command
    sudo apt-get install adb

Installing all dependencies via choclatey (Windows User Only)

Installing Git with choclatey and downloading RAB

  1. Open PowerShell as administrator
  2. Use the command choco install git -y to install git. (Type "y" and enter if it prompts to).
  3. Restart your PowerShell or use the command refreshenv(Restarting is recommended).
  4. Enter the C drive directory by using cd C:\
  5. Clone this repo by using the command git clone --recursive https://github.com/MerlionRock/RealAndroidBot.git You will find the RealAndroidBot folder present in the C drive directory after executing this command

Setting up the project

  1. (Windows Only) ==> Open the RealAndroidBot folder (Which is present in the C drive) in FileExplorer.
    • 1.1 (Ubuntu/Linux) Open terminal and type: cd ~/
  2. (Windows Only) ==> Right click on the Install.ps1 and select 'Run with PowerShell'
  3. (Windows Only) ==> The installation will take a little time and it will prompt press any key to continue (press any key) and then u will be directed to the PS C:\Windows\system32> directory.
  4. (Windows Only) ==> Now use cd C:\ and Follow by using python3 -m venv RealAndroidBot Note: If your screen return python after this command, please type in this instead python -m venv RealAndroidBot (Mac and Linux) Follow the same step but skip the cd .. part
  5. Follow by (Mac and Linux) source RealAndroidBot/bin/activate (Windows) RealAndroidBot\Scripts\activate
  6. Follow by cd RealAndroidBot
  7. Back to Terminal or PowerShell, type pip install -r requirements.txt
  8. (Linux) Enter the following to install tkinter sudo apt-get install python3-tk python3-pil python3-pil.imagetk
  9. Follow by cd rab
  10. Setup your phone according to app requirements as instructed above and run all required apps on phone
  11. Make sure your Pokemon Go is at map page and zoomed out to the max.
  12. Make sure your device are connected to your machine, run this command in Terminal or PowerShell python -m uiautomator2 init. Check your phone and allow installation of automator on your Phone
  13. Run python run.py in your terminal or powershell
  14. To run multiple devices, first run adb devices to get all your device ID connected to your computer
  15. Then run each command on their own terminal/shell console python run.py --device-id YOUR_DEVICE_ID
  16. To use a different config file (good for multiple devices setup) run python run.py --device-id YOUR_DEVICE_ID --config-filename YOUR_CONFIG_FILE_NAME
  17. Ctrl + C to terminate the program (you might have to do it more than once)
  18. Whenever you want to run the scripts again, remember to run Step 7 first follow by (mac/linux) cd RealAndroidBot/rab or (Windows) cd RealAndroidBot\rab
  19. To update your files from github repo, type git pull

Troubleshooting

RAB Mess up my screen resolution and my navigation bar went missing!!

(Linux & Mac Users) Open your terminal, type in the following command. (press enter before entering the other) adb shell wm size reset adb shell wm density reset adb shell wm overscan 0,0,0,0

(Windows) Use RAB.exe Under Tool tab, you can reset your phone resolution. Make sure your phone is plugged in.

To prevent it from happening again, always use ctrl+c to close RAB

After entering python run.py, nothing happens or it ask me to install requirements.text when all requirements are already installed

Please ensure that you have installed the required software. Tesseract and adb needs to be installed.

If you are sure you have installed adb, follow this guide to add adb to your system path

If all required are install and you still did not see anything, make sure you have done step 9 correctly.

Additional Steps to if it still doesn't help:

  1. Update your pip by using: python -m pip install --upgrade pip
  2. Reinstall your requirements, cd c:\RealAndroidBot follow by pip install -r requirements.txt

RAB only works with 64bit system. You can't run RAB if you run a 32bit system.

Lastly, for Windows users, when all options failed, just use the .exe version found here

Disclaimer

©2016 Niantic, Inc. ©2016 Pokémon. ©1995–2016 Nintendo / Creatures Inc. / GAME FREAK inc. © 2016 Pokémon/Nintendo Pokémon and Pokémon character names are trademarks of Nintendo. Other trademarks are the property of their respective owners. Privacy Policy

RealAndroidBot is intended for academic purposes and should not be used to play the game PokemonGo as it is unfair to the community. Use the bot at your own risk.