Plugins and game wrappers¶
PyBoy selects a game wrapper from the cartridge title when one is available; otherwise it uses the generic wrapper. Access the selected wrapper through pyboy.game_wrapper.
The wrappers expose game-specific state and controls in addition to the common game-area API. The Super Mario Bros. Deluxe wrapper supports world and level selection, Challenge mode, custom level sequences, CGB-aware tile mappings, and active-object data for automation and analysis.
The game-area debug view is enabled with pyboy -d game_rom.gb. Press L in the SDL2 window to cycle between the screen, mapped game-area, and text views. Wrappers can provide game_area_annotations() so object positions and other metadata are shown in the debug view.