Girls' Frontline Android Auto

This project aims to provide a basic Android-only implementation of automation for the popular mobile game, Girls' Frontline using existing system services such as the Accessibility Service for executing taps/swipes and the MediaProjection Service for screenshots. A similar, more sophisticated bot is located at WAI2K.

Table of Contents

• Features
• Requirements
• Instructions
• Technologies used

Disclaimer

This application is developed with educational purposes in mind while exploring the potentials of automation and computer vision technologies. Also, the project is in its infancy so expect bugs.

Features

• Run a variety of maps to farm EXP and Cores.
  • 0-2
  • 2-3
  • 4-3e
  • 5-2e
  • 0-4
  • 11-5
• Use specified Dummy and DPS Echelons.
  • Swaps out DPS between Echelons for Corpse Dragging.
• Enhance/Dismantle excess T-Dolls.
• Detect what T-Doll dropped as a reward during combat/operation end via Tesseract OCR.
• Optional Discord integration for status and T-Doll alerts.
• Optional integration with website (pending name and development) for statistical analysis like Granblue Automation Statistics

Requirements

1. Android Device or Emulator (Nougat 7.0+)
   1. Tested emulator was Bluestacks 5 with the following settings:
      • P64 (Beta)
      • 1080x1920 or 1920x1080
      • 240 DPI
      • 4+ GB of Memory

Instructions

1. Download the latest release by clicking on the "Releases" button on the right side of the page.
2. Start up the application and head to the Settings page.
3. Tweak the settings to your needs including which echelons to deploy, corpse dragging behavior, etc.
4. Now head back to the Home page and press the "Start" button to begin the process of setting up the necessary permissions to be used by the bot.
5. When done, pressing the "Start" button again will bring up the floating overlay button.
6. Head into Girls' Frontline and start the bot on the home screen. Recommended to put the floating overlay button on the bottom left.

Technologies Used

1. MediaProjection - Used to obtain full screenshots
2. AccessibilityService - Used to dispatch gestures like tapping and scrolling
3. OpenCV Android 4.5.1 - Used to template match
4. Tesseract4Android 2.1.1 - For performing OCR on the screen
5. Google's Firebase Machine Learning OCR for Text Detection
6. AppUpdater 2.7 - For automatically checking and notifying the user for new app updates
7. Javacord 3.3.2 - For Discord integration
8. Klaxon 5.5 - For parsing JSON files
9. React Native 0.64.3 - Used to display the UI and manage bot settings