Please do not sell the bot, or use it to sell accounts/power leveling or what have you. If you really can't help yourself from trying to make money on it, please donate a portion of your profits to Kiva.
To the people that have done so already (heard from quite a few already), thank you for making the world a better place.
DISCLAIMER: this is super sketch and just a proof of concept It's not that bad any more, but still, use at your own risk and I claim no credit or responsibility or what have you for parts of it.
usage: python pokecli.py [-h] [-i CONFIG_INDEX] [-l LOCATION] [-d]
optional arguments:
-h, --help show this help message and exit
-i CONFIG_INDEX, --config_index CONFIG_INDEX
Index of account in config.json
-l LOCATION, --location LOCATION
Location
-d, --debug Debug Mode
- Run python web.py to get a webservice to show you player information, this can be seen at:
- http://127.0.0.1:5000/YOUR_USERNAME_HERE/pokemon
- Only 1 needs to run regardless of how many bots you are running
Copy config.json.example to config.json and change your account information.
Below the accounts you can change options in the default
section. If you need to change some options for an individual account, you can copy them to the account section and modify as needed.
BEHAVIOR
sectionUSE_GOOGLE
will enable google walking directions for navigation- You will probably need to provide an api key in
GMAPS_API_KEY
to avoid rate limits
- You will probably need to provide an api key in
STEP_SIZE
corresponds to how many meters you want to move at most between server calls, set this around 4-6 for walking or 100-200 for really, really fast drivingWANDER_STEPS
will set the distance a pokestop can be away before and still allow us to wander off the walk path. This allows you to get pokestops that aren't close to the sidewalk/road. If you don't set it we won't wander off the path.EXPERIMENTAL
will set the flag to use exeperimental featuresSKIP_VISITED_FORT_DURATION
[Experimental] Avoid a fort for a given number of seconds- Setting this to 500 means avoid a fort for 500 seconds before returning, (Should be higher than 300 to have any effect). This will let the bot explore a bigger area.
SPIN_ALL_FORTS
[Experimental] will try to route using google maps(must have key) to all visible forts, ifSKIP_VISITED_FORT_DURATION
is set high enough, you may roam around forever.
CAPTURE
MIN_FAILED_ATTEMPTS_BEFORE_USING_BERRY
minimum number of failed capture attempts before trying to use a Razz Berry (default: 3)CATCH_POKEMON
Allows you to disabling catching pokemon if you just want to mine for the forts for pokeballs
EGG_INCUBATION
ENABLE
enables automatic use of incubators (default: true)USE_DISPOSABLE_INCUBATORS
enables use of disposable (3-times use) incubators (default: false)BIG_EGGS_FIRST
incubate big eggs (most km) first (default: true)
POKEMON_CLEANUP
KEEP_POKEMON_NAMES
Names of pokemon you want the bot to hold regardless of IV/CPTHROW_POKEMON_NAMES
Names of pokemon you want the bot to throw away regardless of IV/CP- Note:
MIN_SIMILAR_POKEMON
will still be kept for all pokemon types
- Note:
KEEP_POKEMON_MAX_COUNT
default 9999. If you want to keep a certain type of pokemon but you accidently run into a nest? Don't worry this will make sure you only keep X amount of pokemon specified inKEEP_POKEMON_IDS
RELEASE_METHOD
= "CLASSIC"KEEP_CP_OVER
Never transfer any pokemon above this CP, Setting this to 0 will never transfer anythingKEEP_IV_OVER
is the minimum pokemon IV that you want to keep (high-iv pokemons)KEEP_IV_ONLY_WITH_PERCENT_CP
Do not keep high-iv pokemons if their CP is lower than X% of the best pokemonMAX_POKEMON_HIGH_IV
Do not keep more than X amount of high-iv pokemons (those with highest CP are preferred by default)
RELEASE_METHOD
= "DUPLICATES"- The bot will collect all pokemon it encounters , thus collecting a ton of bad ones and filling up space. Enabling this feature (disabled by default) will have the bot automatically transfer pokemon that are duplicates. To determine which pokemon to transfer when duplicates exist, the pokemons are compared according to the
SCORE_METHOD
setting. The bot will transfer the lowest scoring pokemon, maintainingMIN_SIMILAR_POKEMON
of each type. To be completely confident that the bot will not transfer your high lvl pokemon, when this feature is enabled only pokemon with a score belowRELEASE_DUPLICATES_MAX_SCORE
are released. If you have multiple pokemon that are close to the same lvl the bot can be configured to not transfer them by usingRELEASE_DUPLICATES_SCALAR
. The value of this config is multiplied by the highest scoring pokemon of a type and only those pokemon that are less than the scaled score are transfered. - EXAMPlES: If you set
SCORE_METHOD
to "IV" while having two Snorlaxs, one with stats CP:14 IV:95 and the other with CP:1800 IV:30 the bot will transfer the Snorlax with CP of 1800 and keep the CP 14 Snorlax because you have indicated you only care about a pokemon's IV. It must be fully understood why this happens to avoid unwanted transfer of pokemon. If not used correctly this feature can very easily transfer a large ammount of your pokemon so please make sure you fully understand it's mechanics before attempting use!
- The bot will collect all pokemon it encounters , thus collecting a ton of bad ones and filling up space. Enabling this feature (disabled by default) will have the bot automatically transfer pokemon that are duplicates. To determine which pokemon to transfer when duplicates exist, the pokemons are compared according to the
SCORE_METHOD
- A pokemon's score is an arbitrary and configurable parameter defines how to sort pokemon by best > worst to decide which one to keep first. Possible values are "CP", "IV", "CPxIV", or "CP+IV" or the special "FANCY" method.
- The "FANCY" method uses the options a
WEIGHT_IV
andWEIGHT_LVL
which give the ability to specifically set more weight on Lvl or IV. The formula is as follows:(iv / 100.0 * SCORE_WEIGHT_IV) + level / (player_level+1.5) * SCORE_WEIGHT_LVL
where player_level+1.5 is the max level that pokemon can reach when fully powered up.
NEEDY_ITEM_FARMING
[Experimental] will cease trying to catch pokemon and roam around to collect more pokeballs when inventory is lowENABLE
:Boolean
, whether or not this feature is enabledPOKEBALL_FARM_THRESHOLD
:Integer
, when the observed pokeball count drops on or below this number, skip catching pokemon and begin collecting.POKEBALL_CONTINUE_THRESHOLD
:Integer
, when the observed pokeball count reaches this amount, stop farming and go back to catching pokemon.FARM_IGNORE_POKEBALL_COUNT
:Boolean
, Whether to include this ball in counting. Same goes forGREATBALL
,ULTRABALL
, andMASTERBALL
. Masterball is ignored by default.FARM_OVERRIDE_STEP_SIZE
:Integer
, When it goes into farming mode, the bot assumes this step size to potentially speed up resource gathering. This might lead to softbans. Setting to-1
disables this feature. Disabled by default for safety.- If
EXPERIMENTAL
ORCATCH_POKEMON
are false, this configuration will disable itself.
There are more options, check the current config.json.example, many are self-explanatory.
- Run
pip install -r requirements.txt
- Python 2
- requests
- protobuf
- gpsoauth
- geopy (only for pokecli demo)
- s2sphere (only for pokecli demo)
Build and run container:
docker build -t pokecli .
docker run pokecli
Optionally create an alias:
alias pokecli='docker run pokecli'
For Chosing what Items to keep, get the names here, AeonLucidProtos_ItemID For Choosing what pokemon to keep get the names here,AeonLucidProtos_Pokemon
Put them in config. Type exactly as the name appears
What's working:
- A lot of things. Check out the example config to see some of the features. Catching Lured pokemon, regular pokemon, multiple kinds of navigation (google maps, walking, driving, customized speed), a web ui, auto transfers, auto evolves, auto power ups, auto egg incubation, inventory managament, multiple account botting. And much more, README to be updated soon
To ask question related to api and general help, join Pokemon Go Reverse Engineering Slack team.
- tejado for the base of this
- elliottcarlson for the Google Auth PR
- AeonLucid for improved protos
- AHAAAAAAA for parts of the s2sphere stuff
- beeedy for ability to transfer duplicate pokemon
- And to anyone on the pokemongodev slack channel <3
super sketch but yolo