Go to file
bouletmarc 13fdfa8b5a First-commit 2015-05-30 04:57:15 -04:00
action First-commit 2015-05-30 04:57:15 -04:00
ai First-commit 2015-05-30 04:57:15 -04:00
data First-commit 2015-05-30 04:57:15 -04:00
storage First-commit 2015-05-30 04:57:15 -04:00
util First-commit 2015-05-30 04:57:15 -04:00
.gitattributes :octocat: Added .gitattributes & .gitignore files 2015-05-30 04:55:49 -04:00
.gitignore :octocat: Added .gitattributes & .gitignore files 2015-05-30 04:55:49 -04:00
Changelog.md First-commit 2015-05-30 04:57:15 -04:00
NidoranStats.md First-commit 2015-05-30 04:57:15 -04:00
PPStrats.md First-commit 2015-05-30 04:57:15 -04:00
PidgeyStrats.md First-commit 2015-05-30 04:57:15 -04:00
Readme.md First-commit 2015-05-30 04:57:15 -04:00
Readme_Modified_Files_List.md First-commit 2015-05-30 04:57:15 -04:00
Seeds.md First-commit 2015-05-30 04:57:15 -04:00
main.lua First-commit 2015-05-30 04:57:15 -04:00

Readme.md

PokéBot V2

An automated computer program that speedruns Pokémon Red, Blue, or Yellow.

Pokémon Red Any%: 1:51:11 (23 June 2014)

Watch live

twitch.tv/thepokebot

PokéBots official streaming channel on Twitch. Consider following there to find out when were streaming, or follow the Twitter feed for announcements when we get personal best pace runs going.

Run the bot locally

Running the PokéBot on your own machine is easy. You will need a Windows environment (it runs great in VMs on Mac/Linux too).

  1. First, clone this repository (or download and unzip it) to your computer.

  2. Download the BizHawk 1.6.1 emulator and extract the ZIP file anywhere you like to “install” it.

    Note: BizHawk v1.6.1 (Windows only) is the only version known to work. Later versions like v1.7.2a do not seem to work, due to differences with reading bytes from memory.

  3. Run the BizHawk prerequisites installer, which should update a C++ distributable needed by BizHawk.

  4. Procure a ROM file of Pokémon Red, Blue or Yellow english version (japan might not work and you should personally own the game).

  5. Open the ROM file with BizHawk (drag the .gb file onto EmuHawk), and Pokémon should start up. Otherwise select Open ROM in EmuHawk.

  6. The colors may look weird. To fix this, go to GBPalette Editor, and then find the POKEMON ***.pal file which should be under GameboyPalettes in the directory where BizHawk was extracted.

  7. If you want to test the full run, set RESET_FOR_TIME in main.lua to false instead of true.

  8. Then, under the Tools menu, select Lua Console. Click the “open folder” button, and navigate to the PokéBot folder you downloaded. Select main.lua and press “open”. The bot should start running!

Seeds

PokéBot comes with a built-in run recording feature that takes advantage of random number seeding to reproduce runs in their entirety. Any time the bot resets or beats the game, it will log a number to the Lua console that is the seed for the run. If you set CUSTOM_SEED in main.lua to that number, the bot will reproduce your run, allowing you to share your times with others. Note that making any other modifications will prevent this from working. So if you want to make changes to the bot and share your time, be sure to fork the repo and push your changes.

Credits

Developers

Kyle Coburn: Original concept, Red routing

Michael Jondahl: Combat algorithm, Java bridge for connecting the bot to Twitch chat, LiveSplit, Twitter, etc.

Marc-Andre Boulet(Bouletmarc): PokeBot V2, create No save corruption runs, added fews options, etc.

Special thanks

To LiveSplit for providing custom component for integrating in-game time splits.

To the Pokémon speedrunning community members who inspired the idea, and shared ways to improve the bot.