PokemonGo-Bot

PokemonGo-Bot is a project created by the PokemonGoF team.

Table of Contents

• Installation
• Documentation
• Support
• Help
• Bugs
• Feature Requests
• Pull Requests
• Features
• Credits

The project is currently setup in two main branches:

• dev also known as beta - This is where the latest features are, but you may also experience some issues with stability/crashes.
• master also known as stable - The bot 'should' be stable on this branch, and is generally well tested.

Support

Development Channel

Configuration issues/help

If you need any help please don't create an issue as we have a great community on Slack. You can count on the community in #help channel.

• Click here to signup (first time only)
• Join here if you're already a member

###Bugs / Issues If you discover a bug in the bot, please search our issue tracker first. If it hasn't been reported, please create a new issue and ensure you follow the template guide so that our team can assist you as quickly as possible.

###Feature Requests If you have a great idea to improve the bot, please search our feature tracker first to ensure someone else hasn't already come up with the same great idea. If it hasn't been requested, please create a new request and ensure you follow the template guide so that it doesnt get lost with the bug reports. While you're there vote on other feature requests to let the devs know what is most important to you.

###Pull Requests If you'd like to make your own changes, make sure you follow the pull request template, and ensure your PR is made against the 'dev' branch.

If this is your first time making a PR or aren't sure of the standard practice of making a PR, here are some articles to get you started.

• GitHub Pull Request Tutorial
• How to write the perfect pull request
• A great example from one of our own contributors

Features

• GPS Location configuration
• Search Pokestops
• Catch Pokemon
• Determine which pokeball to use (uses Razz Berry if the catch percentage is low!)
• Exchange Pokemon as per configuration
• Evolve Pokemon as per configuration
• Auto switch mode (Inventory Checks - switches between catch/farming items)
• Limit the step to farm specific area for pokestops
• Rudimentary IV Functionality filter
• Ignore certain pokemon filter
• Adjust delay between Pokemon capture & Transfer as per configuration
• Hatch eggs
• Incubate eggs
• Crowd Sourced Map Prototype
• [Standalone Desktop Application] (https://github.com/PokemonGoF/PokemonGo-Bot-Desktop)
• Use candy

Gym Battles

PokemonGo-Bot takes a strong stance against automating gym battles. Botting gyms will have a negative effect on most players and thus the game as a whole. We will thus never accept contributions or changes containing code specific for gym battles.

Analytics

PokemonGo-Bot is very popular and has a vibrant community. Because of that, it has become very difficult for us to know how the bot is used and what errors people hit. By capturing small amounts of data, we can prioritize our work better such as fixing errors that happen to a large percentage of our user base, not just a vocal minority.

Our goal is to help inform our decisions by capturing data that helps us get aggregate usage and error reports, not personal information. To view the code that handles analytics in our master branch, you can use this search link.

If there are any concerns with this policy or you believe we are tracking something we shouldn't, please open a ticket in the tracker. The contributors always intend to do the right thing for our users, and we want to make sure we are held to that path.

If you do not want any data to be gathered, you can turn off this feature by setting health_record to false in your config.json.

Credits

• tejado many thanks for the API
• U6 Group for the U6
• Mila432 for the login secrets
• elliottcarlson for the Google Auth PR
• AeonLucid for improved protos
• AHAAAAAAA for parts of the s2sphere stuff
• Breeze ro for some of the MQTT/Map stuff

Contributors

• eggins [first pull request]
• crack00r
• ethervoid
• Bashin
• tstumm
• TheGoldenXY
• Reaver01
• rarshonsky
• earthchie
• haykuro
• 05-032
• sinistance
• CapCap
• mzupan
• gnekic(GeXx)
• Shoh
• luizperes
• brantje
• VirtualSatai
• dmateusp
• jtdroste
• msoedov
• Grace
• Calcyfer
• asaf400
• guyz
• DavidK1m
• budi-khoirudin
• riberod07
• th3w4y
• Leaklessgfy
• steffwiz
• pulgalipe
• BartKoppelmans
• phil9l
• VictorChen
• AlvaroGzP
• fierysolid
• surfaace
• surceis
• SpaceWhale
• klingan
• reddivision
• DayBr3ak
• kbinani
• mhdasding
• MFizz
• NamPNQ
• z4ppy.bbc
• matheussampaio
• Abraxas000
• lucasfevi
• pokepal
• Moonlight-Angel
• mjmadsen
• nikofil
• bigkraig
• nikhil-pandey
• thebigjc
• JaapMoolenaar
• eevee-github
• g0vanish
• cmezh
• Nivong
• kestel
• simonsmh
• joaodragao
• extink
• Quantra
• pmquan
• net8q
• SyncX
• umbreon222
• DeXtroTip
• rawgni
• Breeze Ro
• bruno-kenji

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. The Google Maps Pin is a trademark of Google Inc. and the trade dress in the product design is a trademark of Google Inc. under license to The Pokémon Company. Other trademarks are the property of their respective owners. Privacy Policy

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

PokemonGoF does not support the use of 3rd party apps or apps that violate the TOS.