https://github.com/binji/pokegb

A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.
https://github.com/binji/pokegb

emulator gameboy obfuscated pokemon

Last synced: about 1 hour ago
JSON representation

A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.

• Host: GitHub
• URL: https://github.com/binji/pokegb
• Owner: binji
• License: mit
• Created: 2021-05-28T16:04:43.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2024-02-12T19:01:55.000Z (10 months ago)
• Last Synced: 2024-12-15T08:02:29.118Z (7 days ago)
• Topics: emulator, gameboy, obfuscated, pokemon
• Language: C++
• Homepage:
• Size: 4.02 MB
• Stars: 1,342
• Watchers: 17
• Forks: 47
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pokegb

A gameboy emulator that only plays Pokemon Blue, in ~50 lines of c++.

See the [technical write-up](https://binji.github.io/posts/pokegb/).

## Features

Plays Pokemon Blue (and Red).

## Screenshots

![1](img/o1.gif)

![2](img/o2.gif)

![3](img/o3.gif)

![4](img/o4.gif)

![5](img/o5.gif)

![6](img/o6.gif)

![7](img/o7.gif)

![8](img/o8.gif)

![9](img/o9.gif)

![10](img/o10.gif)

![11](img/o11.gif)

![Source Code](img/pokegb.png)

## Building

Only builds on Linux and macOS AFAIK.

```

$ make

```

On macOS, you'll need to create a save file too (just the first time):

```

$ make rom.sav

```

## Running

Get a Pokemon Blue (or Pokemon Red) ROM file. The files that are known to work have the following sha1s:

| Name | sha1 |

| - | - |

| Pokemon - Blue Version (USA, Europe) (SGB Enhanced).gb | `d7037c83e1ae5b39bde3c30787637ba1d4c48ce2` |

| Pokemon - Red Version (USA, Europe) (SGB Enhanced).gb | `ea9bcae617fdf159b045185467ae58b2e4a48b9a` |

Others might work too, but these are the ones that I've tried.

Rename the file to `rom.gb` and put it in the current directory. Then run:

```

$ ./pokegb

```

The save file is written to `rom.sav`.

Keys:

| Action | Key |

| --- | --- |

| DPAD-UP | ↑ |

| DPAD-DOWN | ↓ |

| DPAD-LEFT | ← |

| DPAD-RIGHT | → |

| B | Z |

| A | X |

| START | Enter |

| SELECT | Tab |

## Updating keys

Look for [line 24](https://github.com/binji/pokegb/blob/5444936aa7f12cb8c5c9c78e3c0c391ca4102f9b/pokegb.cc#L24) the source.

The following table shows which numbers map to which keyboard keys:

| number | default key | gameboy button |

| - | - | - |

| 27 | X | A Button |

| 29 | Z | B Button |

| 43 | Tab | Select Button |

| 40 | Return | Start Button |

| 79 | Arrow Right | DPAD Right |

| 80 | Arrow Left | DPAD Left |

| 81 | Arrow Down | DPAD Down |

| 82 | Arrow Up | DPAD Up |

Replace the numbers on this line with one from the [SDL scancode list](https://www.libsdl.org/tmp/SDL/include/SDL_scancode.h).