PyBoyPokered

This is a game-wrapper plugin for PyBoy specifically for Pokemon Red/Blue.

It currently requires a slightly modified PyBoy version which handles external python plugins and accepts callbacks on each cycle.

You can find it here: https://github.com/Pokeglitch/PyBoy

Usage

Simply import the script and, as long you are using the above modified PyBoy module, it will automatically add itself to the list of PyBoy plugins.

import PyBoyPokered

Create a new pyboy instance and ensure the game_wrapper flag is enabled: (Note, ROM file is not included)

import pyboy
p = pyboy.PyBoy("pokered.gb", game_wrapper=True)

Access the plugin:

pokered = p.plugin_manager.get_plugin("PyBoyPokered")

API

Breakpoints

A breakpoint can be added based on the name of the address (from the .sym file) using the Breakpoints submodule:

pokered.Breakpoints.add("OakSpeech", lambda: print("New Game Detected"))

It will execute the callbacks everytime the CPU reaches that address