Skip to content
This repository was archived by the owner on Nov 29, 2023. It is now read-only.

Getting started

40 Cakes edited this page May 25, 2023 · 20 revisions

🛠 THIS PAGE IS A WORK IN PROGRESS AND INCOMPLETE 🛠

This page will walk you through how to set up your own instance of a pokebot-bizhawk.

Please follow this guide carefully before asking for help in the #bot-support❓ channel. If you do need help, please provide a clear and concise description of your issues, along with any screenshots and error logs.

Step 1: Installing Requirements

First up, you will need to install a few things:

Python

Download and install the latest version of Python (important: during the install, tick Add Python to PATH)

Bizhawk (Emulator)

Download and install Bizhawk prereqs (this includes .NET and other frameworks for Bizhawk to run)

Download and extract Bizhawk (emulator) 2.9 (extract this somewhere you will remember, your GBA save data will saved here so make sure you back it up if you ever upgrade Bizhawk)

Load up and start a supported game (bring you own ROM, please do not ask anyone in Discord for them)

Recommended Bizhawk settings

Config > Hotkeys > Tools > Change the keybind for "Lua Console" (I just use the L key for Lua)

Config > Customize... > Untick Pause when menu activated, also tick Run in background

Tools > Lua Console > File > Recent Scripts > Tick Autoload Script (this saves a lot of clicking if you're constantly restarting the Lua script in Bizhawk)

If you want to gamepad inputs displayed on-screen you can go to View > tick Display Input

Step 2: Download The Bot

Download the latest copy of the bot here (optionally git clone this repo if you know how to use git)

Make a new folder called pokebot-bizhawk

Extract main.zip into pokebot-bizhawk

In the pokebot-bizhawk folder you just extracted and install the required Python modules using one of the following options:

⚠ Warning: take caution and inspect .bat files you've downloaded from the Internet before running!

  • Option 1: Run requirements.bat to automatically install the required Python modules
  • Option 2: Open a terminal in the pokebot-bizhawk folder and run python.exe -m pip install -r .\requirements.txt
Clone this wiki locally