https://github.com/fate-grand-automata/fga

Auto-battle app for F/GO Android
https://github.com/fate-grand-automata/fga

accessibility android fate fgo kotlin mediaprojection opencv

Last synced: 1 day ago
JSON representation

Auto-battle app for F/GO Android

• Host: GitHub
• URL: https://github.com/fate-grand-automata/fga
• Owner: Fate-Grand-Automata
• License: mit
• Created: 2020-03-06T10:28:35.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2025-01-30T05:53:47.000Z (2 days ago)
• Last Synced: 2025-01-30T20:13:34.352Z (1 day ago)
• Topics: accessibility, android, fate, fgo, kotlin, mediaprojection, opencv
• Language: Kotlin
• Homepage: https://fate-grand-automata.github.io
• Size: 47.5 MB
• Stars: 1,586
• Watchers: 45
• Forks: 280
• Open Issues: 151
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • Funding: FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Fate/Grand Automata

[![CI](https://github.com/Fate-Grand-Automata/FGA/workflows/CI/badge.svg?branch=master&event=push)](https://github.com/Fate-Grand-Automata/FGA/actions)

[![Discord Banner 2](https://discordapp.com/api/guilds/1117873862500163684/widget.png?style=banner2)](https://discord.gg/H99eUMYuH7)

Auto-battle app for FGO (Android 7 or later, no need for root on phones).

Download from our [website](https://fate-grand-automata.github.io)

This is a **Kotlin** port of [FGO-Lua][FGOLua] as an Android app with UI for configuration and without a time-limit on use.  

It doesn't tamper with the game in anyway and works by looking at the screen and tapping things just like a normal user would do.  

It's not made to do the story for you, but to automate the mundane farming.

Having Trouble? See the [Troubleshooting Guide](https://github.com/Fate-Grand-Automata/FGA/wiki/Troubleshooting) first.

## Video Guide by @reconman

[![Watch the video guide](https://img.youtube.com/vi/JOwupZ4W8AQ/sddefault.jpg)](https://youtu.be/JOwupZ4W8AQ)

## How to Use?

1. Install from the link given above and launch the app.

2. Click on `Start Service` and give all the permissions it asks for.

3. Open FGO. Now, you can see a button with play icon on it floating on screen.

4. Go to the node you want to farm.

5. Press Play to start. The same button can be pressed to pause/stop later.

Check the [Troubleshooting Guide](https://github.com/Fate-Grand-Automata/FGA/wiki/Troubleshooting) first if you face any problems.

## How to make/use images of Servant/CE/Friend?

See the wiki page for [Support Image Maker](https://github.com/Fate-Grand-Automata/FGA/wiki/Support-Image-Maker).

## What about other scripts like Lottery and Friend Gacha?

When you click on the PLAY button, the app detects which script can be run on the current screen and presents it to you.

## How does it work?

This is a native Android app written in Kotlin.

We use [OpenCV](https://opencv.org/) for image recognition,

[Media Projection](https://developer.android.com/reference/android/media/projection/MediaProjection) for taking screenshots

and [Accessibility Service](https://developer.android.com/guide/topics/ui/accessibility) for clicking/swiping.

## Contributing

If you want to contribute, read the [Contribution Guide](CONTRIBUTING.md).

## Acknowledgements

- [FGO-Lua][FGOLua] developers are the real deal. Without them this app won't exist.

- The icons are from https://materialdesignicons.com/

- Drag-sort logic on Card Priority screen is thanks to https://medium.com/@ipaulpro/drag-and-swipe-with-recyclerview-6a6f0c422efd

[FGOLua]: https://github.com/29988122/Fate-Grand-Order_Lua

## Like the project? Want to support us?



Code/doc contributions are surely welcome!

Translations should be edited via https://poeditor.com/join/project/67PXOyBGI0