pinkulu / pokebot-bizhawk

PokeBot for BizHawk

An automated shiny hunting bot for Pokemon Emerald

These scripts are currently being used to complete and stream a Prof. Oak living ✨shiny✨ dex challenge in Pokemon emerald on YouTube and Twitch. Feel free to join the Discord to discuss the stream and get support for this bot.

Supported games

	Ruby	Sapphire	Emerald	FireRed	LeafGreen
English	❌	❌	✅	❌	❌
Spanish	❌	❌	✅	❌	❌
German	❌	❌	✅	❌	❌
French	❌	❌	❌	❌	❌
Italian	❌	❌	❌	❌	❌
Japanese	❌	❌	✅	❌	❌

Support for all other gen 3 games are coming soon (high priority)!

Getting started

For a guide on how to download and run this bot, check out Wiki: Getting started.

Requirements

• The latest version of Python
• Bizhawk 2.9 (and Bizhawk prereqs)

Video examples

These are also available in the Discord channel #running-examples.

• Starters soft resetting
• Acro bike bunny hopping
• Fishing
• Rayquaza
• Groudon
• Kyogre
• Southern Island (other roamer)

How it works

There are 2 components of this bot:

1. pokebot.lua is a Lua script that runs in Bizhawk's Lua console Bizhawk Scripting API. This Lua script reads a bunch of different locations GBA memory to extract information such as:

TODO

Notes

This project is just the result of a bored holiday, I am by no means a professional Python or LUA developer so I apologise for the very scuffed code you have just stumbled upon, this was a huge learning experience and it goes without saying that this code comes with no warranty.

• This bot is very much in ALPHA - you will almost definitely run into bugs! If you decide to run this, please provide feedback and report bugs in Discord #⁠bot-support❓ channel
• It is possible to run the bot with unthrottled speedup, most shiny hunting methods will work at unthrottled speeds but you'll be more prone to getting stuck
• Only tested and confirmed working on Windows
• Only 1 bot instance can run at a time (for now)

Todo

See the (Milestones page) for this repo.

Credits

I'd like to give a huge shout out to the following projects and authors, as well as the devs of Bizhawk, all were instrumental in getting this bot working.

• https://github.com/TASEmulators/BizHawk
• https://github.com/mkdasher/PokemonBizhawkLua/
• https://github.com/besteon/Ironmon-Tracker/
• https://github.com/Gikkman/bizhawk-communication
• https://github.com/mgba-emu/mgba/blob/master/res/scripts/pokemon.lua (This bot was originally written for mGBA)
• https://github.com/jaller94/matrix-plays-pokemon