Pokebot

Pokebot is a tool for BizHawk that automates certain actions to find the perfect legitimate pokemons for supported pokemon games.

Want to know how this tool has been developed and how it works ? Visit my website

---

Jump to:

• Dependencies
• Installation
• Supported Games
• Overview
  • Video
  • Features
  • Bots
• How to export save file
• Code Documentation
• Todo & Ideas
• Known bugs
• Sources
• License

Dependencies

• Download BizHawk emulator (Latest tested is version 2.10)
• Download this tool

Installation

Place the file Pokebot.dll inside BizHawk/ExternalTools/ folder. Then, open BizHawk and click on "Tools" -> "External Tool" -> "Pokebot". A window should open. Just load your pokemon officiel ROM in BizHawk and Pokebot will automatically update the window if the game is supported.

Supported Games

Pokemon Gold

Nom	Hash	Supported	Tested
USA (Europe)	d8b8a3600a465308c9953dfa04f0081c05bdcb94	✅	✅
Japan (1.0)	8814f1039450a5d3684b1389f588ccd7ee7c3436	✅	✅
Japan (1.1)	a222402235d484ee8e39f3f31bae57cf13daf585	✅	✅
French	c147c0d8c2b71b7628a7233436f5c052b5b17081	✅	❌
Deutch	9254195d461ea942eaaa08cc4b83de3cf82aea0d	✅	❌
Italian	032608fe8947b627584a4a0eccc7bf9ad3588426	✅	❌
Korean	c0ff3999e1093e1af59ef3eea3f1bfd7c1f18a65	✅	❌
Spanish	162ea54c6a3cff374642e6dd842f9bffac847e7b	✅	❌

Pokemon Silver

Nom	Hash	Supported	Tested
USA (Europe)	49B163F7E57702BC939D642A18F591DE55D92DAE	✅	✅
Japan (1.0)	fa8c51059c1642faa570db56ef089f54d1d2011f	✅	✅
Japan (1.1)	a11d5ddc26eb826086593f82370b15d16404d33e	✅	✅
French	a4a7e8079b7a53e4d9ef43382bbb1090b9d45d1a	✅	❌
Deutch	8ecc58d621faaedf2a934bd2583d527220df7bb9	✅	❌
Italian	c9eca9d0a837beb9137bb7d779e469c54e9f8d77	✅	❌
Korean	cb22d7e03a74dc3a563fde6be8626626b2b392e7	✅	❌
Spanish	05bd978ab2cb104b0aff3f696896e30885203a18	✅	❌

Pokemon Crystal

Nom	Hash	Supported	Tested
USA (Europe)	f4cd194bdee0d04ca4eac29e09b8e4e9d818c133	✅	✅
USA (1.1)	f2f52230b536214ef7c9924f483392993e226cfb	✅	✅
A	a0fc810f1d4e124434f7be2c989ab5b5892ddf36	✅	✅
French	c055992b16b7399c687647725cdd1f4f13a2f75c	✅	❌
Deutch	accb584293ba056152f1fd908439b019017ff2fe	✅	❌
Italian	6cee05e5b95beeae74b8365ad18ec4a07a8c4af8	✅	❌
Japanese	95127b901bbce2407daf43cce9f45d4c27ef635d	✅	❌
Spanish	889a06fc0bb863666865aa69def0adf97945ac2a	✅	❌

Pokemon Emerald

Nom	Hash	Supported	Tested
USA (Europe)	f3ae088181bf583e55daf962a92bb46f4f1d07b7	✅	✅
French	ca666651374d89ca439007bed54d839eb7bd14d0	✅	✅
Deutch	61c2eb2b380b1a75f0c94b767a2d4c26cd7ce4e3	✅	❌
Italian	1692db322400c3141c5de2db38469913ceb1f4d4	✅	❌
Japanese	d7cf8f156ba9c455d164e1ea780a6bf1945465c2	✅	❌
Spanish	fe1558a3dcb0360ab558969e09b690888b846dd9	✅	❌

Pokemon Ruby

Nom	Hash	Supported	Tested
USA (Europe)	f28b6ffc97847e94a6c21a63cacf633ee5c8df1e	✅	✅
USA (Europe) rev 1	610b96a9c9a7d03d2bafb655e7560ccff1a6d894	✅	❌
USA (Europe) rev 2	5b64eacf892920518db4ec664e62a086dd5f5bc8	✅	❌
French	a6ee94202bec0641c55d242757e84dc89336d4cb	✅	✅
French rev 1	ba888dfba231a231cbd60fe228e894b54fb1ed79	✅	❌
Deutch	1c2a53332382e14dab8815e3a6dd81ad89534050	✅	✅
Deutch rev 1	424740be1fc67a5ddb954794443646e6aeee2c1b	✅	✅
Italian	2b3134224392f58da00f802faa1bf4b5cf6270be	✅	❌
Italian rev 1	015a5d380afe316a2a6fcc561798ebff9dfb3009	✅	❌
Japanese	5c5e546720300b99ae45d2aa35c646c8b8ff5c56	✅	❌
Japanese rev 1	971e0d670a95e5b32240b2deed20405b8daddf47	✅	❌
Spanish	1f49f7289253dcbfecbc4c5ba3e67aa0652ec83c	✅	❌
Spanish rev 1	9ac73481d7f5d150a018309bba91d185ce99fb7c	✅	❌

Pokemon Sapphire

Nom	Hash	Supported	Tested
USA (Europe)	3ccbbd45f8553c36463f13b938e833f652b793e4	✅	✅
USA (Europe) rev 1	4722efb8cd45772ca32555b98fd3b9719f8e60a9	✅	❌
USA (Europe) rev 2	89b45fb172e6b55d51fc0e61989775187f6fe63c	✅	❌
French	c269b5692b2d0e5800ba1ddf117fda95ac648634	✅	✅
French rev 1	860e93f5ea44f4278132f6c1ee5650d07b852fd8	✅	❌
Deutch	5a087835009d552d4c5c1f96be3be3206e378153	✅	✅
Deutch rev 1	7e6e034f9cdca6d2c4a270fdb50a94def5883d17	✅	✅
Italian	f729dd571fb2c09e72c5c1d68fe0a21e72713d34	✅	❌
Italian rev 1	73edf67b9b82ff12795622dca412733755d2c0fe	✅	❌
Japanese	3233342c2f3087e6ffe6c1791cd5867db07df842	✅	❌
Japanese rev 1	01f509671445965236ac4c6b5a354fe2f1e69f13	✅	❌
Spanish	3a6489189e581c4b29914071b79207883b8c16d8	✅	❌
Spanish rev 1	0fe9ad1e602e2fafa090aee25e43d6980625173c	✅	❌

Pokemon Fire Red

Nom	Hash	Supported	Tested
USA (Europe)	41cb23d8dccc8ebd7c649cd8fbb58eeace6e2fdc	✅	✅
USA (Europe) rev 1	dd5945db9b930750cb39d00c84da8571feebf417	✅	❌
French	fc663907256f06a3a09e2d6b967bc9af4919f111	✅	✅
Deutch	18a3758ceeef2c77b315144be2c3910d6f1f69fe	✅	❌
Italian	66a9d415205321376b4318534c0dce5f69d28362	✅	❌
Japanese	04139887b6cd8f53269aca098295b006ddba6cfe	✅	❌
Japanese rev 1	7c7107b87c3ccf6e3dbceb9cf80ceeffb25a1857	✅	❌
Spanish	ab8f6bfe0ccdaf41188cd015c8c74c314d02296a	✅	❌

Pokemon Leaf Green

Nom	Hash	Supported	Tested
USA (Europe)	574fa542ffebb14be69902d1d36f1ec0a4afd71e	✅	✅
USA (Europe) rev 1	7862c67bdecbe21d1d69ce082ce34327e1c6ed5e	✅	❌
French	4b5758c14d0a07b70ef3ef0bd7fa5e7ce6978672	✅	✅
Deutch	0802d1fb185ee3ed48d9a22afb25e66424076dac	✅	❌
Italian	a1dfea1493d26d1f024be8ba1de3d193fcfc651e	✅	❌
Japanese	5946f1b59e8d71cc61249661464d864185c92a5f	✅	❌
Japanese rev 1	de9d5a844f9bfb63a4448cccd4a2d186ecf455c3	✅	❌
Spanish	f9ebee5d228cb695f18ef2ced41630a09fa9eb05	✅	❌

Overview

Video

Features

• Settings
  • Configure the emulator and game through Pokebot such as speed and sound.
• Logs
  • View all logs inside the application.
• Statistiques
  • View pokemon statistics, used to see how many pokemons have been encountered since the beginning with the shiny ratio.
• Bot
  • Configure and start any supported bot
• Viewer
  • View opponent pokemon & party stats such as hidden power, moves, IVs.
• Version Checker
  • A popup will appear when a new version is available.
• Discord Webhook
  • Get a notification in any discord server using webhooks.

Bots

• Starter
  • This bot will choose your selected starter and see if it matches your set filters. If not, it will change the seed and reload the game in a loop.
• Spin
  • This bot will spin your character on the map and when the battle start, it will check if the opponent pokemon matches your set filters. If not, it will escape the fight and try again.
• Static
  • This bot will start a battle against a static pokemon and check if it matches your set filters. If not, it will change the seed and reload the game in a loop.
• PokeFinder
  • This bot will press A at the specified frame. Sometimes the hit frame is different from the specified frame. In this case, you can use PokeFinder to find the hit frame and include it in the bot for adjustment. (To use this bot, your emulator must simulate dead battery)
• Fishing
  • This bot will use the registered tool (SELECT) and will try to start fishing and wait for battle and see if it matches your set filters. If not, it will leave and retry.

How to export save file

BizHawk saves game data in the GBA/SaveRam or Gameboy/SaveRam directory. To export this save as a .sav extension for most games, you can simply rename the file extension to .sav without having to make any changes. Sometimes, however, the file may be invalid, so you need to remove the very last line using a hexadecimal editor (HxD). You can follow this tutorial.

Code Documentation

The code documentation is available on Wiki. You will find explanations on how to add supported games, bots or even features.

Todo & Ideas (implementation not comfirmed)

• Add bot for eggs
• Add bot for exp farm
• Support translations
• Add feature to PokeFinder bot to save before the specified frame and not at start.
• Read seed
• Transform SaveRam to sav file automatically
• Gen 1 support

Done

• Add feature that works with PokeFinder ✔️
• Show trainer ID & Secret in the view (PokeFinder bot) ✔️
• Ability to execute bot every x seconds instead of every frame ✔️
• Discord Webhook ✔️
• Add bot for static pokemon️ ✔️
• Save & load settings to/from config file ✔️
• Add bot for fishing ✔️

Known bugs

Yeah! There's nothing here!

Sources

• BizHawk Documentation
• Pokemon Decompilation Source Code
• 40Cakes Source Code
• Pokemon Memory Reader
• Bulbapedia Pokemon Data Structure GEN 3
• Bulbapedia Pokemon Data Structure GEN 2
• PokéAPI
• PokeFinder
• Hexa to Decimal Converter
• GBA Backup Tool
• GBA Memory Domains
• ROM SHA

License

Pokebot can be used by anyone for any purpose allowed by the permissive MIT License.